目 录CONTENT

文章目录

MrDoc强大的团队私有免费文档系统

phyger
2022-04-26 / 0 评论 / 3 点赞 / 2,305 阅读 / 1,785 字 / 正在检测是否收录...

关于 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查看镜像仓库信息。

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首页

配置 MrDoc

配置管理员

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

创建管理员账号

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

登录页面

后台管理

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

后台管理页面

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

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

创建文集

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

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

创建文集

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

文档编写

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

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

最后

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

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

3

评论区