Node.js Docker-Compose容器EACCES权限错误求助（Fedora环境）

核心原因 #

Fedora默认启用SELinux，挂载宿主机目录到容器时会限制容器内进程访问；同时，宿主机当前用户的UID/GID可能与容器内node用户（默认UID=1000）不匹配，导致文件读写权限被拒绝。而Garuda Linux基于Arch，默认关闭SELinux，且用户UID通常为1000，因此无此问题。

解决方案 #

1. 验证SELinux是否为问题根源 #

临时关闭SELinux测试：

sudo setenforce 0

重启容器后若恢复正常，说明是SELinux限制导致。

2. 永久解决SELinux权限问题 #

给宿主机项目目录添加容器可访问的SELinux上下文：

chcon -Rt container_file_t ./

此命令将当前目录的SELinux类型标记为容器允许访问的类型，无需关闭SELinux。

3. 匹配容器与宿主机用户UID/GID #

如果SELinux不是问题，可能是用户ID不匹配：

方法A：修改Dockerfile动态适配UID/GID

修改Dockerfile，构建时传入宿主机的UID/GID，确保容器内node用户与宿主机用户权限一致：

FROM node:alpine

ARG UID=1000
ARG GID=1000

# 若传入的UID不是默认1000，修改node用户的UID/GID
RUN if [ $UID != 1000 ]; then \
        apk add --no-cache shadow && \
        groupmod -g $GID node && \
        usermod -u $UID -g $GID node; \
    fi

WORKDIR /app

RUN chown -R node:node /app

USER node

COPY package*.json ./

RUN yarn

COPY . .

CMD [ "yarn", "dev" ]

在docker-compose.yml中传递宿主机的UID/GID：

version: "3.1"
services:
  app:
    build:
      context: .
      args:
        UID: ${UID}
        GID: ${GID}
    ports:
      - "8000:8000"
    depends_on:
      - postgres
      - redis
    volumes:
      - .:/app
      - /app/node_modules
  # postgres、redis配置保持不变

运行容器前，环境变量UID和GID会自动读取当前用户的ID，直接执行构建命令即可：

docker-compose up --build

方法B：直接在docker-compose.yml指定用户

如果宿主机用户UID/GID是固定的，可直接在app服务中指定用户：

services:
  app:
    user: "1000:1000" # 替换为你的宿主机UID:GID
    # 其他配置不变

总结 #

优先通过SELinux上下文调整解决问题，若仍存在权限冲突，再适配用户UID/GID。两种方案结合可彻底解决Fedora下的挂载权限问题。

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