如何为系统用户配置正确权限以在Docker容器中运行Laravel项目命令

跨环境权限差异原因 #

macOS 运行的 Docker Desktop 依赖虚拟机实现容器功能，自带的文件共享层会自动处理宿主机与容器的 UID/GID 映射，bind 挂载到容器内的目录会被默认适配为容器内 www-data 用户所有，因此不会出现权限问题。
而 Ubuntu 是原生 Linux 内核运行 Docker，bind 挂载的目录会完全继承宿主机对应目录的 UID 和 GID，你在容器内看到的 998/997 就是宿主机上项目目录所有者的 UID/GID，和容器内新建的 novruz 用户默认 UID/GID、容器内置 www-data 用户的 UID/GID（默认33）都不匹配，因此 novruz 用户对挂载的 /var/www 目录没有写入权限，无法创建 vendor 目录。

解决方案 #

方案1：构建时传入宿主机UID/GID对齐权限（最推荐，跨环境通用） #

该方案不需要修改宿主机权限，所有环境都可以通用：

1. 修改 Dockerfile，新增 UID、GID 构建参数，创建用户时指定对应ID：

FROM php:8.0-fpm

ARG USER
ARG UID
ARG GID

RUN apt-get update && apt-get install -y --no-install-recommends \
        curl \
        git \
        zip \
        unzip \
        libpng-dev \
        libonig-dev \
        libxml2-dev \
        libzip-dev \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*

RUN docker-php-ext-install bcmath

COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

# 创建用户时指定UID和GID，和宿主机对齐
RUN groupadd -g ${GID} ${USER} \
    && useradd -u ${UID} -g ${GID} -G www-data,root -d /home/${USER} ${USER}
RUN mkdir -p /home/${USER}/.composer \
    && chown -R ${USER}:${USER} /home/${USER}

WORKDIR /var/www

USER ${USER}

2. 修改 docker-compose.yml 中 app 服务的构建参数，动态读取环境变量传入UID/GID：

version: "3"
services:
    app:
        build:
            args:
                USER: novruz
                UID: ${UID:-1000}
                GID: ${GID:-1000}
            context: ./
            dockerfile: Dockerfile
        # 其余原有配置保持不变

3. Ubuntu 环境下构建前先执行以下命令导出当前用户的UID/GID到环境变量：

export UID=$(id -u)
export GID=$(id -g)

之后再正常执行 docker-compose build app 和 docker-compose up -d 即可，容器内 novruz 用户的权限会和宿主机目录权限完全对齐。

方案2：修改宿主机项目目录权限 #

如果不想修改镜像构建配置，直接给宿主机项目目录开放组写入权限即可：

# 替换为你的项目实际路径
sudo chgrp -R www-data /path/to/laravel/project
sudo chmod -R 2775 /path/to/laravel/project

因为 novruz 用户已经加入了 www-data 用户组，修改后容器内就拥有了目录的写入权限。

内容的提问来源于stack exchange，提问作者N'Bayramberdiyev