Docker容器访问QNAP NAS NFS挂载目录提示Operation not permitted如何解决？

核心原因 #

NFS权限依赖UID/GID的一致性映射，你容器内的用户UID/GID和QNAP共享文件夹的所有者（UID 1000、GID 0）不匹配，导致访问被拒绝。主机能正常访问是因为主机用户的UID/GID和QNAP端的映射是匹配的。

解决方案 #

1. 调整Docker容器的用户映射 #

直接在docker-compose的app服务中指定与共享文件夹匹配的UID/GID：

services:
  app:
    ... # 其他配置
    user: "1000:0" # UID对应QNAP共享的1000，GID对应root的0
    volumes:
      - .:/app 
      - "nfs-base:/Z"

volumes:
  nfs-base:
    driver: local
    driver_opts:
      type: nfs
      o: "nfsvers=4,addr=IPADDRESS_OF_THE_QNAP-NAS,rw"
      device: ":/"

或者在NFS挂载选项中直接指定UID/GID映射：

volumes:
  nfs-base:
    driver: local
    driver_opts:
      type: nfs
      o: "nfsvers=4,addr=IPADDRESS_OF_THE_QNAP-NAS,rw,uid=1000,gid=0"
      device: ":/"

2. 检查QNAP的NFS共享权限设置 #

登录QNAP Web管理后台：

• 进入「控制台」->「共享文件夹」，选中base文件夹，点击「编辑」
• 切换到「NFS权限」标签，点击「添加」，输入Docker主机的IP地址，设置权限为「读写」
• 在「高级设置」中，确保「允许匿名用户访问」或「将匿名用户映射为本地用户」，并指定本地用户的UID为1000（如果QNAP上存在该UID的用户）
• 同时检查「权限设置」标签，确认共享文件夹的所有者权限为「读写」

3. 验证容器内用户权限 #

进入容器执行以下命令，确认当前用户的UID/GID是否匹配：

# 进入容器
docker exec -it <容器名> bash
# 查看当前用户ID
id

如果输出的uid=1000且gid=0，说明映射正确，此时再尝试访问/Z/base目录即可。

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