### 在 Windows Server 2008 上部署 Django 项目的指南 #### 1. 环境准备 为了成功部署 Django 项目，需要先准备好必要的软件环境。以下是所需的组件及其作用： - **Python**: Django 运行的基础解释器。 - **Django**: Web 应用框架。 - **IIS (Internet Information Services)**: Microsoft 提供的 Web 服务器，在此环境中用于托管 Django 项目。 - **mod_wsgi**: 将 Python 和 IIS 集成的关键模块。 确保已安装这些工具并验证其版本兼容性[^1]。 --- #### 2. 配置 IIS 和 mod_wsgi 在 Windows Server 2008 中集成 Django 的核心在于正确配置 `mod_wsgi` 模块以及设置相关的环境变量。 ##### a. 安装 mod_wsgi 下载适合当前操作系统架构（32位或64位）和 Python 版本的 `mod_wsgi` DLL 文件，并将其放置到指定路径中。例如： ```plaintext LoadFile "C:/Python36/python36.dll" LoadModule wsgi_module "C:/Python36/Lib/site-packages/mod_wsgi/server/mod_wsgi.cp36-win_amd64.pyd" ``` 随后，在 IIS 的 `httpd.conf` 或其他相关配置文件中加载该模块[^3]。 --- #### 3. 设置 Django 项目参数 为了让 IIS 能够识别并运行 Django 项目，需定义以下几个关键环境变量： - **WSGI_HANDLER** - 值应设为 `django.core.wsgi.get_wsgi_application()`，这是推荐的标准写法[^1]。 - **PYTHONPATH** - 设定为 Django 项目的根目录路径，例如： `<add key="PYTHONPATH" value="E:\pythonproject\djangoProject\" />`[^4] - **DJANGO_SETTINGS_MODULE** - 指向 Django 项目的 settings 文件位置，通常形式如下： `<add key="DJANGO_SETTINGS_MODULE" value="djangoProject.settings" />`[^4] 以上配置可通过修改 IIS 的应用程序池高级设置或者直接编辑 `.config` 文件完成。 --- #### 4. 启动应用 当所有前置条件满足后，可以通过以下方式测试 Django 是否正常工作： - 如果使用的是 Waitress 或 Daphne 等 ASGI/Django 兼容服务器，则可执行类似下面的命令来手动启动服务： ```bash waitress-serve --port=8000 myproject.wsgi:application ``` 或者对于更复杂的场景采用： ```bash daphne -b 127.0.0.1 -p 8001 myproject.asgi:application ``` 注意替换其中的 `myproject` 为你实际的项目名[^2]。 另外也可以通过浏览器访问站点 URL 来检验页面是否能够正确显示。 --- #### 5. 故障排查 如果遇到任何错误消息，请按照下列建议逐步解决： - 检查日志记录是否有异常提示； - 确认所有的依赖库均已正确安装且无冲突； - 参考官方文档或其他社区资源获取更多帮助信息。 --- ### 示例代码片段 以下是典型的 WSGI 配置文件 (`wsgi.py`) 内容展示： ```python import os from django.core.wsgi import get_wsgi_application os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'djangoProject.settings') application = get_wsgi_application() ``` 同时附带一段简单的 Apache HTTP Server vhost 配置样例： ```apacheconf <VirtualHost *:80> ServerName www.example.com WSGIDaemonProcess example python-path=E:/pythonproject/djangoProject/ WSGIProcessGroup example WSGIScriptAlias / E:/pythonproject/djangoProject/wsgi.py <Directory E:/pythonproject/djangoProject/> Require all granted </Directory> </VirtualHost> ``` ---