Listen 指令不支持环境变量动态替换，因其在服务器启动初期静态解析，早于环境变量加载，故 ${APACHE_PORT} 等写法会报错；可行方案包括启动前用脚本生成配置、符号链接切换预置端口文件、Docker 中用 envsubst 替换模板，或结合 Define 在 VirtualHost 内复用端口值（但 Listen 仍需手动写死）。
Apache 的 Listen 指令**不支持环境变量动态替换**，它在服务器启动时静态解析，且 Apache 主配置阶段（包括 httpd.conf）无法读取运行时环境变量（如 envvars 或 shell 导出的变量）来生成端口号。
为什么 Listen 不能用环境变量
Listen 是 Apache 核心指令，属于“server config”上下文，执行早于模块初始化和环境变量加载。即使你通过 envvars 文件导出 APACHE_PORT=8080，在 Listen ${APACHE_PORT} 这类写法中，Apache 会直接报错：Syntax error on line X of httpd.conf: Invalid port number '${APACHE_PORT}' —— 因为变量未展开，且该语法本身不被支持。
可行的替代方案
若需“动态端口”，本质是**启动前注入配置**，而非运行时动态变更。以下是实际可用的几种方式：
-
使用外部脚本生成配置文件：写一个 shell 脚本（如
gen-vhost.sh），读取环境变量（如$PORT_A），用sed或cat <<EOF模板生成/etc/apache2/ports.conf和对应sites-available/*.conf，再启动 Apache。这是 Docker 容器中最常用的做法。 -
利用 a2enmod + 配置片段 + 符号链接：预置多套端口配置（如
ports-8080.conf、ports-9000.conf），通过软链/etc/apache2/ports.conf → /etc/apache2/ports-8080.conf切换，并配合systemctl set-environment PORT=8080在服务单元中控制，重启时生效。 -
Docker 中用 envsubst：在容器启动命令中先执行
envsubst < /tmp/httpd-ports.tmpl > /etc/apache2/ports.conf，模板里写Listen ${PORT}，再apache2ctl -D FOREGROUND。前提是镜像已安装gettext-base（含envsubst）。
VirtualHost 块内也不能靠环境变量改端口
<VirtualHost *:${PORT}> 同样非法。每个 <VirtualHost> 必须明确写出 IP:PORT 组合（如 *:8080），否则解析失败。ServerName 和 DocumentRoot 等字段虽支持 ${VAR}（需启用 mod_macro 或用 Define），但监听端口本身不行。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
更推荐的轻量级做法：Define + 多配置文件
在主配置中用 Define 声明端口，再在 <VirtualHost> 中引用（仅限 VirtualHost 内部字段，不适用于 Listen）：
Define SITE_PORT 8080<VirtualHost *:${SITE_PORT}> ServerName app.local DocumentRoot "/var/www/app"</VirtualHost>
注意：这仍要求你在 ports.conf 中**手动写死** Listen 8080，Define 只解决 VirtualHost 内部复用，不替代 Listen 的静态声明。
