【实用的开源项目】使用服务器部署MrDoc，一个支持跨平台、跨终端的在线文档、知识库管理程序

之前小俊也用过不少知识库管理系统，不过也是很久之前啦，最近发现了一个支持跨平台、跨终端的在线文档、知识库管理程序叫作 ，简单使用之后，感觉还不错，推荐给大家，也作为 中的一期教程教大家如何部署这款程序。

官方网站： 官方Gitee： 官方Demo：

自托管、私有部署的在线文档管理系统和知识库

这是一篇全新安装教程，若你的服务器已有环境或者已有数据请谨慎重装系统！！！可直接跳至 继续阅读。 这是一篇全新安装教程，若你的服务器已有环境或者已有数据请谨慎重装系统！！！可直接跳至 继续阅读。 这是一篇全新安装教程，若你的服务器已有环境或者已有数据请谨慎重装系统！！！可直接跳至 继续阅读。

本文软件基于腾讯云轻量应用服务器安装，无建议配置，教程使用的腾讯云轻量应用服务器系统为 ！理论上腾讯云轻量应用服务器为 的服务器操作应与本文基本一致（包括过程与报错），其他系统为 或者 的服务器应与本文大同小异！ 腾讯云轻量应用服务器购买地址： 腾讯云618夏日盛惠： 腾讯云云产品特惠专区：

该步骤特别为使用腾讯云轻量应用服务器的用户准备，若你不是用腾讯云轻量应用服务器部署该程序，可以直接转到 继续阅读。

6.1.1 重装系统

此操作前请确保服务器上无重要程序、文件！！！请确保服务器上的数据已经备份好！！！ 此操作前请确保服务器上无重要程序、文件！！！请确保服务器上的数据已经备份好！！！ 此操作前请确保服务器上无重要程序、文件！！！请确保服务器上的数据已经备份好！！！

进入腾讯云轻量应用服务器的控制台，进入 界面，然后选择 ，列表中选择 ， 然后点击勾选 ，而后点击确定即可完成系统重装。

腾讯云轻量应用服务器与 相比，轻量应用服务器更聚焦于云计算入门者、学生等用户群体，更加简单易用，将基础云资源与热门开源软件的融合打包实现应用的开箱即用，更适合于支撑小型应用，这边我们之间选择 容器镜像，就可以跳过安装 、 的步骤（如果你使用的是境内服务器，腾讯云的 容器镜像已经配置好了国内镜像源，可以加速访问 镜像资源）。由于腾讯云的 容器镜像中的 已经安装了 。所以下文中若你见到 命令，请你使用使用 命令！

6.1.2 登录服务器

（原名 ）是腾讯遨驰云原生操作系统中 、 、裸金属等产品的统一网页终端，帮助用户随时随地通过浏览器远程登录服务器管理业务，相比本地远程终端更轻量便捷，无需掌握 和 也可轻松操作。 进入腾讯云轻量应用服务器的控制台，点击右上方的 ，使用腾讯云正在公测的 登录到服务器。

然后点击登录，即可登录到服务器中

输入下面这句命令登录到 账号

6.1.3 安装 Nginx Proxy Manager（必需反向代理本教程选用NPM）

安装 的详细教程小俊之前也写过哦，也配有详细的视频版本，需要学习的朋友可以点击这篇文章学习👉👉👉 ，当然想要使用反向代理的小伙伴要是熟悉 ，也可以自己手搓 进行反向代理哦！你想用宝塔面板的话，也是没有问题哒！

该步骤为各种服务器的环境准备通法，若你使用腾讯云轻量应用服务器部署该程序并已经仔细阅读 并按步骤完成操作，可以跳过该步骤，直接转到 继续阅读。

6.2.1 更新 Packages 并安装必要软件包

执行以下命令，更新 Packages 并安装必要软件包

6.2.2 安装并启动 Docker

6.2.2.1 境外服务器安装 Docker

执行以下命令，境外服务器安装 Docker

6.2.2.2 境内服务器安装 Docker

执行以下命令，境内服务器使用阿里云镜像源安装 Docker

执行以下命令，境内服务器使用国内 daocloud 一键安装命令安装 Docker

6.2.2.3 启动 Docker

输入并执行以下命令，启动

再执行以下命令，查看 的运行状态

最后执行以下命令，设置 开机自启动

由于我们通过以上一键脚本安装的 为最新版本，新版本的 自带 这个子命令，所以我们无需额外安装 。下文中若你见到 命令，请你使用使用 命令！ 使用方面仅有一个 （dash）字符只差，新版使用 命令，而如果你是旧版本就使用 命令。

6.2.3 安装 Nginx Proxy Manager（必需反向代理本教程选用NPM）

安装 的详细教程小俊之前也写过哦，也配有详细的视频版本，需要学习的朋友可以点击这篇文章学习👉👉👉 ，当然想要使用反向代理的小伙伴要是熟悉 ，也可以自己安装 进行反向代理哦！你想用宝塔面板的话，也是没有问题哒！

本次部署使用 Docker镜像 By jonnyan404 ，非官方镜像，镜像未经过验证，请自行辨别其安全！！！ 本次部署使用 Docker镜像 By jonnyan404 ，非官方镜像，镜像未经过验证，请自行辨别其安全！！！ 本次部署使用 Docker镜像 By jonnyan404 ，非官方镜像，镜像未经过验证，请自行辨别其安全！！！

6.3.1 新建目录

执行以下命令，新建目录

6.3.2 新建配置文件并编辑

执行以下命令，新建 文件并编辑

然后输入以下配置内容，跟着注释按需修改，然后 退出并保存即可。

如下图所示

6.3.3 新建docker-compose.yaml文件并编辑

执行以下命令，新建 文件并编辑

然后输入以下配置内容，然后 退出并保存即可。

如下图所示

注意：

6.3.3 启动容器

输入执行以下命令后台启动容器

如下图所示

启动完后再输入执行以下命令确认所有容器都是 或 状态

如下图所示

再输入以下命令，查看一下容器日志，没有出现什么错误基本上就行了

此时你会发现 还进不去，不用担心

主要是由于 初始化过慢,等待 初始化完毕，我们还需要输入以下命令，重启 容器

先把域名解析到服务器进入 ，点击 ，然后点击 ，按下图进行配置，下图中的 可能有所不一，请执行 自行查找 网卡的内网IP！

如下图所示

先不要着急着点 ，大家先去 提供商解析域名哦！然后我们可以为程序添加上 证书，给他加上一道小绿锁，不过如果你点了也没关系，没点 的朋友点击 ，然后点击 ，然后把 和 打开，修改一下 的邮箱，然后 即可；点击了 的朋友，点击右边的三点，点击 ，重复上述步骤即可！

如下图所示

至此，我们已经安装完成 这一个支持跨平台、跨终端的在线文档、知识库管理程序! 浏览器访问您刚刚设置的域名即可访问！ 注意：

建议直接执行以下命令，安装

然后，参考小俊之前写过的👉👉👉 ，安装 ，然后再进行 第6.2步及其后续操作

由于某些特定系统版本,导致自动创建用户密码无效,暂未找到具体原因(如有同学找到,请在此反馈.),所以解决办法如下: 方式一:创建新管理员 docker exec -it mrdoc-with-mysql python manage.py createsuperuser Shell session Copy 根据提示输入 账号/邮箱/密码 即可 方式二:修改管理员密码 docker exec -it mrdoc-with-mysql python manage.py changepassword admin Shell session Copy 按提示输入新密码即可，英文大小写混合+数字大于8位

以上解决方法来自 的