解决Laravel容器内创建文件无法在主机编辑的权限问题

核心原因 #

容器内www-data用户的UID/GID和主机当前用户不匹配，导致主机用户没有权限编辑容器创建的文件。

具体解决方法 #

方法一：构建镜像时指定和主机匹配的UID/GID #

修改Dockerfile，在构建时动态调整www-data的UID和GID，和主机当前用户保持一致：

FROM php:8.1-fpm-alpine

# 定义构建参数，用于传入主机用户的UID/GID
ARG USER_ID
ARG GROUP_ID

RUN docker-php-ext-install  pdo pdo_mysql exif
RUN apk add --no-cache pcre-dev $PHPIZE_DEPS \
        && pecl install redis \
        && docker-php-ext-enable redis.so

RUN curl -s https://getcomposer.org/installer | php -- --install-dir=/usr/bin/ --filename=composer
RUN alias composer='php /usr/bin/composer'

# 删除默认www-data用户，重新创建匹配主机UID/GID的用户
RUN if [ ${USER_ID:-0} -ne 0 ] && [ ${GROUP_ID:-0} -ne 0 ]; then \
    deluser www-data && \
    addgroup -g ${GROUP_ID} www-data && \
    adduser -u ${USER_ID} -D -G www-data www-data; \
fi

# 设置目录所有权
RUN chown -R www-data:www-data /var/www

修改docker-compose.yml，构建时传入主机用户的UID/GID：

services:
  php:
    build:
      context: ./dockerfiles
      dockerfile: php8.1.Dockerfile
      args:
        USER_ID: ${USER_ID:-1000}
        GROUP_ID: ${GROUP_ID:-1000}
    container_name: "php"
    restart: unless-stopped
    tty: true
    networks:
      - medyar_network
    volumes:
      - .:/var/www/html
    ports:
      - "${MEDYAR_PHP_PORT}:9000"

在主机终端执行构建命令，自动传入当前用户的UID/GID：

USER_ID=$(id -u) GROUP_ID=$(id -g) docker-compose build php

方法二：启动容器时直接指定运行用户 #

无需修改Dockerfile，直接在docker-compose.yml中指定容器运行的用户为当前主机用户的UID/GID：

services:
  php:
    build:
      context: ./dockerfiles
      dockerfile: php8.1.Dockerfile
    container_name: "php"
    restart: unless-stopped
    tty: true
    user: "${USER_ID:-1000}:${GROUP_ID:-1000}" # 添加此行指定用户
    networks:
      - medyar_network
    volumes:
      - .:/var/www/html
    ports:
      - "${MEDYAR_PHP_PORT}:9000"

启动容器前执行命令传入参数：

USER_ID=$(id -u) GROUP_ID=$(id -g) docker-compose up -d

方法三：手动修复现有文件权限 #

如果主机上已经存在大量容器创建的无权限文件，先手动修改所有权：

sudo chown -R $(id -u):$(id -g) ./

再结合上面两种方法之一，避免后续新创建的文件再次出现权限问题。

注意事项 #

• 普通主机用户的UID/GID一般为1000:1000，若不确定可执行id -u和id -g查看当前用户的对应值。
• Laravel的storage、bootstrap/cache等目录需要读写权限，上述方法已确保容器内www-data用户拥有对应权限。

内容的提问来源于stack exchange，提问作者M a m a D