Windows环境Alpine Node容器中mkdir报EACCES权限拒绝问题求助

• 一段Node.js代码在Linux及macOS环境的Alpine Node Docker容器中运行正常，代码如下：

import fs from 'fs';
...
const processorDir = path.join(LOCAL_PROC_PATH, 'processor');
if (!fs.existsSync(processorDir)) {
    fs.mkdirSync(processorDir);
}

• 但在Windows环境下的同版本Alpine Node Docker容器中运行时，出现权限报错：

Error: EACCES: permission denied, mkdir '/mnt/app/processor'

• 替换为fs-extra的ensureDirSync方法后问题仍未解决：

import fs from 'fs-extra';
...
fs.ensureDirSync(processorDir);

• Dockerfile已配置目录权限及运行用户：

RUN mkdir -p /mnt/app/
RUN chown -R node:node /mnt/app/
USER node

• 补充说明：/mnt/app/即为代码中的LOCAL_PROC_PATH，Linux环境下node用户可正常创建目录；Windows环境下即使使用具备管理员权限的Linux用户运行容器，仍会出现相同报错。

1. 检查Windows Docker的文件共享权限 #

Windows环境下Docker挂载本地目录时，需确保Docker拥有对应磁盘的访问权限：

• 打开Docker Desktop设置 → Resources → File Sharing，勾选目标磁盘（如C盘）并保存应用设置。
• 挂载目录时避免使用含空格或特殊字符的路径，防止权限解析异常。

2. 强制匹配容器用户与宿主权限映射 #

Windows文件系统权限与Linux不兼容，容器内的权限设置可能被挂载覆盖，可通过指定用户ID/组ID强制匹配：

• 单机运行容器时：

docker run -v /宿主本地路径:/mnt/app -u $(id -u node):$(id -g node) 你的镜像名

• 使用Docker Compose时，在服务配置中添加：

services:
  你的服务名:
    ...
    user: "${UID:-1000}:${GID:-1000}"

（注：Alpine镜像中node用户的UID/GID通常为1000/1000，可通过docker exec -it 容器名 id node确认）

3. 更换容器内挂载目录路径 #

Windows Docker的/mnt目录存在特殊权限处理逻辑，建议将挂载路径改为容器内其他目录（如/app）：

• 修改Dockerfile：

RUN mkdir -p /app/
RUN chown -R node:node /app/
USER node

• 同步修改代码中的LOCAL_PROC_PATH为/app，重新构建镜像后测试。

4. 排查Windows安全软件拦截 #

Windows Defender或第三方防火墙可能拦截容器对挂载目录的写入操作：

• 临时关闭实时保护后测试，若问题消失，将Docker相关路径添加到安全软件的排除列表。

5. 处理挂载覆盖容器内权限的问题 #

如果运行容器时挂载了本地目录到/mnt/app，Dockerfile中chown的操作会被挂载覆盖，此时：

• 可在Windows本地目录右键 → 属性 → 安全 → 编辑，添加Everyone用户并授予写入权限（仅测试用，生产环境需配置更严格权限）；
• 或在容器启动后执行命令重新设置权限：

docker exec -it 容器名 chown -R node:node /mnt/app/

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