Docker中Apache无法读取环境变量MY_SERVER_NAME问题咨询

你遇到的核心问题是：Apache Web服务器本身不会自动解析配置文件中的shell环境变量。虽然你通过docker-compose正确设置了MY_SERVER_NAME环境变量，容器的shell能读取到它，但Apache启动时并不会去读取这些shell环境变量，也不会替换配置里的${MY_SERVER_NAME}占位符——它会把这个字符串当成Apache自己的配置变量名，而你并没有用Apache的Define指令定义过这个变量，所以就抛出了AH00111: Config variable ${MY_SERVER_NAME} is not defined错误。

要让Apache配置能使用docker-compose传入的环境变量，你需要在Apache启动前，先把配置文件里的占位符替换成实际的环境变量值，常用的工具是envsubst（大多数基于Debian/Ubuntu的Apache镜像已经预装了这个工具）。具体步骤如下：

1. 修改Apache配置为模板文件 #

把你的虚拟主机配置文件改写成模板，比如命名为000-default.conf.template，内容保持不变：

<VirtualHost *:80>
    ServerName ${MY_SERVER_NAME}
    # 其他配置...
</VirtualHost>

2. 在Dockerfile或docker-compose中添加替换逻辑 #

方式一：通过Dockerfile处理 #

在你的项目Dockerfile中，添加启动前的替换步骤，比如：

FROM apache:latest

# 复制模板文件到Apache配置目录
COPY 000-default.conf.template /etc/apache2/sites-available/

# 替换模板变量并启动Apache
CMD ["bash", "-c", "envsubst '${MY_SERVER_NAME}' < /etc/apache2/sites-available/000-default.conf.template > /etc/apache2/sites-available/000-default.conf && apache2-foreground"]

方式二：直接在docker-compose.yml中覆盖command #

如果不想修改Dockerfile，也可以在docker-compose的app服务里直接指定启动命令：

app:
    container_name: my_app
    build: .
    depends_on:
      - db
    ports:
      - "80:80"
    links:
      - db
    volumes:
      - ./:/app
    restart: always
    environment:
      - MY_SERVER_NAME=dev.mysite.local
    command: bash -c "envsubst '\${MY_SERVER_NAME}' < /etc/apache2/sites-available/000-default.conf.template > /etc/apache2/sites-available/000-default.conf && apache2-foreground"

注意：这里的\${MY_SERVER_NAME}需要转义，避免docker-compose提前解析这个变量。

3. 验证效果 #

重新构建并启动容器：

docker-compose up --build

此时Apache启动前会自动把模板里的${MY_SERVER_NAME}替换成docker-compose传入的dev.mysite.local，就能正常启动了。

你直接在Apache配置中写${MY_SERVER_NAME}的方式是不正确的，因为：

• Apache的配置变量是通过Define指令定义的（比如Define MY_SERVER_NAME dev.mysite.local），和shell环境变量是完全不同的两个体系。
• 只有当你用工具（比如envsubst）提前替换掉配置里的占位符，Apache才能识别正确的ServerName值。

内容的提问来源于stack exchange，提问作者caxton