在IIS 10上部署FastAPI应用需要完成环境准备、依赖安装、IIS配置、站点部署等多个步骤,整体流程清晰,只要按照步骤操作就能顺利完成部署。

环境准备
首先需要确保服务器已经安装好IIS 10,并且安装了对应的Python环境,建议Python版本在3.7及以上,因为FastAPI对Python版本有一定要求。同时需要确认服务器已经安装了wfastcgi模块,这是IIS和Python应用通信的关键组件。
安装必要依赖
在服务器上打开命令提示符,执行以下命令安装FastAPI和uvicorn,以及wfastcgi模块:
# 安装FastAPI和uvicorn pip install fastapi uvicorn # 安装wfastcgi模块 pip install wfastcgi # 启用wfastcgi wfastcgi-enable
执行wfastcgi-enable之后会输出对应的配置路径,需要记录下这个路径,后续配置IIS的时候会用到。
创建FastAPI测试应用
先创建一个简单的FastAPI应用用于测试部署效果,在服务器上新建一个目录,比如C:fastapi_demo,在该目录下创建main.py文件,内容如下:
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def read_root():
return {"message": "FastAPI deployed on IIS 10 successfully"}
配置IIS站点
添加FastCGI设置
打开IIS管理器,在服务器根节点找到FastCGI设置,双击打开后点击右侧的添加应用程序,按照之前记录的wfastcgi-enable输出的路径填写配置:
- 完整路径:填写Python可执行文件的路径,比如
C:Python39python.exe - 参数:填写
C:Python39Libsite-packageswfastcgi.py,也就是wfastcgi模块的路径
填写完成后点击确定保存配置。
创建新站点
在IIS管理器的网站节点右键,选择添加网站,填写以下信息:
| 配置项 | 填写内容 |
|---|---|
| 网站名称 | FastAPIDemo |
| 物理路径 | C:fastapi_demo |
| 绑定类型 | http |
| 端口 | 8000(可自定义未被占用的端口) |
| 主机名 | 留空即可 |
点击确定完成站点创建。
配置处理程序映射
点击刚创建的FastAPIDemo站点,双击处理程序映射,点击右侧的添加模块映射,填写以下信息:
- 请求路径:
* - 模块:
FastCgiModule - 可执行文件:填写之前FastCGI设置里的完整路径和参数,格式为
C:Python39python.exe|C:Python39Libsite-packageswfastcgi.py,注意中间用竖线分隔 - 名称:
FastAPIHandler
点击请求限制,取消勾选仅当请求映射以下内容时才调用处理程序,然后依次点击确定保存配置。
添加web.config配置文件
在C:fastapi_demo目录下创建web.config文件,内容如下:
<configuration>
<system.webServer>
<handlers>
<add name="FastAPIHandler" path="*" verb="*" modules="FastCgiModule" scriptProcessor="C:Python39python.exe|C:Python39Libsite-packageswfastcgi.py" resourceType="Unspecified" />
</handlers>
</system.webServer>
<appSettings>
<add key="WSGI_HANDLER" value="main.app" />
<add key="PYTHONPATH" value="C:fastapi_demo" />
</appSettings>
</configuration>
其中WSGI_HANDLER的值对应FastAPI应用的实例,main.app表示main.py文件里的app实例,PYTHONPATH设置为应用所在的目录。
测试部署效果
打开浏览器,访问http://localhost:8000,如果页面返回{"message": "FastAPI deployed on IIS 10 successfully"},说明部署成功。
常见问题解决
如果访问出现500错误,可以先检查IIS的失败请求跟踪功能,查看具体的错误原因。常见的问题包括Python路径填写错误、web.config配置错误、依赖没有安装完整等。如果提示模块无法加载,需要确认FastCgiModule已经在IIS中安装,可在服务器管理器的添加角色和功能中勾选对应的模块。
另外需要注意,FastAPI应用如果使用了异步接口,在IIS部署时不需要额外修改代码,wfastcgi可以正常处理异步请求,只要确保uvicorn已经正确安装即可。