Windows+WSL+Docker环境下挂载NAS为Paperless-ngx存储的问题求助

方法1：在WSL内部直接挂载NAS（CIFS） #

这是最稳定的方式，让Docker直接使用WSL内的挂载路径：

1. 在WSL发行版（如Ubuntu）中安装CIFS工具：

   sudo apt update && sudo apt install cifs-utils -y
   

2. 创建挂载目录：

   sudo mkdir -p /mnt/qnap/paperless
   

3. 手动挂载NAS共享目录（替换用户名、密码和NAS IP）：

   sudo mount -t cifs //192.168.0.123/Paperless/Data /mnt/qnap/paperless -o username=NAS_USER,password=NAS_PWD,uid=1000,gid=1000
   

   • uid=1000和gid=1000匹配Paperless-ngx容器默认用户ID，避免权限问题
4. 在Docker Compose中使用该路径：

   services:
     paperless-ngx:
       # 其他配置...
       volumes:
         - /mnt/qnap/paperless:/usr/src/paperless/data
   

5. （可选）设置开机自动挂载：编辑/etc/fstab添加一行：

   //192.168.0.123/Paperless/Data /mnt/qnap/paperless cifs username=NAS_USER,password=NAS_PWD,uid=1000,gid=1000 0 0
   

方法2：正确配置Docker CIFS卷 #

之前的尝试可能缺少关键挂载参数，按以下步骤配置：

通过Portainer创建：

1. 进入Portainer的「卷」页面，点击「添加卷」
2. 填写：
   • 卷名：paperless-nas-data
   • 驱动：local
   • 驱动选项：
     • type: cifs
     • device: //192.168.0.123/Paperless/Data
     • o: username=NAS_USER,password=NAS_PWD,file_mode=0755,dir_mode=0755
3. 在Paperless-ngx的容器配置中选择该卷挂载到/usr/src/paperless/data

通过Docker Compose定义：

volumes:
  paperless-nas-data:
    driver: local
    driver_opts:
      type: cifs
      device: "//192.168.0.123/Paperless/Data"
      o: "username=NAS_USER,password=NAS_PWD,file_mode=0755,dir_mode=0755"

services:
  paperless-ngx:
    # 其他配置...
    volumes:
      - paperless-nas-data:/usr/src/paperless/data

方法3：修复Windows挂载NAS到WSL的访问问题 #

如果偏好先在Windows挂载NAS为Z盘，按以下步骤确保WSL和Docker能访问：

1. 打开WSL，编辑/etc/wsl.conf（不存在则创建）：

   [automount]
   enabled = true
   root = /mnt/
   options = "metadata,umask=22,fmask=11"
   mountFsTab = true
   

2. 重启WSL使配置生效：

   wsl --shutdown
   

3. 重新打开WSL，检查/mnt/z/Paperless/Data是否可正常访问
4. 在Docker Compose中使用该路径：

   services:
     paperless-ngx:
       # 其他配置...
       volumes:
         - /mnt/z/Paperless/Data:/usr/src/paperless/data
   

关键注意事项 #

• 权限匹配：确保NAS共享权限允许指定的用户读写，挂载时的uid/gid或file_mode/dir_mode要和容器内用户权限一致
• 路径大小写：WSL和Docker路径区分大小写，需确保配置中的路径与NAS实际文件夹名完全匹配
• WSL集成：在Docker Desktop设置中，确认已启用对应WSL发行版的集成（路径：设置 > Resources > WSL Integration）

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