关于 MrDoc
MrDoc 是基于 Python 开发的在线文档系统。
MrDoc 适合作为个人和中小型团队的私有云文档、云笔记和知识管理工具,致力于成为优秀的私有化在线文档部署方案。
你可以简单粗暴地将 MrDoc 视为「可私有部署的语雀」和「可在线编辑文档的 GitBook」。
MrDoc 支持 web 端、浏览器插件、桌面端、安卓、小程序等多种访问方式,今天我们就来介绍下 MrDoc 的私有化部署(web 模式)。
MrDoc 主页:https://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
查看镜像仓库信息。
启动 MrDoc
MrDoc 官方镜像地址(uwsgi):https://hub.docker.com/r/zmister/mrdoc
MrDoc 开源镜像地址(nginx):https://registry.hub.docker.com/r/jonnyan404/mrdoc-nginx
更多部署方式:https://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
配置管理员
我们在服务器中执行命令docker exec -it mrdoc python manage.py createsuperuser
创建管理员用户。
配置完后使用管理员账号进行登录。
后台管理
登录成功后,点击个人头像进入后台管理。
在后台管理中,我们可以对文档,模板,用户,系统等进行设置管理。
点击个人头像,选择返回首页,即可返回到 MrDoc 首页。
创建文集
文集就是文章的集合。如果你想要创建独立页面,那你选择创建文档即可。
我们点击新建,选择创建文集。
我们选择创建并添加文档,然后就可以开始编写文档了。
如上,我们能够发现 MrDoc 比较好的几个特点。
- MrDoc 非常友好地支持了 echarts 图表。而且图片也能自动从粘贴板插入。
- MrDoc 支持从 word、txt、markdown、缓存等形式导入文档
最后
MrDoc 作为开源的私有文档系统,可以说是非常好用了。和mm-wiki相比各有优缺,大家可以根据自己的需求自行选择。
点击这里了解更多实用开发工具。
评论区