ProxySourceAddress仅在Apache 2.4.37+支持，须置于<Proxy>块内，绑定本机已配置IPv4地址，优先级高于ProxyPass的sourceaddress参数，不适用于UDP或WebSocket代理。
在多网卡环境下，Apache 默认可能使用系统路由表选中的主出口 IP 发起代理连接，但后端服务若做了源 IP 白名单校验，或需区分流量归属（如对接不同区域 API），就必须显式指定某块网卡的 IP 作为代理出口。ProxySourceAddress 就是为此设计的指令，但它有明确的使用前提和配置边界。
确认 Apache 版本与模块支持
ProxySourceAddress 仅在 Apache 2.4.37 及以上版本可用。低于此版本（例如 CentOS 7 自带的 2.4.6）会报错 Invalid command 'ProxySourceAddress'。
- 运行
httpd -v或apache2ctl -v查看版本 - 执行
httpd -M | grep -E 'proxy|http'确保proxy_module已加载（proxy_http_module非必需，但 HTTP 代理通常需要） - 若模块未启用，需在配置中补上：
LoadModule proxy_module modules/mod_proxy.so
绑定本机已配置的 IP 地址
ProxySourceAddress 后填写的 IP 必须是当前服务器上真实存在且已启用的 IPv4 地址（可通过 ip addr show 验证）。不能填未绑定的地址，否则 Apache 启动失败，报错 Cannot assign requested address。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 例如服务器有两块网卡：
eth0 → 192.168.10.5/24
eth1 → 10.20.30.100/24 - 若希望代理请求从 eth1 出去，就只能填
10.20.30.100，不能填10.20.30.101（即使在同一子网） - 不支持主机名、别名或通配符（如
10.20.30.*），只接受具体 IPv4 地址
正确放置指令位置
ProxySourceAddress 不是全局指令，也不能写在 .htaccess 或主配置顶层。它必须嵌套在 <Proxy> 容器内，且该容器需位于 <VirtualHost> 或配置段中。
- ✅ 正确示例：
<VirtualHost *:80>
ServerName api-prod.example.com
<Proxy *>
ProxySourceAddress 10.20.30.100
Require all granted
</Proxy>
ProxyPass / http://backend.internal:8080/
ProxyPassReverse / http://backend.internal:8080/
</VirtualHost>
- ❌ 常见错误：
直接写在 httpd.conf 最外层；
放在<Directory>或<Location>中；
混在 ProxyPass 行末用空格分隔（那是 sourceaddress= 参数的写法）
与 sourceaddress= 参数的区别和优先级
如果你已在 ProxyPass 行里用了 sourceaddress=192.168.10.5，又加了 ProxySourceAddress，后者会生效——它的作用范围更广、优先级更高。
-
sourceaddress=是 ProxyPass 的行内参数，只影响这一条规则 -
ProxySourceAddress作用于整个<Proxy>块，对块内所有匹配的代理路径都生效 - 两者同时存在时，ProxySourceAddress 覆盖 sourceaddress=
- 注意：UDP 代理（如 DNS）、WebSocket（mod_proxy_wstunnel）不支持该指令
