Docker卷写入遇EACCES权限拒绝错误的解决求助

问题分析 #

你遇到的EACCES: permission denied错误，核心原因是容器内以node用户运行的进程，没有对挂载的/var/lib/refunds/data路径的写入权限。虽然已在docker-compose中关联外部卷，但外部卷的目录默认由root用户所有，导致非root的node用户无法操作。

解决方案 #

方案1：在Dockerfile中提前配置目录权限 #

修改你的Dockerfile，在切换到node用户前，创建目标目录并将所有权赋予node用户：

FROM node:lts-alpine3.16 AS builderdevices
RUN apk add --no-cache python3 py3-pip make g++
WORKDIR /usr/src/app
COPY [ "package.json", "yarn.lock", "/usr/src/app/" ]
RUN yarn install --prod=true --frozen-lockfile

FROM node:lts-alpine3.16 
RUN apk add dumb-init
# 同时创建sqlite和refunds数据目录并设置权限
RUN mkdir -p /var/lib/sqlite /var/lib/refunds/data
RUN chown node:node /var/lib/sqlite /var/lib/refunds/data
USER node
WORKDIR /usr/app
COPY --chown=node:node --from=builderdevices /usr/src/app/node_modules /usr/app/node_modules
COPY --chown=node:node . /usr/app/
CMD [ "dumb-init", "yarn", "start" ]
EXPOSE 5003

重新构建镜像并启动容器，容器内的/var/lib/refunds/data目录会以node用户权限初始化，挂载外部卷后自动继承权限。

方案2：直接修改主机上外部卷的权限 #

1. 先找到refunds-volume在主机上的实际挂载路径：

docker volume inspect refunds-volume | grep Mountpoint

输出示例："Mountpoint": "/var/lib/docker/volumes/refunds-volume/_data"

2. 修改该路径的所有者为node用户对应的UID（alpine镜像中node用户UID默认是1000）：

sudo chown -R 1000:1000 /var/lib/docker/volumes/refunds-volume/_data

修改完成后重启容器，node用户即可正常写入该卷。

方案3：在entrypoint中临时调整权限（快速测试用） #

修改docker-compose.yml的entrypoint，先以root身份调整目录权限，再切换到node用户启动服务：

entrypoint: >
  /bin/sh -c "
  chown -R node:node /var/lib/refunds/data;
  npx sequelize-cli db:migrate;
  su node -c 'yarn start';
  "

注：此方式每次容器启动都会执行权限调整，适合临时验证问题，长期使用建议选择方案1或2。

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