Apache ProxyPass不支持直接使用$BACKEND_HOST等shell变量，但可通过PassEnv+env()表达式（运行时）、Define指令（编译期）或SetEnvIf+mod_rewrite（请求级）三种方式动态指定后端地址，需启用mod_proxy、mod_expr等对应模块并注意斜杠对齐与ProxyPassReverse配对。
Apache 的 ProxyPass 本身不支持直接写 $BACKEND_HOST 这类 shell 变量，但可以通过环境变量机制在运行时动态指定后端地址。关键不是“能不能用变量”，而是“怎么让 Apache 在转发时读到你想要的值”。
用 PassEnv + env() 表达式（推荐，运行时生效）
适用于需要在不同服务器上启动前就确定后端地址的场景，比如开发机连本地服务、生产环境连集群节点。
- 在 systemd service 文件中设置系统级环境变量（如
/etc/systemd/system/apache2.service.d/env.conf）：
Environment="BACKEND_URL=http://10.0.1.5:8080"
Environment="PROXY_ENABLED=1"
- 在 Apache 配置中导入并条件启用代理：
ProxyPass / http://env('BACKEND_URL')/
ProxyPassReverse / http://env('BACKEND_URL')/
</If>
- 必须确保已启用
mod_expr（2.4.13+ 默认开启），且mod_proxy和mod_proxy_http已加载
用 Define 指令（编译期注入，更稳定）
适合部署时就固定、不需要运行中修改的场景，比如区分 dev/staging/prod 环境配置。
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 启动 Apache 时传入定义：
apachectl -D BACKEND_HOST=prod-api.example.com -D ENABLE_PROXY - 配置中使用（注意：变量名不带
$，引用用${VAR}）：
ProxyPass / http://${BACKEND_HOST}/
ProxyPassReverse / http://${BACKEND_HOST}/
</IfDefine>
- 这种方式在配置加载阶段解析，性能略高，也避免了运行时环境变量污染风险
用 SetEnvIf + mod_rewrite 动态提取（按请求特征路由）
当你需要根据 Host、User-Agent 或请求路径等实时信息切换后端时适用，灵活性最强。
- 例如按子域名分发：
SetEnvIf Host "^api\.example\.com$" PROXY_TARGET="http://10.0.2.10:8080"
<If "env('PROXY_TARGET') != ''">
ProxyPass / ${PROXY_TARGET}/
ProxyPassReverse / ${PROXY_TARGET}/
</If>
- 注意：需确保
mod_setenvif和mod_expr均已启用 - 这种写法不依赖系统环境变量，完全由请求头驱动，适合灰度或 A/B 测试场景
注意事项和常见坑
无论用哪种方式，以下几点都直接影响是否能通：
-
模块必须启用：至少要有
mod_proxy、mod_proxy_http；若用 HTTPS 后端，还要mod_proxy_connect并加SSLProxyEngine on -
斜杠要对齐：比如
ProxyPass /api/ http://backend:8000/，前后都带尾部斜杠，否则路径拼接会出错 - 别忘了 ProxyPassReverse：后端返回 302 重定向时，Location 头里的地址是内部地址，必须靠它重写成对外地址
-
WebSocket 要单独处理：用
wss://或ws://协议时，ProxyPass 必须显式声明，不能混用http://
