[JavaScript] 纯文本查看 复制代码
第一步：环境准备
1. 服务器要求：
- 系统：CentOS 7+ 或 Ubuntu 18.04+
- 宝塔面板版本：7.0 或更高
- Python 版本：3.6+（推荐 3.8+）
- 内存：至少 2GB（建议 4GB 以上）
2. 安装必要软件：
在宝塔面板的「软件商店」中安装：
- Nginx（Web服务器）
- MySQL/MariaDB（数据库）
- Redis（可选，用于缓存加速）
- Python项目管理器（搜索安装）
---
第二步：部署MrDoc源码
1. 下载源码：
- 方法一（推荐）：通过Git克隆
bash
git clone https://gitee.com/zmister/MrDoc.git
- 方法二：手动下载
从 下载 ZIP 包，解压到宝塔面板的网站根目录（如 `/www/wwwroot/mrdoc`）。
2. 创建Python虚拟环境：
- 进入宝塔面板的「Python项目管理器」
- 选择项目路径：`/www/wwwroot/mrdoc`
- 选择 Python 3.8+ 版本
- 点击「创建虚拟环境」并激活
3. 安装依赖库：
- 自动安装：在项目管理器中勾选「自动安装依赖」（依赖文件为 `requirements.txt`）
- 手动安装：如果失败，通过宝塔终端执行：
bash
pip install -r /www/wwwroot/mrdoc/requirements.txt
---
第三步：配置数据库
1. 初始化数据库：
- 进入宝塔终端，进入项目目录：
bash
cd /www/wwwroot/mrdoc
- 执行数据库迁移命令：
bash
python manage.py makemigrations
python manage.py migrate
2. 创建管理员账号：
bash
python manage.py createsuperuser
按提示输入用户名、邮箱和密码（例如：用户名 `admin`，密码 `123456`）。
---
第四步：配置宝塔站点
1. 添加网站：
- 在宝塔面板的「网站」菜单点击「添加站点」
- 填写信息：
- 域名：填写你的域名（如 `mrdoc.example.com`）
- 根目录：选择 `/www/wwwroot/mrdoc`
- 选择「Python」框架，端口设为 `8000`（或其他未占用端口）
2. 配置反向代理（Nginx）：
- 编辑站点配置文件，添加以下规则：
nginx
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
- 保存后重启Nginx服务。
---
第五步：运行与调试
1. 启动项目：
- 在项目管理器中点击「运行」
- 或通过终端执行：
bash
python manage.py runserver 0.0.0.0:8000
2. 访问测试：
- 浏览器打开 `http://你的域名:8000`
- 使用管理员账号登录（如 `admin/123456`）
---
第六步：高级配置
1. 静态文件托管：
- 在Nginx配置中添加：
nginx
location /static/ {
alias /www/wwwroot/mrdoc/static/;
}
2. 启用HTTPS：
- 在宝塔面板的「网站」中申请Let's Encrypt免费SSL证书，绑定到站点。
3. 防火墙设置：
- 确保服务器防火墙开放 `80`（HTTP）、`443`（HTTPS）、`8000`（Python服务）端口。
---
第七步：常见问题处理
1. 依赖安装失败：
- 检查Python版本是否匹配，尝试手动安装缺失库（如 `pillow`、`mysqlclient`）。
2. 数据库连接错误：
- 修改 `settings.py` 文件中的数据库配置，确保与宝塔中MySQL的账号密码一致。
3. 端口冲突：
- 更换项目端口（如 `8000` → `8080`），并在Nginx配置中同步修改。
---
第八步：升级与备份
1. 升级MrDoc：
- 进入项目目录，拉取最新代码：
bash
git pull origin master
- 重新执行数据库迁移和依赖安装。
2. 数据备份：
- 定期备份：
- 项目目录：`/www/wwwroot/mrdoc`
- MySQL数据库：通过宝塔面板的「数据库」管理工具导出SQL文件。
---
完成以上步骤后，你的MrDoc知识库系统即可正常访问。如遇问题，可检查日志文件（位于项目目录的 `logs` 文件夹）。