Docker容器挂载主机目录失败问题排查

错误根源 #

你创建volume时错误使用了nfs类型参数，但要挂载的是本地主机目录而非NFS网络共享存储，导致Docker尝试用NFS协议挂载本地目录，自然抛出"invalid argument"错误。

解决方法 #

方法1：直接使用Bind Mount（推荐，更简单） #

无需提前创建volume，运行容器时直接挂载本地目录：

docker run -p 8020:80 -p 2220:22 --network dockernet -v /var/www/wasql:/var/www/wasql/ -it wasql.image /bin/bash

或用--mount等效语法：

docker run -p 8020:80 -p 2220:22 --network dockernet --mount type=bind,source=/var/www/wasql,target=/var/www/wasql/ -it wasql.image /bin/bash

方法2：正确创建Local Volume（若坚持用volume方式） #

若一定要用Docker Volume管理本地目录，创建时不要指定NFS参数，改用bind类型的local volume：

docker volume create --driver local \
  --opt type=none \
  --opt o=bind \
  --opt device=/var/www/wasql \
  wasql2

之后用你原来的docker run命令挂载该volume即可。

额外提示 #

• 确保主机上/var/www/wasql目录存在，且Docker daemon有访问权限（可先执行sudo chmod -R 777 /var/www/wasql临时测试，后续按需调整权限）。
• 若用Snap安装的Docker，需额外配置目录访问权限：执行sudo snap connect docker:removable-media。

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