使用官方php:apache镜像直接运行容器无法访问挂载目录文件问题

问题排查及解决方案 #

1. SELinux安全策略拦截（Linux环境高发） #

Linux系统默认开启的SELinux安全机制会禁止容器内进程访问未标记对应安全上下文的宿主机目录，这是权限显示正常但无法读取文件的最常见原因。
解决方法：启动容器时给挂载参数添加:z后缀，自动适配SELinux权限规则：

docker run -d -p 8081:80 --name test -v "$PWD":/var/www/html:z php:apache

2. 运行用户权限不足 #

官方php:apache镜像中的Apache服务默认以www-data用户（UID 33、GID 33）身份运行，你挂载的本地文件所有者为root，需要确保www-data用户有读取权限，同时目录需要有执行权限才能进入访问。
解决步骤：

• 临时测试可以直接给目录开放读取权限：

chmod -R a+r $PWD
find $PWD -type d -exec chmod a+x {} \;

• 生产环境建议直接将本地文件所有者修改为和容器内一致的UID，安全性更高：

sudo chown -R 33:33 $PWD

3. 宿主机目录权限受限 #

如果你的项目存放在/root、/home/个人用户名这类默认仅所有者可访问的私有目录下，容器进程无法穿透上层目录权限读取内部文件。
解决方法：将项目移动到/srv、/opt这类公共目录后重新启动容器挂载即可。

验证步骤 #

修改配置后可以先进入容器用Apache运行用户测试文件读取权限，确认问题解决：

docker exec -it test su - www-data -s /bin/bash -c "cat /var/www/html/index.html"

如果以上操作都无效，可以执行docker logs test查看Apache运行日志，定位具体报错原因。

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