> d 如果对 Linux 操作和使用不熟悉，对英文不熟悉，不会用翻译软件对系统的提示信息、日志等进行查看、翻译和理解，请移步 [《Docker 部署》](https://doc.mrdoc.pro/doc/3958/)

> d 如果报错提示诸如「SQLite 数据库版本……」的问题，请移步[《升级sqlite3》](https://doc.mrdoc.pro/doc/206/)

> d 本文档适用于宝塔面板「Python项目管理器」1.9版本，如果安装的「Python项目管理器」为2.0 版本请移步[《宝塔面板 python管理器2.0安装Mrdoc》](https://blog.csdn.net/debj031634/article/details/124080640)

> d 推荐使用 Docker 部署，请移步 [《Docker 部署》](https://doc.mrdoc.pro/doc/3958/)

## 一、安装系统依赖库

MrDoc 的运行依赖于一些系统软件，为了确保后续部署不出现问题，请先确保系统已安装所需依赖软件：

详见：https://doc.mrdoc.pro/doc/3558/

## 二、下载项目源码

通过 git clone 的方式将 MrDoc 的源码下载到服务器上。

点击「文件」菜单，进入到 www/wwwroot/ 目录下

![](/media/202112/2021-12-04_230247_958990.png)

点击「终端」按钮，打开一个命令行终端，根据自己的版本输入下述命令：

### MrDoc 开源版

```
git clone https://gitee.com/zmister/MrDoc.git
```

### MrDoc 专业版

```
git clone https://{用户名}:{密码}@git.mrdoc.pro/MrDoc/MrDocPro.git
```

![](/media/202107/2021-07-23_101550.png)

拉取完成后，可以看到目录下已经获取到了 MrDoc 的项目代码：

![](/media/202107/2021-07-23_101633.png)

## 三、安装 Python项目管理器

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

![](/media/202107/2021-07-23_094917.png)

安装完成之后，点击它，会显示 Python 项目管理器的弹出
窗口：

![](/media/202107/2021-07-23_095545.png)

其中：

- 「项目管理」，是我们当前所有的 Python 项目的列表。
- 「版本管理」，用来管理 Python 的版本，我们可以在这里安装不同的 Python 版本。
- 「日志」，用来查看当前项目的运行日志。

如果还没有 Python 版本已安装，我们可以选择一个版本进行安装：

![](/media/202107/2021-07-23_101029.png)

## 四、添加项目

完成上述两步之后，我们就可以开始部署项目了。

点击「项目管理」上的「添加项目」，会出现一个表单弹出框，用来配置项目的信息：

> d Python版本必须选择 3.6 以上

![](/media/202107/2021-07-23_102315.png)

配置完成之后，点击确定，就会进行依赖模块的安装和部署。

## 五、创建管理员账号

点击「文件」菜单，进入 MrDoc 代码所在的位置，点击「终端」按钮，打开终端界面弹出窗：

![](/media/202112/2021-12-05_091933_645269.png)

在终端中执行如下命令激活当前项目的 Python虚拟环境中：

```
source ./{MrDoc项目名称}_venv/bin/activate
```

![](/media/202112/2021-12-05_092033_667715.png)

接着，执行数据库迁移命令：

```
python manage.py makemigrations
```

和

```
python manage.py migrate
```

最后输出创建管理员账号的命令：

```
python manage.py createsuperuser
```

按照提示输入用户名、电子邮箱、密码（密码不会显示，需要输入两次，输完回车即可）

上述完整步骤如下图所示：

![](/media/202112/2021-12-05_093145_040084.png)

完成上述操作后，回到「Python项目管理器」，对项目进行重启：

![](/media/202112/2021-12-05_093332_397945.png)

重启完成后，就可以通过`ip:端口号`的形式进行访问了。

> d 端口号须被安全组或防火墙放行

## 六、绑定域名

项目部署好之后，项目管理的列表里面会出现刚刚添加的项目。

![](/media/202107/2021-07-23_103253.png)

如果需要绑定域名，我们可以点击「映射」按钮，会弹出一个输入框让我们输入需要映射的域名：

![](/media/202107/2021-07-23_103332.png)

点击「确定」之后，我们就可以通过域名访问刚刚部署的项目了。

## 七、设置HTTPS

如果需要为域名开启 https 访问，请在「网站」菜单域名对应的一栏点击「设置」链接：

![](/media/202112/2021-12-05_093712_442260.png)

根据自己的证书类型，在相应的选项卡进行证书的配置即可：

![](/media/202112/2021-12-05_093821_660079.png)

宝塔面板「Python 项目管理器1.9」部署