dunglas/symfony-docker容器与宿主机文件权限问题求助

问题梳理 #

• 启动dunglas/symfony-docker容器后，宿主机项目文件属root用户，无法在本地IDE编辑
• 添加user: 1000:1000到docker-compose配置后，容器启动报错无法创建/srv/app/var/cache/dev目录
• 执行sudo chmod 777 var无效，官方chown命令仅临时生效，composer操作后vendor权限仍异常，且git报可疑所有权错误

解决方案 #

1. 构建镜像时创建匹配宿主机UID/GID的用户（推荐） #

直接在docker-compose指定用户会因容器内无对应用户导致权限问题，需修改PHP服务的Dockerfile，预先创建与宿主机一致的用户：

步骤：

1. 打开项目的php/Dockerfile，在文件末尾添加：

ARG UID=1000
ARG GID=1000

# 创建匹配宿主机的用户
RUN groupadd -g ${GID} appuser && useradd -u ${UID} -g ${GID} -m appuser

# 给项目目录授权
RUN chown -R appuser:appuser /srv/app
USER appuser

2. 修改docker-compose.yml的php服务配置，传递UID/GID参数：

services:
  php:
    build:
      context: ./php
      args:
        UID: ${UID:-1000}
        GID: ${GID:-1000}
    # 保留原有的其他配置，移除之前手动加的user行

3. 重新构建并启动容器：

docker compose build --pull --no-cache
docker compose up -d

这样容器内运行的用户与宿主机UID/GID完全匹配，后续生成的文件（包括vendor、var目录）权限会自动对齐，IDE可正常编辑。

2. 修复Git可疑所有权错误 #

若已调整用户配置但仍遇Git报错，需在容器内配置Git忽略目录所有权检查：

执行以下命令：

docker compose exec php git config --global --add safe.directory '*'

或者将该配置加入Dockerfile，避免每次启动容器重复执行：

# 在Dockerfile中添加
RUN git config --global --add safe.directory '*'

3. 临时修复方案（无需修改镜像） #

若不想修改Dockerfile，可按以下步骤操作：

1. 先以root用户启动容器（不添加user:1000:1000配置）：

docker compose up -d

2. 修正项目目录权限：

docker compose run --rm php chown -R $(id -u):$(id -g) .

3. 修改docker-compose.yml添加用户配置：

services:
  php:
    user: 1000:1000

4. 重启容器并配置Git安全目录：

docker compose restart php
docker compose exec php git config --global --add safe.directory /srv/app/vendor

关键原因说明 #

• 直接添加user:1000:1000时，容器内未预先创建该用户，且/srv/app/var等目录所有权仍为root，导致无法创建缓存文件
• chmod 777 var仅开放权限未修正所有权，容器内非root用户仍无法写入
• Composer操作生成的文件权限由容器内运行用户决定，必须确保容器用户与宿主机UID/GID一致才能避免权限冲突

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