宝塔面板部署 MrDoc 觅思文档实用教程

MrDoc（觅思文档）是一款支持私有化部署的在线文档与知识库系统，覆盖知识获取、文档沉淀、知识组织、AI 问答、内容创作与知识分享等环节，帮助个人和中小型团队建立完整的知识管理闭环。

MrDoc 支持 Web、浏览器扩展、桌面客户端、移动客户端及 Obsidian 同步插件，可用于个人知识库、团队知识库、产品文档等场景。

官网 | Gitee地址 | GitHub地址 | AtomGit地址 | 安装手册 | 使用手册 | 文档效果

所需环境

●操作系统： Ubuntu 24.04.5
●宝塔版本：13.1.0
●web 服务器 ：Nginx 1.26.3
●PHP版本：8.4.25
●MySQL版本：8.0.45
●Python项目管理器版本：2.5.1
●Python版本：3.9.7

MrDoc源码

https://pan.baidu.com/s/13B3jW6wyKwN0F87cIW4FGQ?pwd=1140
https://url57.ctfile.com/d/16898257-168627904-181467?p=1140
https://pan.xunlei.com/s/VP2MA17yvka7-8jWT0PZheSrA1?pwd=zm2i
https://1811664795.share.123pan.cn/123pan/q7CRVv-w8P1d

部署教程

请先自行在机器上安装好 Ubuntu 系统、宝塔面板、Nginx、PHP和MySQL等环境。

新建 MrDoc 项目目录 /www/wwwroot/docs.11zhang.com ，上传 MrDoc 源码并解压到该目录，如下图。

在宝塔面板的「软件商店」里面搜索并安装 Python 项目管理器，如下图。

如果还没有安装 Python 版本，我们可以选择一个版本进行安装，推荐3.9.7版本，如下图。

点击「项目管理」上的「添加项目」，会出现一个表单弹出框，配置以下 MrDoc 项目信息，点击【确定】按钮后等待依赖安装完成，如下图。

●项目名称：MrDoc
●Python 版本：选刚装的 3.9.7
●框架：python
●启动方式：uwsgi
●项目路径：/www/wwwroot/docs.11zhang.com
●启动文件/文件夹：/www/wwwroot/MrDoc/MrDoc/wsgi.py
●端口：10086（可以自定义，别冲突就行）
●运行项目的用户：root
●勾选「安装模块依赖」+「开机启动」+「守护进程」

创建 MySQL 数据库，宝塔面板左侧「数据库」→「添加数据库」，填写以下信息，如下图。

●数据库名：MrDoc
●用户名：MrDoc
●密码：点「随机生成」并复制保存
●访问权限：本地服务器

在 Python 项目管理器中添加 mysqlclient 插件，如下图

打开 /www/wwwroot/mrdoc/docs.11zhang.com/config/config.ini 配置文件，找到 [database] 段，修改为：

[database]
engine = mysql
name = mrdoc
user = mrdoc
password = 你的数据库密码
host = 127.0.0.1
port = 3306

用户 SSH 进入 MrDoc 源码所在目录，如 /www/wwwroot/docs.11zhang.com 依次执行如下命令：

./xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_venv/bin/python3 manage.py makemigrations
./xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_venv/bin/python3 manage.py migrate
./xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_venv/bin/python3 manage.py createsuperuser

# 注意替换为自己的路径，如：

./df6f78eb5c77bd8b2594a44656688b9e_venv/bin/python3 manage.py makemigrations
./df6f78eb5c77bd8b2594a44656688b9e_venv/bin/python3 manage.py migrate
./df6f78eb5c77bd8b2594a44656688b9e_venv/bin/python3 manage.py createsuperuser

PS：上一步最后一条 createsuperuser 命令按照提示输入用户名、电子邮箱、密码（密码不会显示，输入两次回车即可） 创建管理员账号。

返回 Python 项目管理器，重启项目，如下图。

宝塔「系统」-「系统防火墙」放行 MrDoc 端口，如下图。

此时访问 http://服务器IP:10086 就能看到 MrDoc 首页了，如下图。

域名访问

十一张（www.11zhang.com）站长分享2个方法，推荐方法一，如下图。

重启服务器，此时访问域名（https://docs.11zhang.com）也能看到 MrDoc 网站。

常见问题

1、MrDoc 在 HTTPS 下登录账号，提示【CSRF验证失败. 请求被中断】错误

MrDoc 在 HTTPS 下运行时，需要知道客户端是用 https 还是 http 访问的。Nginx 反代默认不把 X-Forwarded-Proto 这个头传给后端的 uWSGI，导致 Django 以为请求是 http，CSRF token 校验就对不上，于是所有 POST/PUT（登录、发布、上传、改密码）全部 403。最简单的解决办法，就是修改 Nginx 反代配置，只需在 location ^~ / 里加上一行：

proxy_set_header X-Forwarded-Proto $scheme;

PS：这是 MrDoc 在 HTTPS 下正常工作必需的，告诉后端“客户端是用 https 访问的”。不加它，登录、发布、上传、改密码全都会 CSRF 403。

2、忘记管理员账号用户

如果系统里已经没有可用的管理员账号，用 createsuperuser 命令直接新建一个管理员（最快），如下图。

cd /www/wwwroot/docs.11zhang.com
./df6f78eb5c77bd8b2594a44656688b9e_venv/bin/python3 manage.py createsuperuser

3、venv 里的 cryptography 安装失败

直接按照以下步骤重新安装一遍即可。

# 进入 MrDoc 源码所在目录

cd /www/wwwroot/docs.11zhang.com

# 确认 venv 里的 pip 路径没错
./df6f78eb5c77bd8b2594a44656688b9e_venv/bin/pip3 --version

# 装 cryptography
./df6f78eb5c77bd8b2594a44656688b9e_venv/bin/pip3 install cryptography

# 确认装好，看到版本号就行
./df6f78eb5c77bd8b2594a44656688b9e_venv/bin/pip3 list | grep -i cryptography