php:apache容器中autoindex模块失效，如何开启目录列表？

问题概述 #

我用Docker搭建了基于php:apache的容器，用来运行和测试各类PHP文件，但访问没有index.*文件的路径时出现403禁止访问错误，无法查看目录列表。已经尝试过加载autoindex模块、配置httpd.conf的Directory指令、修改docker-compose.yml的command等操作，问题仍未解决。

已排查信息 #

• 访问http://localhost:8000/返回403错误，容器日志提示无法确定服务器域名
• 已获取docker-compose.yml、httpd.conf等配置文件内容
• 已导出phpinfo返回的环境信息
• 已执行容器内ls、apachectl -M等命令并获取结果

环境 #

Windows 11 Home 22H2、Docker 4.19.0

针对性解决步骤 #

1. 修复服务器域名识别问题 #

容器日志的"无法确定服务器域名"提示会导致Apache配置加载异常，需明确设置ServerName：

• 若挂载自定义httpd.conf，在文件中添加：

  ServerName localhost:80
  

• 若使用默认配置，可在docker-compose.yml的command中追加设置：

  command: >
    bash -c "echo 'ServerName localhost:80' >> /etc/apache2/apache2.conf && apache2-foreground"
  

2. 确保autoindex模块生效并配置目录索引 #

• 先确认模块加载状态：进入容器执行apachectl -M，检查是否存在autoindex_module (shared)。未加载则执行：

  a2enmod autoindex
  

• 在Apache配置文件中给网站根目录开启索引权限：

  <Directory "/var/www/html">
      Options Indexes FollowSymLinks
      AllowOverride None
      Require all granted
  </Directory>
  

  注：若挂载了自定义本地目录，需将/var/www/html替换为容器内对应的挂载路径。

3. 修正目录/文件权限 #

确保Apache进程（www-data用户）拥有网站目录的可读权限：

chown -R www-data:www-data /var/www/html
chmod -R 755 /var/www/html

可将上述命令加入docker-compose.yml的command，或在自定义Dockerfile中提前配置。

4. 验证Docker配置正确性 #

确认docker-compose.yml的端口映射和目录挂载无误（Windows环境建议使用WSL2后端以避免权限兼容问题）：

services:
  php-apache:
    image: php:apache
    ports:
      - "8000:80"
    volumes:
      - ./src:/var/www/html
    command: >
      bash -c "echo 'ServerName localhost:80' >> /etc/apache2/apache2.conf && a2enmod autoindex && apache2-foreground"

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