在IIS上部署Django项目

bigcarp

已于 2024-10-16 11:08:15 修改

阅读量2.8k

点赞数 2

CC 4.0 BY-SA版权

分类专栏：编程文章标签： django python 后端

于 2021-10-29 13:36:34 首次发布

本文链接：https://blog.youkuaiyun.com/bigcarp/article/details/121001351

编程专栏收录该内容

92 篇文章

订阅专栏

本文详细介绍如何在Windows Server的IIS上部署Django项目，包括创建虚拟环境、安装依赖、配置FastCGI、设置静态文件等内容，并提供了解决常见问题的方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

参考：Windows server iis部署Django详细操作！

安装python
venv 为网站程序创建虚拟环境 (c:\www >python -m venv venv)
activate虚拟环境（c:\www >venv\scripts\activate），在虚拟环境下 pip install -r requirements.txt (来自pip freeze > requirements.txt)
创建网站文件夹，上传网页文件
初始化数据库（python manage.py migrate 及数据迁移）
在虚拟环境中进入网站目录，manage.py runserver看看能否运行正常
安装wfastcgi (pip install wfastcgi) (每个虚拟环境都应该独立安装wfastcgi。你可以多个站点公用一个虚拟环境，但每个虚拟环境都应该独立安装wfastcgi，wfastcgi-enable实际上是配置python解释器的路径。)
安装IIS（务必勾选CGI：select server roles > Roles > Web Server(IIS) > Web Server > Application Development > CGI）
IIS上创建网站
设置FastCGI （从运行中的项目中拷贝一个web.config出来，在其基础上改即可，就省去iis界面配置了）
设置静态文件
设置settings.py (DEBUG=False、DATABASES) 关闭urls.py中的静态文件转发

======================

web.config需要设置的三个配置项目：

IIS 500 – 内部服务器错误解决方案

解决方法：打开IIS，在功能视图中找到“错误页”，双击进去后，看最右边的“操作”下的“编辑功能设置…”，将“错误响应”下的“详细错误”勾上。

Q1、需要在服务器上创建python的虚拟环境吗？

A：不是必须，但一般建议每个网站一个独立的虚拟环境。不使用虚拟环境，直接用python安装目录的主环境也可以。多个网站共用一个虚拟环境也可以。

Q2、在网站物理路径（例如:c:\interpub\www\site001\）上创建虚拟环境吗？

A：可以，但不建议这样做，有安全隐患。你可以在D盘上创建python虚拟环境，在E盘上创建网站目录也没有问题。在IIS设置【cgi模块映射】时，指定可执行文件路径为python虚拟环境的python.exe即可。

Q3、网站的文件放在虚拟环境目录还是放在网站目录？

A：放在网站目录下。

wfastcgi 相关设置 参看这里，很详细：https://blog.youkuaiyun.com/bigcarp/article/details/121028820

1、在虚拟环境中pip install wfastcgi

2、wfastcgi-enable

3、设置web.config中的<handlers> </handlers>

4、在IIS界面中，设置网站应用程序池的标识设置为“LocalSystem”（目的是提py脚本的系统权限）

5、

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

默认情况下，某些 IIS 配置节可能是锁定的，这意味着它们只能在全局 applicationHost.config 文件中配置，而不能在站点级别的 web.config 文件中进行覆盖。当你运行这个解锁命令后，system.webServer/handlers 配置节可以在站点级别（即每个站点的 web.config 文件中）进行自定义和修改。--->如果整个IIS全部网站都支持python，可以直接设置全局的，这样就不需要每个站点的web.config都单独设置了，也就不需要解锁这两个配置节了。

若python是安装在C:\Users\username\AppData 中，（ C:\Users\Administrator\AppData\Local\Programs\Python\Python38\python.exe）建议不要使用全局环境的wfastcgi，我自己测试发现web.config的<handlers> </handlers>中，填写全局的wfastcgi 会报wfastcgi出错，但改为虚拟环境的就可以。

web.config:

以下设置报错：
scriptProcessor="C:\Users\Administrator\AppData\Local\Programs\Python\Python38\python.exe|C:\Users\Administrator\AppData\Local\Programs\Python\Python38\lib\site-packages\wfastcgi.py"

-------------------
改为以下设置就好了：
scriptProcessor="c:\www\venv\scripts\python.exe|c:\www\venv\lib\site-packages\wfastcgi.py"


原因不知道

静态目录设置：

django的静态文件放在专门的目录

python manage.py collectstatic 命令把静态文件都收集到一起

python manage.py runserver 用的是 collectstatic收集的文件，单IIS、ngix等则不采用这个规则，需要通过web.config之类进行配置。

https://blog.youkuaiyun.com/weixin_36296538/article/details/83153070

1、设置可以直接访问资源。

2、设置无需python解释。

网站根目录配置了cgi映射wfastcgi 后， IIS把所有请求都交给wfastcgi，对于静态文件，不需要交给wfastcgi，所以静态文件放在指定的文件夹，并在文件夹下创建web.config 配置成可以访问。

静态文件目录下的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>