Flask应用部署通用指南

IIS 部署 Python Flask 应用通用指南

目录

1. 概述
2. 环境准备
3. 应用准备
4. wfastcgi 配置
5. IIS 网站配置
6. 权限配置
7. 静态文件处理
8. 安全配置
9. 性能优化
10. 常见问题与解决方案
11. 生产环境最佳实践

概述

将 Flask 应用部署到 Windows IIS 服务器上需要使用 WSGI 适配器（如 wfastcgi）将 HTTP 请求从 IIS 传递到 Flask 应用程序。本指南涵盖了完整的部署过程，适用于任何 Flask 应用。

环境准备

Windows Server 配置

1. 安装 IIS：

   • 打开"服务器管理器" → “添加角色和功能”
   • 选择"Web 服务器 (IIS)"角色
   • 确保选择以下功能：
     • Web 服务器 → 应用程序开发 → CGI
     • Web 服务器 → 应用程序开发 → WebSocket 协议
     • Web 服务器 → 通用 HTTP 功能 → 静态内容
     • Web 服务器 → 通用 HTTP 功能 → 默认文档
     • Web 服务器 → 通用 HTTP 功能 → 目录浏览
     • 管理工具 → IIS 管理控制台
   • 完成安装

2. 安装 URL 重写模块（可选但推荐）：

   • 从 Microsoft 官方网站 下载 URL 重写模块
   • 运行安装程序并按照提示完成安装

3. 安装 Python：

   • 下载并安装 Python（建议使用 3.7 或更高版本）
   • 安装时选择"添加 Python 到 PATH"选项
   • 可在命令行验证安装：python --version

应用服务器目录结构

为你的应用创建标准化的目录结构：

C:\inetpub\wwwroot\flask-app\       # 应用根目录
├── app\                            # Flask 应用代码
│   ├── __init__.py                # Flask 应用初始化
│   ├── views\                     # 视图函数
│   ├── models\                    # 数据模型
│   ├── static\                    # 静态文件
│   └── templates\                 # 模板文件
├── logs\                          # 日志目录
├── venv\                          # Python 虚拟环境
├── requirements.txt               # 依赖列表
├── wsgi.py                        # WSGI 入口点
└── web.config                     # IIS 配置文件

应用准备

1. 创建应用目录：

   mkdir C:\inetpub\wwwroot\flask-app
   mkdir C:\inetpub\wwwroot\flask-app\logs
   

2. 设置 Python 虚拟环境：

   cd C:\inetpub\wwwroot\flask-app
   python -m venv venv
   venv\Scripts\activate
   

3. 安装项目依赖：

   pip install flask
   pip install wfastcgi
   pip install -r requirements.txt  # 如果有项目特定的依赖
   

4. 创建 WSGI 入口文件：

   创建 C:\inetpub\wwwroot\flask-app\wsgi.py 文件：

   from app import app as application
   
   if __name__ == '__main__':
       application.run()
   

   注意：文件中的导入语句应该匹配你的 Flask 应用结构。例如，如果你的 Flask 应用在 app/__init__.py 中初始化，则使用上面的导入语句。

wfastcgi 配置

1. 启用 wfastcgi：

   venv\Scripts\activate
   wfastcgi-enable
   

   记下输出中显示的路径，形如：

   "C:\inetpub\wwwroot\flask-app\venv\Scripts\python.exe|C:\inetpub\wwwroot\flask-app\venv\Lib\site-packages\wfastcgi.py"
   

2. 创建 web.config 文件：

   在应用根目录创建 C:\inetpub\wwwroot\flask-app\web.config 文件：

   <configuration>
     <system.webServer>
       <handlers>
         <add name="Python FastCGI" 
              path="*" 
              verb="*" 
              modules="FastCgiModule" 
              scriptProcessor="C:\inetpub\wwwroot\flask-app\venv\Scripts\python.exe|C:\inetpub\wwwroot\flask-app\venv\Lib\site-packages\wfastcgi.py" 
              resourceType="Unspecified" 
              requireAccess="Script" />
       handlers>
       <rewrite>
         <rules>
           <rule name="Static Files" stopProcessing="true">
             <match url="^static/.*" />
             <action type="None" />
           rule>
         rules>
       rewrite>
     system.webServer>
     <appSettings>
       
       <add key="WSGI_HANDLER" value="wsgi.application" />
       <add key="PYTHONPATH" value="C:\inetpub\wwwroot\flask-app" />
       
       
       <add key="WSGI_LOG" value="C:\inetpub\wwwroot\flask-app\logs\wsgi.log" />
       
       
       <add key="FLASK_ENV" value="production" />
       <add key="FLASK_CONFIG" value="production" />
     appSettings>
   configuration>
   

   注意：

   • WSGI_HANDLER 值应匹配你的 WSGI 入口点
   • scriptProcessor 路径应使用从 wfastcgi-enable 命令输出中获取的路径
   • PYTHONPATH 应指向应用根目录

IIS 网站配置

1. 打开 IIS 管理器：

   • 开始菜单 → 管理工具 → Internet Information Services (IIS) 管理器

2. 创建应用程序池：

   • 右键点击"应用程序池" → “添加应用程序池”
   • 设置以下属性：
     • 名称：FlaskAppPool
     • .NET CLR 版本：无托管代码
     • 托管管道模式：集成

3. 配置应用程序池：

   • 右键点击新建的应用程序池 → “高级设置”
   • 设置以下属性：
     • 启用32位应用程序：False（如果使用64位 Python）
     • 标识：ApplicationPoolIdentity（或特定服务账户）
     • 闲置超时（分钟）：0（防止应用池回收）
     • 回收时间间隔（分钟）：0（禁用定期回收）

4. 部署选项 A - 创建新网站：

   • 右键点击"网站" → “添加网站”
   • 设置以下属性：
     • 网站名称：Flask Application
     • 应用程序池：选择刚创建的应用程序池
     • 物理路径：C:\inetpub\wwwroot\flask-app
     • 绑定：类型"http"，IP地址"*“或特定IP，端口"80”
     • 点击确定

5. 部署选项 B - 作为现有网站的应用程序：

   • 右键点击现有网站 → “添加应用程序”
   • 设置以下属性：
     • 别名：flask-app
     • 应用程序池：选择刚创建的应用程序池
     • 物理路径：C:\inetpub\wwwroot\flask-app
     • 点击确定

权限配置

1. 设置应用程序目录权限：

   icacls "C:\inetpub\wwwroot\flask-app" /grant "IIS_IUSRS:(OI)(CI)(RX)"
   icacls "C:\inetpub\wwwroot\flask-app\logs" /grant "IIS_IUSRS:(OI)(CI)(M)"
   

2. 如果使用自定义应用程序池标识：

   icacls "C:\inetpub\wwwroot\flask-app" /grant "IIS AppPool\FlaskAppPool:(OI)(CI)(RX)"
   icacls "C:\inetpub\wwwroot\flask-app\logs" /grant "IIS AppPool\FlaskAppPool:(OI)(CI)(M)"
   

3. 对需要写入权限的其他目录设置权限（例如上传文件目录）：

   icacls "C:\inetpub\wwwroot\flask-app\app\uploads" /grant "IIS_IUSRS:(OI)(CI)(M)"
   

静态文件处理

1. 确保 web.config 中包含静态文件规则：

   <rewrite>
     <rules>
       <rule name="Static Files" stopProcessing="true">
         <match url="^static/.*" />
         <action type="None" />
       rule>
     rules>
   rewrite>
   

2. 为大型应用创建单独的静态文件目录（可选）：

   对于需要大量静态文件的应用，可以考虑设置单独的静态文件目录或虚拟目录：

   • 在 IIS 管理器中，右键单击你的网站或应用程序
   • 选择"添加虚拟目录"
   • 别名：static
   • 物理路径：C:\inetpub\wwwroot\flask-app\app\static

安全配置

1. 配置 HTTPS：

   • 获取 SSL 证书（购买商业证书、使用 Let’s Encrypt 或创建自签名证书）
   • 在 IIS 管理器中，选择服务器 → “服务器证书”
   • 导入或创建证书
   • 为网站添加 HTTPS 绑定：
     • 在 IIS 管理器中选择网站
     • 点击右侧的"绑定…"
     • 点击"添加"，类型选择"https"
     • 选择 SSL 证书
     • 端口通常为 443
     • 点击"确定"

2. 强制 HTTPS（使用 URL 重写模块）：

   在 web.config 中添加以下规则：

   <rule name="HTTP to HTTPS" stopProcessing="true">
     <match url="(.*)" />
     <conditions>
       <add input="{HTTPS}" pattern="^OFF$" />
     conditions>
     <action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="Permanent" />
   rule>
   

3. 设置安全头：

   在 Flask 应用中添加安全头，或在 web.config 中添加：

   <httpProtocol>
     <customHeaders>
       <add name="X-Content-Type-Options" value="nosniff" />
       <add name="X-Frame-Options" value="SAMEORIGIN" />
       <add name="X-XSS-Protection" value="1; mode=block" />
       <add name="Strict-Transport-Security" value="max-age=31536000; includeSubDomains" />
     customHeaders>
   httpProtocol>
   

性能优化

1. 配置应用程序池设置：

   • 禁用应用程序池回收（设置回收时间间隔为 0）
   • 设置合适的空闲超时（对于持续使用的应用设置为 0）
   • 配置总是运行托管管道（避免冷启动延迟）

2. 启用输出缓存：

   在 web.config 中添加：

   <caching>
     <profiles>
       <add extension=".html" policy="CacheUntilChange" kernelCachePolicy="CacheUntilChange" />
       <add extension=".css" policy="CacheUntilChange" kernelCachePolicy="CacheUntilChange" />
       <add extension=".js" policy="CacheUntilChange" kernelCachePolicy="CacheUntilChange" />
     profiles>
   caching>
   

3. 配置静态内容压缩：

   在 web.config 中启用压缩：

   <urlCompression doStaticCompression="true" doDynamicCompression="true" />
   

4. Flask 应用级别优化：

   • 使用 Flask-Caching 实现视图缓存
   • 优化数据库查询
   • 实现适当的会话管理

常见问题与解决方案

1. HTTP 500 错误

症状：浏览器显示 500 - 内部服务器错误

解决方案：

• 检查 wfastcgi 日志 (C:\inetpub\wwwroot\flask-app\logs\wsgi.log)
• 验证 web.config 中的路径配置
• 确认 WSGI_HANDLER 设置正确（应匹配你的 Flask 应用实例）
• 检查应用本身是否有错误

2. HTTP 404 错误

症状：浏览器显示 404 - 未找到

解决方案：

• 确保 URL 路径正确
• 验证 Flask 路由是否正确定义
• 检查 IIS 处理程序映射是否正确配置
• 验证静态文件规则配置

3. 导入错误

症状：在 wsgi 日志中看到 ImportError 或 ModuleNotFoundError

解决方案：

• 检查 PYTHONPATH 设置是否正确
• 验证所有依赖是否已安装
• 确保虚拟环境路径正确
• 检查应用结构与导入语句是否匹配

4. 权限错误

症状：出现"拒绝访问"或权限相关错误

解决方案：

• 为 IIS_IUSRS 或应用程序池用户提供适当的目录权限
• 检查日志目录和其他需要写入权限的目录
• 验证应用程序池标识设置

5. 静态文件不加载

症状：CSS、JavaScript 或图像文件未正确加载

解决方案：

• 检查 web.config 中的静态文件规则
• 验证静态文件路径是否正确
• 确保 IIS 有权访问静态文件目录
• 检查浏览器控制台中的具体错误

生产环境最佳实践

1. 监控和日志记录：

   • 配置 Windows 事件日志集成
   • 设置应用程序性能监控
   • 实现结构化日志记录
   • 考虑使用集中式日志管理解决方案

2. 备份策略：

   • 定期备份应用代码和配置
   • 备份数据库（如果适用）
   • 创建自动备份脚本或任务

3. 高可用性（大型应用）：

   • 考虑使用多个应用服务器
   • 实现负载均衡
   • 使用健康检查端点

4. 部署自动化：

   • 创建部署脚本
   • 考虑使用 CI/CD 管道
   • 实现蓝绿部署或滚动更新策略

5. 定期维护：

   • 更新 Windows 安全补丁
   • 更新 Python 和依赖包
   • 监控和优化性能
   • 定期审查安全设置

---

按照本指南，你应该能够成功地将任何 Flask 应用部署到 Windows IIS 服务器上。记住，每个应用都可能有特定的需求，因此可能需要对某些步骤进行调整。

如果遇到问题，请查看 wsgi 日志文件、IIS 日志（通常在 C:\inetpub\logs\LogFiles）以及 Windows 事件查看器中的应用程序日志。IIS 与 WSGI 部署 Flask 应用的详细步骤

下面是在 Windows 服务器上使用 IIS 与 WSGI 部署 Flask 应用的详细步骤：

前期准备

1. 确认安装必要组件

   ：

   • Windows Server (2016/2019/2022)
   • IIS (Internet Information Services)
   • Python 3.7+ (建议使用 3.9 或 3.10)

2. 确认 IIS 已安装

   ：

   • 打开"服务器管理器" → “添加角色和功能”
   • 选择"Web 服务器 (IIS)"及必要组件，特别是 CGI
   • 完成安装并确认 IIS 可以访问

步骤一：准备 Flask 应用

1. 创建应用目录

   ：

   mkdir C:\inetpub\wwwroot\dingtalk-approval
   

2. 复制应用文件

   ： 将你的 Flask 应用文件复制到这个目录下。确保包含：

   • app.py (主应用文件)
   • dingtalk/ (目录及其内容)
   • static/ (静态文件目录)
   • templates/ (模板目录)
   • requirements.txt (依赖列表)

3. 创建虚拟环境

   （可选但推荐）：

   cd C:\inetpub\wwwroot\dingtalk-approval
   python -m venv venv
   venv\Scripts\activate
   

4. 安装依赖

   ：

   pip install -r requirements.txt
   pip install wfastcgi
   

步骤二：配置 WSGI

1. 激活 wfastcgi

   ：

   venv\Scripts\activate  # 如果使用虚拟环境
   wfastcgi-enable
   

   记下输出中的 scriptProcessor 路径，形如：

   C:\inetpub\wwwroot\dingtalk-approval\venv\Scripts\python.exe|C:\inetpub\wwwroot\dingtalk-approval\venv\Lib\site-packages\wfastcgi.py
   

2. 创建 web.config 文件

   ： 在应用根目录创建

   web.config
   

   文件，内容如下（注意替换路径）：

   xml

   <configuration>
     <system.webServer>
       <handlers>
         <add name="Python FastCGI" 
              path="*" 
              verb="*" 
              modules="FastCgiModule" 
              scriptProcessor="C:\inetpub\wwwroot\dingtalk-approval\venv\Scripts\python.exe|C:\inetpub\wwwroot\dingtalk-approval\venv\Lib\site-packages\wfastcgi.py" 
              resourceType="Unspecified" 
              requireAccess="Script" />
       handlers>
     system.webServer>
     <appSettings>
       <add key="PYTHONPATH" value="C:\inetpub\wwwroot\dingtalk-approval" />
       <add key="WSGI_HANDLER" value="app.app" />
       <add key="WSGI_LOG" value="C:\inetpub\wwwroot\dingtalk-approval\logs\wfastcgi.log" />
       <add key="FLASK_ENV" value="production" />
     appSettings>
   configuration>
   

3. 创建并设置日志目录

   ：

   mkdir C:\inetpub\wwwroot\dingtalk-approval\logs
   

   确保 IIS 应用程序池的用户（通常是 IIS_IUSRS）有此目录的写入权限。

步骤三：在 IIS 中创建网站

1. 打开 IIS 管理器

   ：

   • 开始菜单 → 管理工具 → Internet Information Services (IIS) 管理器

2. 创建应用程序池

   ：

   • 右键点击"应用程序池" → “添加应用程序池”
   • 名称：DingTalkApprovalPool
   • .NET CLR 版本：无托管代码
   • 托管管道模式：集成
   • 点击确定

3. 设置应用程序池

   ：

   • 右键点击新创建的应用程序池 → “高级设置”
   • 找到"标识" → 设置为适当的账户（例如 ApplicationPoolIdentity）

4. 创建网站或应用程序

   ：

   • 如果是独立网站：右键点击"网站" → “添加网站”
   • 如果是现有网站下的应用程序：右键点击网站 → “添加应用程序”
   • 填写以下信息：
     • 网站名称/别名：DingTalkApproval
     • 应用程序池：选择刚创建的 DingTalkApprovalPool
     • 物理路径：C:\inetpub\wwwroot\dingtalk-approval
     • 端口号（仅网站）：例如 80 或 8080

步骤四：配置权限

1. 设置目录权限

   ：

   • 右键点击 C:\inetpub\wwwroot\dingtalk-approval 目录
   • 选择"属性" → “安全” → “编辑”
   • 添加"IIS_IUSRS"用户，并赋予"修改"权限
   • 点击"确定"应用权限

2. 处理 ApplicationPoolIdentity 权限

   ： 如果使用 ApplicationPoolIdentity，则添加相应的用户：

   IIS AppPool\DingTalkApprovalPool
   

   并赋予"修改"权限

步骤五：测试和故障排除

1. 重启 IIS

   ：

   • 在 IIS 管理器中右键点击服务器名称 → “重新启动”
   • 或使用命令行：iisreset

2. 访问应用： 在浏览器中访问 http://localhost 或 http://localhost:8080（根据你配置的端口）

3. 检查错误

   ： 如果应用不能正常运行：

   • 检查 C:\inetpub\wwwroot\dingtalk-approval\logs\wfastcgi.log
   • 检查 Windows 事件查看器中的错误
   • 确认 IIS 错误日志（通常在 C:\inetpub\logs\LogFiles）

步骤六：配置 HTTPS（推荐）

1. 获取 SSL 证书

   ：

   • 使用自签名证书（测试用）或购买正式证书
   • 使用 IIS 管理器中的"服务器证书"功能

2. 绑定 HTTPS

   ：

   • 在 IIS 管理器中选择你的网站
   • 点击右侧的"绑定…"
   • 点击"添加"，选择类型为"https"
   • 选择你的 SSL 证书
   • 设置端口（通常为 443）
   • 点击"确定"

常见问题解决

1. 500 内部服务器错误

   ：

   • 检查 wfastcgi.log
   • 确认 web.config 中的路径是否正确
   • 验证应用程序池身份有足够权限

2. 无法启动进程错误

   ：

   • 检查 Python 路径是否正确
   • 确认 wfastcgi 已正确安装

3. 模块不存在错误

   ：

   • 确认所有依赖项已安装
   • 检查虚拟环境是否正确配置

4. 访问拒绝错误

   ：

   • 检查目录和文件权限
   • 确认 IIS 用户有适当的访问权限
     create by yyr