开源在线文档系统MrDoc容器化部署

一、MrDoc文档介绍

MrDoc（觅道文档）是一个基于Python（基于Django）开发的在线文档系统，适合作为个人和小型团队的文档、笔记、知识管理工具！

开源仓库地址：

• Gitee: https://gitee.com/zmister/MrDoc 
• GitHub: https://github.com/zmister2016/MrDoc 
• 文档手册：http://mrdoc.zmister.com/project-7/ 

二、功能特性

2.1 站点管理

2.2 个人管理

• 文集管理：新建、删除、权限控制、转让、协作、导出、生成电子书格式文件
• 文档管理：新建、删除、回收站、历史版本
• 文档模板管理：新建、删除
• 图片管理：上传、分组、删除
• 附件管理：上传、删除
• Token管理：借助Token高效新建和获取文档；
• 个人信息管理：修改昵称、修改电子邮箱、切换文档编辑器；

2.3 文档书写

• 文本文档、表格文档两种文档类型，Markdown 、富文本两种编辑模式，Editor.md、Vditor、iceEditor三种编辑器加持，自由选择、自由切换；
• 图片、附件、科学公式、音视频、思维导图、流程图、Echart图表；
• 文档排序、文档上级设置、文档模板插入；
• 文档标签设置；

2.4 文档阅读

• 两栏式布局，三级目录层级显示，左侧文集大纲，右侧文档正文；
• 文档阅读字体缩放、字体类型切换、页面社交分享、移动端阅读优化；
• 文集EPUB、PDF文件下载，文档Markdown文件下载；
• 标签关系网络图；
• 文档全文搜索；
• 私密文档分享码分享

三、容器化部署

3.1 mrdoc-alpine版部署-简化

（1）简单部署

[root@10-27-0-224 ~]# docker run -d --name mrdoc -p 10086:10086 jonnyan404/mrdoc-alpine

（2）设置超级权限用户密码

[root@10-27-0-224 ~]# docker exec -it mrdoc  python manage.py createsuperuser
用户名: root
电子邮件地址: starcto@163.com
Password: 
Password (again): 
Superuser created successfully.

3.2 mrdoc-alpine版部署-多参数配置

（1）创建持久化目录

[root@10-27-0-224 ~]# mkdir -p /mrdoc/media

（2）修改配置文件

关于SQLite简介：https://www.runoob.com/sqlite/sqlite-tutorial.html

[root@10-27-0-224 ~]#  vim /mrdoc/config.ini
# 如果自己没有更换其它数据库的需求，请原样复制粘贴，不要乱改配置。
# mysql 版本注意：建议在 5.6-8.0 以内，8.0 版本开始以下语句不支持，请自行解决。
# mysql 需要手动创建一个数据库：create database mrdoc character set utf8mb4 collate utf8_bin;
#grant all privileges on mrdoc.* to 'jonnyan404'@'%' identified by 'www.mrdoc.fun' with grant option;
#flush privileges;
[site]
debug = False                 # True 表示开启站点调试模式，False 表示关闭站点调试模式
 
[database]
engine = sqlite               # engine，指定数据库类型，接受 sqlite、mysql、oracle、postgresql
# name = mrdoc                # name 表示数据库的名称
# user = jonnyan404           # user 表示数据库用户名
# password = www.mrdoc.fun    # password 表示数据库用户密码
# host = db_host              # host 表示数据库主机地址
# port=3306                   # port 表示数据库端口
[selenium]
# driver = Chrome             # 在 Windows 环境下测试或使用，请配置 driver = Chrome
# 如果系统无法正确安装或识别 chromedriver，请指定 chromedriver 在计算机上的绝对路径
driver_path = /usr/lib/chromium/chromedriver

（3）创建容器

参数解读

# 控制是否创建管理员用户(CREATE_USER)
-e CREATE_USER=0                    # 0 代表关闭自动创建;1 代表开启自动创建(默认)

# 自定义默认管理员用户(USER)和密码(MM)
-e USER=admin -e MM=password

容器创建

[root@10-27-0-224 ~]# docker run -d --name mrdoc --restart=always  \
-p 10086:10086  \
-e CREATE_USER=0 -e USER=star.gao -e MM=ucloud.cn \
-v /mrdoc:/app/MrDoc/config \
-v /mrdoc/media:/app/MrDoc/media \
jonnyan404/mrdoc-alpine

作者：UStarGao
链接：https://www.starcto.com/open-sourcing/198.html
来源：STARCTO
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

UCloud新用户专属注册连接

UCloud CDN超值特惠专场

UCloud全球云主机（UHost/VPS）大促页面

UCloud快杰云主机大促页面