1. 环境准备与必要软件安装
在开始部署之前，确保您的windows server 2019已安装iis 10。
1.1 安装Python 64位版本
强烈建议安装Python 64位版本，并选择“为所有用户安装”，以便系统服务账户能够访问。
- 访问 Python官方网站 下载最新的Python 3.x 64位安装包。
- 运行安装程序，勾选“Add Python to PATH”选项，并选择“Install Now”或自定义安装路径（例如 C:\Program Files\Python312）。
1.2 安装Microsoft HTTP Platform Handler
HTTP Platform Handler是IIS与外部进程（如Python应用）通信的关键组件。
- 访问 IIS.net 下载适用于您系统的HTTP Platform Handler 1.2 x64版本。
- 运行安装程序完成安装。
1.3 安装FastAPI和Uvicorn
FastAPI是一个现代、高性能的Python Web框架，Uvicorn是其推荐的ASGI服务器。
- 打开管理员权限的命令提示符或PowerShell。
- 执行以下命令安装FastAPI和Uvicorn：
pip install fastapi uvicorn
2. FastAPI应用程序目录与代码准备
2.1 创建应用目录和日志目录
2.2 创建FastAPI应用代码 (main.py)
在 C:\python-app 目录下创建 main.py 文件，并添加以下示例代码：
from fastapi import FastAPI
app = FastAPI()
@app.get("/python") # 注意：此路由路径应与IIS中配置的应用程序别名一致
async def get_root():
return {"message": "Hello World from FastAPI on IIS"}重要提示： @app.get("/python") 中的 /python 路径应与您稍后在IIS中为该应用设置的别名保持一致，否则可能会导致路由不匹配。
3. 配置IIS web.config 文件
在 C:\python-app 目录下创建 web.config 文件，用于指导IIS如何启动和管理Python应用。
配置项说明：
- processPath: 指定启动Python应用的执行文件路径。这里应指向Uvicorn的可执行文件（通常位于Python安装目录的 Scripts 文件夹下）。请根据您的Python安装路径进行调整。
- arguments: 传递给Uvicorn的参数。main:app 指示Uvicorn加载 main.py 文件中的 app 实例。--host 0.0.0.0 允许从任何网络接口访问，--port %HTTP_PLATFORM_PORT% 接收IIS分配的端口。--log-level info 设置日志级别。
- stdoutLogEnabled: 启用标准输出日志。
- stdoutLogFile: 指定日志文件的路径。.\logs\uvicorn 表示在应用目录下的 logs 文件夹中生成 uvicorn 开头的日志文件。
- startupTimeLimit: 应用启动的最大等待时间（秒）。
- processesPerApplication: 每个应用程序池允许的最大进程数。
- environmentVariables: 环境变量设置。PYTHONPATH 必须指向您的应用目录 (C:\python-app\)，以便Uvicorn能够找到 main.py。
4. 配置IIS应用程序池
为了隔离和管理FastAPI应用，需要创建一个独立的应用程序池。
- 打开IIS管理器。
- 在“应用程序池”右键菜单中选择“添加应用程序池”。
- 名称： PythonAppPool (或您喜欢的任何名称)。
- 托管管道模式： 集成。
- “.NET CLR 版本”： 无托管代码。
- 点击“确定”。
- 选中新建的 PythonAppPool，点击右侧的“高级设置...”。
- “标识”： 保持默认的 ApplicationPoolIdentity。这是IIS内置的账户，具有最小权限，是推荐的做法。
5. 文件系统权限设置
IIS的应用程序池标识（ApplicationPoolIdentity，代表 IUSR 和 IIS_IUSRS 组）需要对Python安装目录和FastAPI应用目录具有足够的读写权限。
打开管理员权限的命令提示符或PowerShell。
-
执行以下命令授予权限（请根据您的Python安装路径调整）：
# 授予IIS_IUSRS组对Python安装目录及其子目录的读取和执行权限 icacls "C:\Program Files\Python312" /grant "Builtin\IIS_IUSRS:(OI)(CI)(RX)" # 授予IUSR账户对Python安装目录及其子目录的读取和执行权限 icacls "C:\Program Files\Python312" /grant "NT AUTHORITY\IUSR:(OI)(CI)(RX)" # 授予IIS_IUSRS组对FastAPI应用目录及其子目录的完全控制权限（包括日志写入） icacls "C:\python-app" /grant "Builtin\IIS_IUSRS:(OI)(CI)(F)" # 授予IUSR账户对FastAPI应用目录及其子目录的完全控制权限（包括日志写入） icacls "C:\python-app" /grant "NT AUTHORITY\IUSR:(OI)(CI)(F)"
- (OI)(CI) 表示对象继承和容器继承，使权限应用于子文件夹和文件。
- (RX) 表示读取和执行权限。
- (F) 表示完全控制权限，这对于应用写入日志文件是必需的。
6. 在IIS中添加应用程序
将FastAPI应用添加到IIS站点。
- 打开IIS管理器。
- 展开“站点” -> “Default Web Site”（或您自定义的站点）。
- 右键点击“Default Web Site”，选择“添加应用程序...”。
- 别名： python (此别名应与 main.py 中 @app.get("/python") 的路由路径匹配)。
- 应用程序池： 选择之前创建的 PythonAppPool。
- 物理路径： C:\python-app。
- 点击“确定”。
7. 测试与验证
现在，您的FastAPI应用应该已在IIS上运行。
- 打开浏览器，访问 http://localhost/python (如果您在本地服务器上测试) 或 http://您的服务器IP/python。
- 如果一切配置正确，您将看到浏览器显示 {"message": "Hello World from FastAPI on IIS"}。
故障排除：
- 如果遇到HTTP 500错误，请检查 C:\python-app\logs 目录下的Uvicorn日志文件，它们会提供详细的错误信息。
- 确保 web.config 中的 processPath 和 PYTHONPATH 路径正确无误。
- 仔细检查文件系统权限是否已正确设置。
8. 生产环境优化
当应用稳定运行后，您可以进行一些优化：
- 日志级别： 在 web.config 中，将 arguments 中的 --log-level info 修改为 --log-level error，以减少生产环境的日志量。
- 安全性： 确保您的FastAPI应用代码遵循安全最佳实践，例如输入验证、错误处理等。
- 性能： 根据负载调整 processesPerApplication 参数，以优化性能。
通过遵循上述步骤，您将能够在IIS 10上成功部署和运行Python FastAPI应用程序，利用IIS的强大功能来管理和托管您的Python Web服务。
