Django Windows+IIS+wfastcgi环境下部署

2023-01-25 18:50:28

教程基于 Windows 10专业版+Python3.6+IIS+wfastcgi 之上部署Django2.2的，同样适用于Windows server2012服务器和Windows7及以上的Windows操作系统。

环境准备

1.Python及其虚拟环境

Django依赖于Python解释器环境。安装步骤略。可参考https://www.cnblogs.com/wcwnina/p/9069783.html（根据实际情况，也可以不装虚拟环境）。

2.安装IIS服务器（含CGI）

打开【控制面板】->【程序和功能】，点开左侧的【启用或关闭Windows功能】，启用IIS，一定要包含CGI。

在浏览器地址输入localhost访问IIS测试，如果出现以下页面，表示安装成功。

3.拷贝项目文件、安装依赖库

首先，部署生产环境要关闭调试模式，修改settings文件：

DEBUG = False　　# 关闭调试

ALLOWED_HOSTS = ['127.0.0.1']　　# 指定能访问网站的主机IP

建议在服务器中新建文件夹，将上传的项目文件和虚拟环境放在同一文件夹里。进入虚拟环境，批量安装所有依赖库：

pip install -r requirements.txt

留意：执行以上命令的前提是，用命令"pip freeze > requirements.txt"把项目环境的依赖库信息导出到requirements.txt文件里。

如果使用的是Mysql数据库，请自行安装Mysql和导入数据，这里就不说明。

4.安装wfastcgi应用服务器

进入虚拟环境，pip安装之，如图。

启动wfastcgi：

wfastcgi-enable

如上图，启动成功之后，它会把Python路径和wfastcgi的路径显示出来，我们需要把这个路径复制出来，保存好，后边用得着！

e:\djblog\vpy_myblog\scripts\python.exe|e:\djblog\vpy_myblog\lib\site-packages\wfastcgi.py

注意：上面的路径，是由Python解释器的路径和“|”以及“wfastcgi.py”文件路径组成。

配置IIS服务器

通过【控制面板】->【管理工具】打开IIS管理器。

1.添加网站

2.web配置文件

在项目根目录下新建"web.config"配置文件，复制粘贴以下内容。

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <handlers>
            <add name="Python FastCGI" 
                 path="*" 
                 verb="*" 
                 modules="FastCgiModule" 
                 scriptProcessor="<Path to Python>\python.exe|<Path to Python>\lib\site-packages\wfastcgi.py" 
                 resourceType="Unspecified" 
                 requireAccess="Script"/>
        </handlers>
    </system.webServer>
    <appSettings>
        <add key="WSGI_HANDLER" value="django.core.wsgi.get_wsgi_application()" />
        <add key="PYTHONPATH" value="<Path to Django App>" />
        <add key="DJANGO_SETTINGS_MODULE" value="<Django App>.settings" />
    </appSettings>
</configuration>

修改配置文件：

3.添加静态文件虚拟目录

右键添加虚拟目录，如图。

添加虚拟目录时，别名与你的settings里设置的一致，比如"static"，物理路径就是静态资源的实际目录。

在static目录下新建一个"web.config"文件，然后写入下面的内容，保存即可无须修改。

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <!-- this configuration overrides the FastCGI handler to let IIS serve the static files -->
        <handlers>
            <clear/>
            <add name="StaticFile" path="*" verb="*" modules="StaticFileModule" resourceType="File" requireAccess="Read" />
        </handlers>
    </system.webServer>
</configuration>

至此部署基本完成。重启IIS，在浏览器里输入http://127.0.0.1，就能访问网站。

常见问题

1.如果访问IIS出现如下错误

出现这样的情况是因为IIS7之后的版本都采用了更安全的 web.config 管理机制，默认情况下会锁住配置项不允许更改。我们把它解锁了就OK。

打开CMD，在里面依次输入下面两个命令：

%windir%\system32\inetsrv\appcmd unlock config -section:system.webServer/handlers 

%windir%\system32\inetsrv\appcmd unlock config -section:system.webServer/modules

2.有时候访问页面，或者单独访问网站后台出现400错误

这个时候可能是因为没有给网站权限的原因。我们打开IIS，找到网站，右键，编辑权限，给IIS用户添加修改和写入权限。就能正常访问。

3.静态文件显示异常

在settings.py里添加STATIC_ROOT配置，指定收集静态文件路径，如：

STATIC_ROOT = os.path.join(BASE_DIR, 'static')

进入虚拟环境，输入以下命令进行收集静态文件：

python manage.py collectstatic

收集完成之后，刷新页面，显示正常。

至此，转载请注明出处。

码农公寓