使用 IIS 部署 MrDoc

本篇文档介绍在 Windows 操作系统下使用 IIS 服务器部署 MrDoc。

## 准备源码

首先需要将 MrDoc 的代码下载到本地并进行初始化：

```
# 使用 Git 工具克隆 MrDoc 源码
git clone https://gitee.com/zmister/MrDoc/

# 安装依赖模块
pip install -r requirements.txt

# 初始化数据库
python manage.py migrate

# 创建管理员用户
python manage.py createsuperuser
```

## 安装 wfastcgi

wfastcgi 是一个 Python 第三方库，它架起了一座 IIS 和 Python之间的桥梁，借助它，我们就可以通过 IIS 来部署 Python Web 应用程序了。

通过如下命令进行安装：

```
pip install wfastcgi
```

## FastCGI 设置

在 IIS 主页选择「FastCGI设置」：

![](/media/202109/2021-09-14_110739_322995.png)

点击「添加应用程序」：

![](/media/202109/2021-09-14_110902_733794.png)

在弹出的输入框内输入信息，其中「完整路径」是你使用的 Python 的路径，参数是 wfastcgi 库的路径：

![](/media/202109/2021-09-14_111016_438583.png)

例如：

![](/media/202109/2021-09-14_111036_970746.png)

接着设置环境变量：

![](/media/202109/2021-09-14_111129_282094.png)

新增名为「DJANGO_SETTINGS_MODULE」的环境变量，其值为 `MrDoc.settings`

新增名为「WSGI_HANDLER」的环境变量，其值为 `MrDoc.wsgi.application`

新增名为「PYTHONPATH」的环境变量，其值为 `C:\MrDoc`

![](/media/202109/2021-09-14_111341_447805.png)

## 新建站点

点击「网站」，进入网站管理主页后点击「添加网站」：

![](/media/202109/2021-09-14_111702_305177.png)

按需输入网址名称，物理路径则为`manage.py`文件所在的路径。

## 添加程序映射

进入 MrDoc 站点主页，点击「处理程序映射」：

![](/media/202109/2021-09-14_112013_070130.png)

点击「添加模块映射」：

![](/media/202109/2021-09-14_112054_651357.png)

其中：请求路径填入`*`，模块选择「FastCgiModule」，可执行文件填入`Python.exe路径|wfastcgi路径`，例如：

```
C:\Users\Administrator\AppData\Local\Programs\Python\Python37\python.exe|C:\Users\Administrator\AppData\Local\Programs\Python\Python37\Lib\site-packages\wfastcgi.py
```

接着在「请求限制」中取消勾选：

![](/media/202109/2021-09-14_112356_917734.png)

## 最后

这样，MrDoc 在 IIS 上就部署完成了。

现在，你可以在浏览器上输入IP地址访问部署好的 MrDoc。

![](/media/202109/2021-09-14_112718_899000.png)

如果你需要绑定域名，可以编辑网站的「绑定」：

![](/media/202109/2021-09-14_112757_820699.png)

在其中设置主机名：

![](/media/202109/2021-09-14_112821_091139.png)

如果访问网站出现`python.exe - FastCGI 进程意外退出`的错误网页提示，那么可以「应用程序池」的程序高级设置中，将「标识」修改为LocalSystem：

![](/media/202109/2021-09-14_113020_486814.png)