nginx 不支持直接通过环境变量控制正向代理开关，但可通过环境变量+shell脚本+软链接动态启用/禁用独立配置文件（如forward-proxy.conf），再执行nginx -t校验和systemctl reload nginx实现一键启停。
Nginx 本身不直接读取环境变量来控制正向代理的“开启/关闭开关”，它没有内置的 ENABLE_FORWARD_PROXY=on/off 这类运行时环境变量机制。但你可以通过结合 Linux 环境变量 + Shell 脚本 + Nginx 配置动态加载，实现“一键启停正向代理”的效果——关键在于：用环境变量控制配置是否生效，再配合 nginx -s reload 触发切换。
下面分三步讲清楚怎么做：
✅ 1. 把正向代理配置做成可开关的独立文件
不要硬编码在 nginx.conf 主配置里，而是单独建一个 forward-proxy.conf，放在 /etc/nginx/conf.d/ 下（默认会被 include）：
# /etc/nginx/conf.d/forward-proxy.conf
# 此文件仅在环境变量 FORWARD_PROXY_ENABLED=1 时才被启用（见后续脚本）
server {
listen 8118;
client_max_body_size 0;
# 必须启用 CONNECT 方法支持 HTTPS
proxy_connect;
proxy_connect_allow 443 80;
proxy_connect_timeout 60s;
proxy_connect_connect_timeout 60s;
proxy_connect_read_timeout 60s;
proxy_connect_send_timeout 60s;
resolver 114.114.114.114 valid=60s;
location / {
if ($request_method !~ ^(GET|HEAD|POST|PUT|DELETE|CONNECT)$) {
return 405;
}
proxy_pass $scheme://$http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_http_version 1.1;
proxy_set_header Connection "";
}
}
⚠️ 注意：这个配置默认是“静态存在”的，真正开关靠下一步——用脚本决定是否软链接它。
✅ 2. 用环境变量控制配置文件是否生效
Linux 中常用做法是：
- 用
FORWARD_PROXY_ENABLED=1表示启用正向代理 - 用软链接（symlink）决定
forward-proxy.conf是否被 Nginx 加载
写两个 Shell 脚本（建议存为 /usr/local/bin/nginx-proxy-on 和 /usr/local/bin/nginx-proxy-off）：
启用脚本 /usr/local/bin/nginx-proxy-on：
#!/bin/bash export FORWARD_PROXY_ENABLED=1 ln -sf /etc/nginx/conf.d/forward-proxy.conf /etc/nginx/conf.d/00-forward-proxy.conf nginx -t && systemctl reload nginx && echo "✅ 正向代理已启用（端口 8118）"
禁用脚本 /usr/local/bin/nginx-proxy-off：
PyCharm 2026.2.0.1 Linux版提供 JetBrains 官方 2026.2.0.1 版本安装包，适合需要指定 PyCharm 版本进行 Python 项目开发、运行和调试的用户。
#!/bin/bash export FORWARD_PROXY_ENABLED=0 rm -f /etc/nginx/conf.d/00-forward-proxy.conf nginx -t && systemctl reload nginx && echo "✅ 正向代理已禁用"
然后赋予执行权限：
sudo chmod +x /usr/local/bin/nginx-proxy-on /usr/local/bin/nginx-proxy-off
✅ 原理：Nginx 按字母顺序加载
conf.d/下的.conf文件。加前缀00-确保它优先被读；删掉软链接 = 配置不加载 = 代理服务彻底消失（不是注释或 if 判断，更干净可靠）。
✅ 3. 终端一键调用（支持环境变量感知与提示）
你还可以写一个统一入口脚本 /usr/local/bin/nginx-proxy-toggle：
#!/bin/bash
if [ "${FORWARD_PROXY_ENABLED:-0}" = "1" ]; then
/usr/local/bin/nginx-proxy-off
else
/usr/local/bin/nginx-proxy-on
fi
然后在终端直接运行：
# 启用（自动检测当前状态并切换） FORWARD_PROXY_ENABLED=1 nginx-proxy-toggle # 或直接调用 nginx-proxy-on nginx-proxy-off # 查看当前状态（检查软链接是否存在） ls -l /etc/nginx/conf.d/00-forward-proxy.conf 2>/dev/null || echo "❌ 未启用"
? 小技巧：把
export FORWARD_PROXY_ENABLED=1加到~/.bashrc里，就能让终端默认记住偏好（非必需，纯便利）。
不复杂但容易忽略：
-
nginx -t一定要放在 reload 前，避免配置错误导致服务中断 -
systemctl reload nginx比kill -HUP更规范，且兼容 systemd 环境 - 不要用
if ($env_FORWARDED == "on") { ... }这类 Nginx 内部变量判断——Nginx 的map或if无法控制 server 块加载，只能控制内部逻辑，不够安全
这样就实现了真正意义上的“环境变量驱动、一键启停、零手动改配置”。
