执行docker-compose up apache后Apache未启动，无法访问https://localhost

环境信息 #

用户的docker-compose.yml配置：

version: '3.5'

services:
    ## Reverse proxy Apache pour avoir un contexte https ISO prod
    apache:
        image: xxx:2.4.52-alpine
        container_name: office-4e28-apache
        network_mode: "host"
        volumes:
            - ./images/apache/configs/httpd.conf:/usr/local/apache2/conf/httpd.conf
            - ./images/apache/configs/site.conf:/usr/local/apache2/conf/extra/site.conf
            - ./images/apache/configs/xxx.local.crt:/usr/local/apache2/ssl/xxx.local.crt
            - ./images/apache/configs/xxx.local.key:/usr/local/apache2/ssl/xxx.local.key

现象 #

• 执行docker-compose up apache后，本地443/80端口未被占用，sudo netstat -tulpn无对应端口监听记录
• 日志仅出现警告：

AH00558: httpd: Could not reliably determine the server's fully qualified domain name, using 172.17.0.2. Set the 'ServerName' directive globally to suppress this message

• 无法访问https://localhost

排查与解决方案 #

虽然ServerName警告不会导致服务启动失败，但端口未监听说明Apache未正确绑定端口或启动异常，按以下步骤排查：

1. 检查Apache监听配置 #

确认httpd.conf中存在正确的Listen指令，因为使用network_mode: host，需确保Apache监听所有网卡（而非容器内部IP）：

Listen 0.0.0.0:80
Listen 0.0.0.0:443 https

2. 验证VirtualHost配置 #

检查site.conf中的SSL虚拟主机配置，确保路径与挂载的证书文件一致，且绑定到正确端口：

<VirtualHost *:443>
    ServerName localhost
    SSLEngine on
    SSLCertificateFile /usr/local/apache2/ssl/xxx.local.crt
    SSLCertificateKeyFile /usr/local/apache2/ssl/xxx.local.key
    # 其他业务配置...
</VirtualHost>

3. 检查配置文件语法 #

进入容器执行配置校验，排查语法错误：

docker exec -it office-4e28-apache httpd -t

如果输出Syntax OK则配置语法正常，否则根据报错修复对应配置项。

4. 查看容器完整日志 #

获取容器全部日志，排查隐藏的启动错误（如证书加载失败、权限不足等）：

docker logs -f office-4e28-apache

5. 检查挂载文件权限 #

确保宿主机挂载的配置文件、证书文件在容器内可被Apache读取，可通过以下命令查看容器内文件权限：

docker exec -it office-4e28-apache ls -l /usr/local/apache2/conf/
docker exec -it office-4e28-apache ls -l /usr/local/apache2/ssl/

若权限不足，可调整宿主机文件权限，或在容器内执行chmod命令修改权限（需确保镜像支持相关命令）。

6. 消除ServerName警告（可选） #

虽然不影响服务运行，但可在httpd.conf中添加全局ServerName消除警告：

ServerName localhost

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