### 在 Windows 系统上通过 Apache 部署 Django 项目 在 Windows 平台上使用 Apache 部署 Django 项目是一个常见的需求。以下是详细的配置过程，涵盖了从安装到部署的关键步骤。 --- #### 1. 安装 Apache 和 mod_wsgi 要使 Apache 能够运行 Python 应用程序，需要安装 `mod_wsgi` 模块。具体操作如下： - 下载适合当前系统的 `mod_wsgi` 版本（与使用的 Python 和 Apache 版本匹配）。可以从官方仓库下载预编译二进制文件[^3]。 - 将下载的 `.so` 或 `.pyd` 文件放置到 Apache 的模块目录中（如 `modules/`）。 - 使用以下命令验证 `mod_wsgi` 是否正确安装并获取必要的配置信息： ```bash mod_wsgi-express module-config ``` 此命令会输出类似于以下的内容，将其添加到 Apache 的主配置文件 `httpd.conf` 中[^3]： ```apache LoadFile "C:/Program Files/Python38/python38.dll" LoadModule wsgi_module "D:/path/to/mod_wsgi.cp38-win_amd64.pyd" WSGIPythonHome "D:/path/to/virtualenv" ``` --- #### 2. 修改 Apache 主配置文件 (`httpd.conf`) 编辑 Apache 的主配置文件 `httpd.conf`，确保包含以下内容： ##### （1）启用必要模块 确保以下模块未被注释掉： ```apache LoadModule rewrite_module modules/mod_rewrite.so LoadModule alias_module modules/mod_alias.so ``` ##### （2）定义 WSGI 脚本路径 为 Django 项目创建一个 WSGI 脚本入口，并在 `httpd.conf` 中指定其路径。假设项目的根目录为 `D:/myproject`，则可以这样写： ```apache WSGIScriptAlias / D:/myproject/myproject/wsgi.py process-group=myproject application-group=%{GLOBAL} <Directory D:/myproject/myproject> Require all granted </Directory> ``` 此处的 `process-group` 和 `application-group` 参数用于隔离不同应用之间的进程和线程[^1]。 ##### （3）静态文件处理 在生产环境中，不应依赖 Django 开发服务器来提供静态文件服务。因此，需让 Apache 处理这些请求。例如： ```apache Alias /static/ D:/myproject/static/ <Directory D:/myproject/static> Require all granted </Directory> Alias /media/ D:/myproject/media/ <Directory D:/myproject/media> Require all granted </Directory> ``` 注意：必须先运行 `python manage.py collectstatic` 命令将所有静态文件集中到 `STATIC_ROOT` 所指向的目录中[^2]。 --- #### 3. 设置 Django 项目 调整 Django 项目的配置以适应生产环境： ##### （1）修改 `settings.py` 确保以下参数已正确定义： ```python DEBUG = False ALLOWED_HOSTS = ['localhost', 'your-domain.com'] STATIC_URL = '/static/' STATIC_ROOT = os.path.join(BASE_DIR, 'static') # 收集静态文件的目标目录 MEDIA_URL = '/media/' MEDIA_ROOT = os.path.join(BASE_DIR, 'media') ``` ##### （2）数据库连接 如果使用 MySQL 数据库，请确保已安装 `mysqlclient` 或其他兼容驱动，并正确配置 `DATABASES` 字典[^2]。 --- #### 4. 启动 Apache 服务 完成上述配置后，启动 Apache 服务并测试是否能正常访问 Django 项目。如果遇到错误，可以通过查看日志文件定位问题。常见错误包括但不限于： - **语法错误**：检查 `httpd.conf` 文件是否有拼写或格式问题[^4]。 - **权限不足**：确保 Apache 对项目目录具有读取权限。 - **虚拟环境路径不正确**：确认 `WSGIPythonHome` 指向的是有效的虚拟环境路径。 --- #### 示例代码 以下是完整的 `httpd.conf` 配置片段示例： ```apache # 加载 mod_wsgi 模块 LoadFile "C:/Program Files/Python38/python38.dll" LoadModule wsgi_module "D:/path/to/mod_wsgi.cp38-win_amd64.pyd" # 定义 WSGI 脚本路径 WSGIScriptAlias / D:/myproject/myproject/wsgi.py process-group=myproject application-group=%{GLOBAL} <Directory D:/myproject/myproject> <Files wsgi.py> Require all granted </Files> </Directory> # 静态文件映射 Alias /static/ D:/myproject/static/ <Directory D:/myproject/static> Require all granted </Directory> Alias /media/ D:/myproject/media/ <Directory D:/myproject/media> Require all granted </Directory> ``` --- ###