Docker Machine创建失败求助：VirtualBox版本适配问题排查

我之前在Ubuntu桌面环境下折腾Docker Machine + VirtualBox的时候也遇到过类似的系统冻结和创建失败问题，结合官方教程的场景，给你分享几个亲测有效的排查和解决步骤：

1. 先搞定VirtualBox的基础兼容性问题 #

不管是旧版本还是升级后的5.2.6版本，VirtualBox和Ubuntu内核的兼容是核心问题：

• 首先检查VirtualBox内核模块是否正常加载：

  sudo modprobe vboxdrv
  

  如果出现报错，说明内核模块未正确编译，执行以下命令重新生成适配当前内核的模块：

  sudo /sbin/vboxconfig
  

• 确保你的用户拥有VirtualBox操作权限，把当前用户加入vboxusers组：

  sudo usermod -aG vboxusers $USER
  

  执行完记得注销并重新登录，权限才会生效。

2. 解决Ubuntu桌面冻结的问题（针对旧版VirtualBox遗留或新版仍存在的情况） #

• VirtualBox 5.0对Ubuntu 16.04及以上版本的新内核支持很差，容易触发硬件层面的冲突导致冻结。升级到5.2.6是对的，但可以再关闭VirtualBox的3D加速试试：
  打开VirtualBox -> 点击顶部菜单栏的「全局设置」 -> 切换到「显示」选项卡 -> 取消勾选「启用3D加速」
• 另外，检查你的系统是否开启了Secure Boot，如果开启了，可能会阻止VirtualBox内核模块加载，进入BIOS关闭Secure Boot后再尝试创建虚拟机。

3. 调试Docker Machine创建过程，定位具体错误 #

如果升级VirtualBox后还是创建失败，一定要打开调试日志看具体卡在哪个环节：

docker-machine create -d virtualbox --debug mycluster-node

通过日志你可以看到是虚拟机创建失败、网络配置问题还是磁盘空间不足，方便精准解决。

4. 替代方案：用KVM驱动替换VirtualBox #

如果VirtualBox的问题始终无法解决，不妨试试KVM作为Docker Machine的驱动，它对Linux系统的兼容性更好：

• 先安装KVM相关依赖：

  sudo apt update && sudo apt install qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils
  

• 把当前用户加入libvirt组获取权限：

  sudo usermod -aG libvirt $USER
  

• 下载并安装docker-machine的KVM驱动：
  从官方仓库下载对应你系统架构的docker-machine-driver-kvm二进制文件，将其放到/usr/local/bin目录，然后赋予执行权限：

  chmod +x /usr/local/bin/docker-machine-driver-kvm
  

• 之后用KVM驱动创建Docker Machine节点：

  docker-machine create -d kvm mycluster-node
  

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