Docker挂载CIFS卷报错no route to host，容器无法访问本地网络

1. 检查Docker Desktop网络模式 #

Docker Desktop在Windows上默认依赖WSL2后端，网络隔离可能导致容器无法访问局域网设备：

• 打开Docker Desktop设置，进入Resources > Network
• 确认WSL集成已开启，尝试切换后端（WSL2 ↔ Hyper-V），重启Docker后重新测试

2. 排查WSL2网络连通性（WSL2后端场景） #

容器实际运行在WSL2虚拟机内，若WSL2本身无法访问局域网，会直接导致挂载失败：

• 打开Windows终端进入WSL2发行版，执行ping 192.168.1.200，若丢包则执行以下操作：
  • 重置WSL2网络：在Windows命令行执行wsl --shutdown，重启WSL和Docker
  • 检查Windows防火墙规则，确保允许WSL2进程访问局域网
  • 配置WSL2桥接模式：在%USERPROFILE%\.wslconfig中添加：

    [wsl2]
    networkMode=bridged
    

    重启WSL后测试

3. 重新创建CIFS卷并补充挂载参数 #

挂载参数缺失或SMB版本不匹配可能导致连接失败，重新创建卷时添加SMB版本和权限参数：

docker volume create --driver local \
  --opt type=cifs \
  --opt device=//192.168.1.200/media/books \
  --opt o=user=<username>,password=<password>,vers=3.0,uid=1000,gid=1000 \
  books

4. 检查Windows防火墙与杀毒软件 #

Windows自动更新可能修改防火墙规则，临时关闭第三方杀毒软件，同时确认Windows防火墙允许Docker Desktop及WSL2相关进程访问局域网。

5. 在Compose中直接定义CIFS卷（替代外部卷） #

若外部卷配置存在隐性问题，可直接在Compose文件内定义卷：

services:
  audiobookshelf-0114:
    image: ghcr.io/advplyr/audiobookshelf:latest
    ports:
      - 13378:80
    restart: unless-stopped
    volumes:
      - books:/audiobooks
      - podcasts:/podcasts
      - "/c/docker/audiobookshelf/config:/config"
      - "/c/docker/audiobookshelf/metadata:/metadata"
volumes:
  books:
    driver: local
    driver_opts:
      type: cifs
      device: "//192.168.1.200/media/books"
      o: "user=<username>,password=<password>,vers=3.0"
  podcasts:
    driver: local
    driver_opts:
      type: cifs
      device: "//192.168.1.200/media/podcasts"
      o: "user=<username>,password=<password>,vers=3.0"

6. 验证SMB服务器端口可达性 #

从WSL2或容器内测试SMB服务端口：

telnet 192.168.1.200 445

若无法连接，需在SMB服务器上开放445端口的入站防火墙规则。

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