MrDoc Docker部署完全手册：容器化知识库的构建与管理
项目地址: https://gitcode.com/gh_mirrors/mr/MrDoc MrDoc 是一款基于 Python 开发的在线文档系统，适合个人和中小型团队管理文档、Wiki、知识库及笔记。本手册将带你通过 Docker 快速部署 MrDoc，实现容器化知识库的高效构建与管理，让你轻松拥有属于自己的专业文档系统。
为什么选择 Docker 部署 MrDoc？
Docker 部署方式为 MrDoc 带来了诸多优势，让文档系统的搭建和维护变得前所未有的简单：
- 环境一致性：无论你使用何种操作系统，Docker 容器都能提供一致的运行环境，避免了因环境差异导致的各种问题。
- 快速部署：告别复杂的环境配置，一条命令即可完成 MrDoc 的部署，让你将更多精力放在文档内容的创作上。
- 隔离性好：容器化运行使 MrDoc 与系统其他应用相互隔离，提高了系统的安全性和稳定性。
- 易于维护：更新和升级 MrDoc 变得简单，只需拉取新的镜像即可，大大降低了维护成本。
图：MrDoc 文档编辑界面，直观展示了其便捷的文档创建和编辑功能
准备工作：Docker 环境搭建
在开始部署 MrDoc 之前，你需要确保服务器上已经安装了 Docker 和 Docker Compose。如果尚未安装，可以按照以下步骤进行：
-
更新系统软件包：
sudo apt update && sudo apt upgrade -y -
安装 Docker：
sudo apt install -y docker.io -
启动 Docker 服务并设置开机自启：
sudo systemctl start docker && sudo systemctl enable docker -
安装 Docker Compose：
sudo apt install -y docker-compose
快速部署步骤：从克隆到启动
1. 克隆项目代码
首先，将 MrDoc 项目代码克隆到本地：
git clone https://gitcode.com/gh_mirrors/mr/MrDoc
cd MrDoc
2. 配置 Docker Compose
MrDoc 项目中已经提供了 Docker Compose 配置文件 docker-compose.yml，你可以直接使用，也可以根据自己的需求进行修改。配置文件内容如下：
version: '3'
services:
mrdoc:
image: zmister/mrdoc:v9.3 # 镜像名称和标签
volumes:
- ${PWD}:/app/MrDoc # 挂载代码目录
ports:
- "10086:10086"
restart: always
dns:
- 8.8.8.8
- 114.114.114.114
3. 启动 MrDoc 服务
使用以下命令启动 MrDoc 服务：
docker-compose up -d
这个命令会后台启动 MrDoc 容器。Docker 会自动拉取所需的镜像（如果本地没有的话），然后创建并启动容器。
4. 验证部署是否成功
容器启动后，你可以通过访问服务器的 10086 端口来验证 MrDoc 是否部署成功。在浏览器中输入：
http://服务器IP:10086
如果一切正常，你将看到 MrDoc 的登录界面。
图：知识管理工作场景，象征着 MrDoc 助力团队高效协作和知识管理
深入了解：Docker 部署的核心配置
Dockerfile 解析
MrDoc 的 Dockerfile 定义了镜像的构建过程，主要分为两个阶段：
- 构建阶段（builder）：基于 Python 3.11-alpine3.19 镜像，安装编译依赖和 Python 依赖。
- 最终阶段：同样基于 Python 3.11-alpine3.19 镜像，复制构建阶段安装的依赖和应用代码，设置环境变量和启动命令。
关键步骤包括：
- 设置 Python 环境变量，如
PYTHONUNBUFFERED=0确保输出实时显示。 - 替换 Alpine 软件仓库源为国内镜像，加速依赖安装。
- 安装运行时依赖，如 Chromium、LibreOffice 等，支持文档转换等功能。
- 设置时区为 Asia/Shanghai，确保时间显示正确。
启动脚本详解
项目中的 docker_mrdoc.sh 脚本定义了容器启动时执行的命令：
#!/bin/sh
# 根据数据库迁移文件执行数据库变更
python /app/MrDoc/manage.py migrate &&
# 重建全文搜索索引
nohup echo y |python /app/MrDoc/manage.py rebuild_index &
# 启动uwsgi
uwsgi --ini /app/MrDoc/config/uwsgi.ini
# 直接 runserver 方式运行
# python -u /app/MrDoc/manage.py runserver --noreload 0.0.0.0:${LISTEN_PORT}
exec "$@"
这个脚本主要完成以下工作：
- 执行数据库迁移，确保数据库结构与代码版本一致。
- 重建全文搜索索引，保证搜索功能正常工作。
- 使用 uwsgi 启动应用，提供高性能的 Web 服务。
日常管理：容器运维与更新
查看容器状态
使用以下命令查看 MrDoc 容器的运行状态：
docker-compose ps
查看容器日志
如果需要排查问题，可以查看容器日志：
docker-compose logs -f mrdoc
更新 MrDoc
当有新版本发布时，你可以通过以下步骤更新 MrDoc：
-
拉取最新的代码：
git pull -
重新构建并启动容器：
docker-compose down docker-compose up -d --build
常见问题解决
端口冲突
如果启动时提示端口 10086 已被占用，可以修改 docker-compose.yml 文件中的端口映射，将 10086:10086 改为 新端口:10086。
数据持久化
MrDoc 的数据默认存储在容器内部，为了确保数据安全，建议将数据目录挂载到宿主机。你可以在 docker-compose.yml 的 volumes 部分添加更多的挂载项。
访问速度慢
如果访问 MrDoc 速度较慢，可以检查服务器的网络状况，或者尝试更换 Docker 镜像源。
图：觅道文档Logo，彰显 MrDoc 致力于分享知识、传递价值的理念
总结
通过 Docker 部署 MrDoc，你可以快速拥有一个功能强大、易于维护的在线知识库系统。无论是个人笔记管理还是团队协作，MrDoc 都能满足你的需求。希望本手册能帮助你顺利部署和使用 MrDoc，让知识管理变得更加高效和便捷！
现在，就开始你的 MrDoc 之旅吧！只需按照上述步骤操作，几分钟内就能搭建起属于自己的专业文档系统。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
