如何在IIS中部署Flask应用程序？

Question

谁能帮助我在IIS 6上运行Flask应用程序？我曾尝试使用isapi-wsgi，但是当我访问虚拟目录地址时，会得到一个页面，显示“找不到指定的模块”。还有其他选择吗？

以下是我为isapi-wsgi编写的Python脚本。已创建虚拟目录，并且在IIS管理器中一切正常，但该站点无法正常工作。

from wof import app
import os

app.secret_key=os.urandom(24)

import isapi_wsgi
def __ExtensionFactory__():
    return isapi_wsgi.ISAPISimpleHandler(app)

if __name__ == '__main__':
    from isapi.install import *
    params = ISAPIParameters()
    sm = [ScriptMapParams(Extension="*", Flags=0)]
    vd = VirtualDirParameters(Name="WOFPy_Sondes", Description="ISAPI-WSGI for WOFPY Sondes test", ScriptMaps=sm, ScriptMapUpdate="replace")
    params.VirtualDirs = [vd]
    HandleCommandLine(params)

Answer 1

高层概述
HTTP-> IIS-> ISAPI-> FastCGI-> WSGI（Flask应用程序）

设定步骤

步骤1：安装所需的二进制文件

1. 安装Python（2.7或3.x-我使用3.3）
2. 安装pip-Win（我使用1.6版）
3. 安装pywin32（我使用版本218）
4. 使用fcgisetup 1.5安装IIS FastCGI扩展

步骤2：安装可选的二进制程序包

我pyodbc使用此站点的安装程序.exe进行安装。从源安装（例如，用于安装到虚拟环境中的pip）需要C / C ++编译器。

步骤3：取得的副本 wfastcgi.py

选择一个适合你的版本，最好是一个支持Python 3.3的版本（我使用过David Ebbo的）。你可能需要这里的“官方”版本。

将wfastcgi.py脚本安装到其中C:\Inetpub\wwwroot，并确保将为你的应用程序提供服务的帐户（默认情况下为“网络服务”）对其具有读取权限。

步骤4：安装virtualenv到系统站点包

C:\Python33\Scripts\pip.exe install virtualenv

（如果你使用的是Python 3.3，并且所有内容均安装在默认位置）

步骤5：安装Flask应用程序

你可以在系统上的任何位置安装应用程序。你可能需要将其安装在下C:\Inetpub。在本教程中，我们将调用应用程序install的根文件夹 %APPROOT%。（不要在环境变量中加上引号。）

确保将为你的应用程序提供服务的帐户（默认情况下为“网络服务”）具有对所有脚本文件的读取权限。该命令：

cacls "%APPROOT%" /S:"D:PAI(A;OICI;FA;;;BA)(A;OICIIO;FA;;;CO)(A;OICI;0x1200a9;;;NS)(A;OICI;FA;;;SY)"

将为你的应用程序目录提供以下权限：

• BUILTIN \ Administrators：完全控制此文件夹，子文件夹和文件
• 创建者所有者：完全控制子文件夹和文件
• NT AUTHORITY \ NETWORK SERVICE：对此文件夹，子文件夹和文件的读取权限
• NT AUTHORITY \ SYSTEM：对此文件夹，子文件夹和文件的完全控制
• 添加任何必要的本地配置（我的应用程序使用版本控制系统忽略的local.cnf文件），例如数据库URL。
• 确保你的应用程序中包含一个Web.config文件%APPROOT%-有关文件格式的信息，请参见以下部分。

步骤6：为你的应用程序创建一个virtualenv

C:\Python33\Scripts\virtualenv.exe --system-site-packages "%APPROOT%\env"

（选择名称，env除非你的应用程序已经使用该目录。）

步骤7：将应用程序所需的软件包安装到virtualenv

cd "%APPROOT%"
env\Scripts\activate
pip install -r Packages

（我的项目将需求规范保存在名为的文件中Packages。）

步骤8：为你的应用程序创建网站或虚拟目录

使用inetmgr.msc（开始 -> 运行…，然后inetmgr在编辑框中输入并按Enter）启动Internet信息服务（IIS）管理器。确保将你创建的节点（网站或虚拟目录）的本地路径设置为Flask应用程序的根文件夹。 wfastcgi.py使用本地路径来标识Flask应用程序以处理请求。

授予节点读取和脚本（运行脚本）权限。

步骤9：设定 fcgiext.ini

该文件与fcgiext.dll步骤1中安装的目录位于同一目录（默认为%SYSTEMROOT%\system32\inetsrv）。

在配置此文件时，你需要几个参数：

• {site id}：从窗口左侧的树中选择“网站”时，你可以在Internet信息服务（IIS）管理器的详细信息（右侧）窗格中找到的数字网站ID 。
• {application name}：其中的部分名称，fcgiext.ini用于提供FastCGI（ISAPI）处理程序的参数。你选择此值-选择代表你的应用程序的内容。
• {app to app}：对于虚拟目录，是网站内要处理的虚拟目录的URL路径。
• {approot}：应用程序根目录的路径。

使用这些参数可以：

• 将FastCGI请求映射到处理部分：

• 对于整个网站，请添加到该部分。*:{site id}={application name}[Types]

• 对于虚拟目录，请添加到该部分。*:/lm/w3svc/{site id}/root/{path to app}={application name}[Types]
  添加带有此应用程序参数的处理部分（）（完整参考）：[{application name}]
  

• ExePath={approot}\env\python.exe

• Arguments=C:\Inetpub\wwwroot\wfastcgi.py（或wfastcgi.py安装适配器脚本的任何地方）
• EnvironmentVars=ENV_VAR1:value,ENV_VAR2:value,etc.（有关报价规则，请参见完整参考）。这是设置WSGI_LOG环境变量的好地方-确保为站点提供服务的帐户（默认情况下为“网络服务”）具有对该文件的写权限，并且（如果该文件不存在）具有向其添加文件的权限。包含的目录。

步骤10：为目标URL配置FastCGI处理

使用Internet信息服务（IIS）管理器，从Flask应用程序要服务的节点（网站或虚拟目录）的上下文（右键单击）菜单中选择“属性…”，并：

• 在“主目录”选项卡（网站）或“虚拟目录”选项卡（虚拟目录）中，单击“配置…”按钮。

• 在“通配符应用程序映射”部分中，使用“插入…”按钮添加通配符映射：

• 可执行文件是在步骤1中安装的FastCGI扩展DLL。其默认位置是%SYSTEMROOT%\system32\inetsrv\fcgiext.dll。

• 确保未选中 “验证该文件是否存在” 。Flask应用程序执行自己的路由，这些路由不一定与磁盘上的文件有任何关系。
  Web.config
  这个文件是（在此设置）读取wfastcgi.py，不是由IIS。
  

<?xml version="1.0" encoding="UTF-8"?>

<configuration>
    <applicationSettings>
        <add key=“PYTHONPATH” value=“”/>
        <add key=“WSGI_HANDLER” value=“module.application”/>
    </applicationSettings>
</configuration>

• <add>元素添加环境变量（os.environ在Python中）。

• WSGI_HANDLER必须指定-它告诉wfastcgi.py如何定位WSGI应用程序对象。如果该值以“（）”结尾，wfastcgi.py则将调用命名对象，并期望它返回WSGI应用程序对象。

• PYTHONPATH是经过特殊处理的- 对的值wfastcgi.py执行（环境）变量扩展（使用Windows标准%VAR%表示法）PYTHONPATH，然后将结果分割为分号，并将条目追加到sys.path调用WSGI应用程序之前。因为wfastcgi.py在导入包含WSGI应用程序对象的模块之前将当前目录更改为指定为Web站点或虚拟目录的本地路径的路径，所以在PYTHONPATH中包含空字符串将导致搜索将Flask应用程序目录作为开始点。你还可以在fcgiext.ini中设置PYTHONPATH （在这种情况下，sys.path解释器将其包含进来，然后再由wfastcgi.py）将其包含进来。

• WSGI_RESTART_FILE_REGEX给出一个Python正则表达式，用于过滤应触发FastCGI处理程序进程重启的路径的文件更改通知。设置为在源文件或配置文件更改时触发。我用(?i).*\.(py|cnf|config)$。

• WSGI_LOG可能在此处设置，但我认为最好在设置fcgiext.ini。

对于IIS 7

从IIS 7开始，FastCGI的某些事情发生了巨大变化。从该版本开始，FastCGI直接通过IIS进行支持，并且未通过扩展程序进行配置（即步骤1.4是不必要的，fcgiext.ini并且不控制IIS 7+的FastCGI行为，因此不需要创建/编辑它）。相反，请确保在“ 控制面板”>“程序和功能”>“打开或关闭Windows功能”下的“ Internet信息服务”下启用了CGI。

Web.config

IIS 7是第一个从Web.config文件中读取与FastCGI相关的配置设置的IIS 。你的Web.config文件将需要在<configuration>元素内包含元素，该<system.webServer>元素包含的<handlers>元素包含 具有属性的元素：

• path: *
• verb: *
• modules: FastCgiModule
• resourceType: Unspecified
• requireAccess: Script
• scriptProcessor: the tricky one

scriptProcessor属性

<add>元素的此属性必须包含.exe你要使用的Python解释器文件的完整路径（Scripts Python virtualenv子文件夹中的|路径），后跟a ，然后是wfastcgi.py你正在使用的文件的完整路径。由于这些路径取决于运行应用程序的计算机的设置，因此你可能需要在部署过程中设置此属性。

IIS服务器范围的设置

• 在中inetmgr，单击树中的服务器节点，然后从中央窗格中选择“ FastCGI设置”。将列出可执行文件/参数对的列表。
• 为你python.exe和wfastcgi.py你正在使用的完整路径添加一个条目。两者都应以相同的方式显示在 / 元素中 Web.config。
• 确保PYTHONPATH在新的FastCGI应用程序条目中设置环境变量，以包括应用程序代码库的根。有关添加一个空的建议PYTHONPATH在进入<applicationSettings>你的Web.config可能并不适用于这个版本的IIS。