Apache 中 Python 部署怎么配置环境变量管理不同环境的配置-Apache-PHP中文网

apache本身不直接管理python应用环境变量，真正需在python进程启动前注入变量，并按环境隔离配置：①mod_wsgi用setenv指令设置；②uwsgi/gunicorn通过systemd的environmentfile加载；③统一推荐python-dotenv配合.env.dev/.test/.prod多文件及environment变量动态加载。

apache 中 python 部署怎么配置环境变量管理不同环境的配置

Apache 本身不直接管理 Python 应用的环境变量（比如 DEBUG=True 或 DATABASE_URL），它只是 Web 服务器，负责接收 HTTP 请求并转发给 Python 应用（如通过 mod_wsgi、uWSGI 或 Gunicorn）。真正需要环境变量的是你的 Python 应用进程。因此，“Apache 中 Python 部署的环境变量管理”，本质是：如何在 Apache 启动 Python 应用时，安全、可靠、按环境加载对应的配置。

核心原则是：环境变量应在 Python 进程启动前注入，且不同环境（dev/test/prod）使用不同值，不能硬编码，也不能混用。

下面分三类常见部署方式说明，重点讲清 怎么配环境变量 和 怎么隔离多环境：

Apache + mod_wsgi 方式（推荐用于简单/传统部署）

mod_wsgi 支持在 Apache 配置中直接设置环境变量，这是最贴近“Apache 管理”的方式。

在 Apache 的虚拟主机或 WSGI 配置段中（如 /etc/apache2/sites-available/myapp.conf），使用 SetEnv 指令：

<virtualhost>
    ServerName myapp.dev

    # 指定项目根目录（.env 文件所在位置）
    WSGIDaemonProcess myapp python-path=/var/www/myapp
    WSGIProcessGroup myapp
    WSGIScriptAlias / /var/www/myapp/wsgi.py

    # 关键：为该站点注入环境变量（对应开发环境）
    SetEnv ENVIRONMENT "development"
    SetEnv DATABASE_URL "sqlite:///dev.db"
    SetEnv DEBUG "True"
    SetEnv LOG_LEVEL "DEBUG"

    <directory>
        Require all granted
    </directory></virtualhost>

然后在 Python 的 wsgi.py 或入口文件顶部，优先加载 python-dotenv 并根据 ENVIRONMENT 自动选文件：

python-parallelization

将顺序 Python 代码转换为并行/并发实现，用于在需要并行化 Python 代码、提升性能时使用。

下载

import os
from dotenv import load_dotenv

# 根据 Apache 设置的 ENVIRONMENT 变量决定加载哪个 .env 文件
env_name = os.environ.get("ENVIRONMENT", "production")
dotenv_path = f".env.{env_name}"
load_dotenv(dotenv_path)  # 加载 .env.development 等

# 后续代码正常读取 os.getenv("DATABASE_URL") 即可

✅ 优点：配置集中、无需改系统级变量、重启 Apache 即生效
⚠️ 注意：SetEnv 只对 mod_wsgi 子进程生效，不作用于 shell 或 cron；敏感值（如密码）不建议明写在 Apache 配置里（应改用外部文件或系统级变量）

Apache + uWSGI/Gunicorn（反向代理模式，更现代）

这时 Apache 充当反向代理，Python 应用由 uWSGI 或 Gunicorn 独立管理。环境变量需在 应用服务启动时注入，而非 Apache 配置中。

以 systemd 管理 Gunicorn 为例（推荐）：

创建服务文件 /etc/systemd/system/myapp-prod.service：

[Unit]
Description=Gunicorn instance for myapp (production)
After=network.target

[Service]
Type=notify
User=www-data
Group=www-data
WorkingDirectory=/var/www/myapp
EnvironmentFile=/etc/myapp/env.prod  # ← 关键：指向环境变量文件
ExecStart=/var/www/myapp/venv/bin/gunicorn --bind unix:/run/myapp.sock --workers 3 wsgi:app

[Install]
WantedBy=multi-user.target

创建 /etc/myapp/env.prod（权限设为 640，属主 root:www-data）：

DATABASE_URL=mysql+pymysql://prod_user:ProdPass123@prod-db/prod_db
DEBUG=False
LOG_LEVEL=WARNING
SECRET_KEY=your-actual-prod-secret-key

启动服务：

sudo systemctl daemon-reload
sudo systemctl start myapp-prod

✅ 优点：环境变量与 Apache 解耦，便于审计和权限控制；.env.* 文件可统一由 python-dotenv 加载（只需 load_dotenv("/etc/myapp/env.prod")）
⚠️ 注意：EnvironmentFile 路径必须绝对，且文件不可被非授权用户读取；生产环境禁止用 .env 文件放在项目目录下（易被 Web 访问）

统一推荐：python-dotenv + 多环境文件 + 启动时指定

无论用哪种部署方式，都建议采用标准的 python-dotenv 多环境结构：

项目根目录下放 .env.dev、.env.test、.env.prod
.gitignore 包含 .env*（防止误提交）
启动命令或服务配置中显式指定加载哪个：

# 开发时本地运行
ENVIRONMENT=development python main.py

# 生产部署（Gunicorn 示例）
gunicorn --env ENVIRONMENT=production wsgi:app

# 在代码中统一处理
import os
from dotenv import load_dotenv

env_file = f".env.{os.environ.get('ENVIRONMENT', 'production')}"
load_dotenv(env_file)

这样，Apache 不用管具体值，只负责把 ENVIRONMENT 传下去；Python 应用自己加载对应 .env.*，逻辑清晰、可测试、易维护。

环境变量管理不是 Apache 的功能延伸，而是整个部署链路的设计问题。关键不在“Apache 怎么配”，而在于“谁启动 Python 进程、何时注入变量、是否隔离”。用好 SetEnv、EnvironmentFile 或启动参数，再配合 python-dotenv 的文件加载能力，就能干净利落地支撑开发、测试、生产三套配置。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！