MrDoc免费的团队文档系统

870 阅读3分钟

持续创作,加速成长!这是我参与「掘金日新计划 · 6 月更文挑战」的第7天,点击查看活动详情

关于MrDoc

MrDoc 是基于Python开发的在线文档系统。

MrDoc 适合作为个人和中小型团队的私有云文档、云笔记和知识管理工具,致力于成为优秀的私有化在线文档部署方案。

你可以简单粗暴地将 MrDoc 视为「可私有部署的语雀」和「可在线编辑文档的GitBook」。

MrDoc支持web端、浏览器插件、桌面端、安卓、小程序等多种访问方式,今天我们就来介绍下MrDoc的私有化部署(web模式)。

MrDoc主页:mrdoc.pro/

部署MrDoc

前置准备

首先我们得准备一台可上网的云服务器。

安装Docker

我们需要在准备好的云服务器中安装docker。我使用的是CentOS。

# 升级软件和内核,防止后续安装出现问题
yum -y update:升级所有包同时也升级软件和系统内核
yum -y upgrade:只升级所有包,不升级软件和系统内核
​
# 安装Docker依赖
yum install -y yum-utils device-mapper-persistent-data lvm2
​
# 添加docker yum源
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
​
# 查看可用的docker版本
yum list docker-ce --showduplicates | sort -r
​
# 选择一个版本安装
yum -y install docker-ce-20.10.9-3.el7

启动docker、设置开机启动docker

systemctl start docker
systemctl enable docker

查看docker状态

systemctl status docker

修改docker镜像源

我们首先打开daemon.json文件,vim /etc/docker/daemon.json,然后向其中输入以下内容:

{
    "registry-mirrors": [
        "http://hub-mirror.c.163.com",
        "https://docker.mirrors.ustc.edu.cn",
        "https://registry.docker-cn.com"
    ]
}

然后保存退出,使用命令systemctl restart docker重启docker服务。

使用命令docker info查看镜像仓库信息。

docker info

启动MrDoc

MrDoc官方镜像地址(uwsgi):hub.docker.com/r/zmister/m…

MrDoc开源镜像地址(nginx):registry.hub.docker.com/r/jonnyan40…

更多部署方式:www.mrdoc.fun/doc/18/

本次我们选择nginx方式部署。使用如下命令启动:

docker run -d --name mrdoc -p 10086:10086 jonnyan404/mrdoc-nginx

耐心等待一会...使用docker ps就可以看到已经启动的MrDoc容器了。

访问MrDoc

我们在浏览器访问服务器ip+10086即可打开MrDoc首页。

MrDoc首页

配置MrDoc

配置管理员

我们在服务器中执行命令docker exec -it mrdoc python manage.py createsuperuser创建管理员用户。

创建管理员账号

配置完后使用管理员账号进行登录。

登录页面

后台管理

登录成功后,点击个人头像进入后台管理。

后台管理页面

在后台管理中,我们可以对文档,模板,用户,系统等进行设置管理。

点击个人头像,选择返回首页,即可返回到MrDoc首页。

创建文集

文集就是文章的集合。如果你想要创建独立页面,那你选择创建文档即可。

我们点击新建,选择创建文集。

创建文集

我们选择创建并添加文档,然后就可以开始编写文档了。

文档编写

如上,我们能够发现MrDoc比较好的几个特点。

  1. MrDoc非常友好的支持了echarts图表。而且图片也能自动从粘贴板插入。
  2. MrDoc支持从word、txt、markdown、缓存等形式导入文档

最后

MrDoc作为开源的私有文档系统,可以说是非常好用了。和mm-wiki相比各有优缺,大家可以根据自己的需求自行选择。

点击这里了解更多实用开发工具