Docker Compose挂载NFS共享报错求助：配置问题排查与修复

尝试在Docker Compose中挂载NFS共享时失败，当前compose.yaml配置如下：

services:
  duplicati:
    image: lscr.io/linuxserver/duplicati:latest
    container_name: duplicati
    environment:
      - PUID=0
      - PGID=0
      - TZ=Etc/UTC
      - CLI_ARGS= #optional
    volumes:
      - ./config:/config
      - lalinap:/backups
      - /:/source
    ports:
      - 8200:8200
    restart: unless-stopped
volumes:
  lalinap:
    driver: local
    driver_opts:
      type: "nfs"
      o: "addr=192.168.103.45,nolock,soft,rw"
      device: ":/Backup/Krystof/"
networks: {}

执行docker compose up -d时出现错误：

wafadmin@odin:~/duplicati$ docker compose up -d
[+] Running 0/1
 ⠹ Container duplicati  Starting                                                                                                                                       0.2s 
Error response from daemon: error while mounting volume '/var/lib/docker/volumes/duplicati_lalinap/_data': failed to mount local volume: mount :/Backup/Krystof/:/var/lib/docker/volumes/duplicati_lalinap/_data, data: addr=192.168.103.45,defaults: invalid argument

核心错误点 #

1. NFS设备路径格式错误：device字段缺少NFS服务器IP地址，正确的NFS设备格式应为<服务器IP>:<共享路径>，而非仅以:开头。
2. 冗余路径斜杠：共享路径末尾的/可能导致解析异常，建议移除。
3. 宿主机可能缺少NFS客户端依赖：未安装NFS客户端工具会直接导致挂载失败。

修复步骤 #

1. 修正Docker Compose配置 #

修改volumes下的lalinap配置，调整device和o参数：

volumes:
  lalinap:
    driver: local
    driver_opts:
      type: "nfs"
      o: "addr=192.168.103.45,nolock,soft,rw,defaults"
      device: "192.168.103.45:/Backup/Krystof"

• device字段补充NFS服务器IP，移除路径末尾斜杠
• o参数添加defaults确保基础挂载选项生效，保留原有兼容选项

2. 安装宿主机NFS客户端 #

如果是Debian/Ubuntu系统，执行：

sudo apt update && sudo apt install -y nfs-common

如果是RHEL/CentOS/Rocky Linux系统，执行：

sudo dnf install -y nfs-utils

安装完成后重启Docker服务：

sudo systemctl restart docker

3. 验证NFS共享可访问 #

先在宿主机手动测试挂载，确认共享正常：

sudo mount -t nfs 192.168.103.45:/Backup/Krystof /tmp/test_nfs

如果挂载成功，说明网络和NFS服务器配置无问题，再执行docker compose up -d即可。测试完成后卸载临时挂载：

sudo umount /tmp/test_nfs

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