linux下vagrant常见问题源于virtualbox内核模块未加载、镜像源慢、共享目录被systemd-resolved或selinux干扰、vagrantfile配置不显式及网络策略误用；需手动安装官方包、验证链路、禁用gui、配镜像源并严格按生命周期命令操作。
Linux 下装 Vagrant 本身很简单，但真正卡住人的从来不是安装，而是装完后 vagrant up 报错、SSH 连不上、共享目录不生效、或者 VirtualBox 驱动没加载——这些才是实际开发中天天要面对的问题。
确认宿主机虚拟化支持和 VirtualBox 兼容性
Vagrant 本身不提供虚拟机，它只是个编排工具，底层依赖 VirtualBox、libvirt 或 VMware。绝大多数 Linux 开发者用的是 VirtualBox，但它对内核模块要求严格。
- 先运行
lsmod | grep vbox，如果无输出，说明vboxdrv没加载；常见于新内核升级后，VirtualBox 未重编译模块 - 执行
sudo /sbin/vboxconfig，观察是否报Building the main VirtualBox module成功；若失败，大概率缺linux-headers-$(uname -r)和build-essential - Ubuntu/Debian 用户别直接
apt install virtualbox，优先用官网 .deb 包（避免版本太旧导致与新版 Vagrant 不兼容）
安装 Vagrant 并验证基础命令链路
别用包管理器装 Vagrant，官方二进制包更新快、依赖干净。装完必须立刻验证「Vagrant → VirtualBox → 内核模块」整条链路是否通。
- 从 https://www.php.cn/link/1ae78e32391b4ac70f0f492717d88f48 下载对应架构的 .deb 或 .rpm，用
sudo dpkg -i或sudo rpm -ivh安装 - 运行
vagrant --version确认版本 ≥ 2.3.0（老版本对 Ubuntu 22.04+ 的 cloud-init 支持差） - 紧接着跑
vagrant init hashicorp/bionic64 && vagrant up—— 这步必须做，它会触发 box 下载、VM 创建、网络配置，暴露真实环境问题 - 如果卡在
default: Waiting for machine to boot...，大概率是 VirtualBox GUI 被禁用或串口日志没开，此时改用vagrant up --no-provision --debug | head -100看卡在哪一行
配置共享文件夹时绕过 systemd-resolved 和 selinux 干扰
vagrant reload 后共享目录突然失效？90% 是因为宿主机开了 systemd-resolved（影响 NFS）或 SELinux（阻止 vboxsf 挂载），而不是 Vagrantfile 写错了。
- 检查
/etc/fstab是否有残留的vboxsf条目，有就删掉；Vagrant 管理挂载，手动写 fstab 会冲突 - Ubuntu 20.04+ 默认启用
systemd-resolved，会导致 NFS 启动超时；临时解决：运行sudo systemctl stop systemd-resolved，或在/etc/vagrant/Vagrantfile里加config.vm.synced_folder ".", "/vagrant", type: "nfs", nfs_udp: false - CentOS/RHEL 开启 SELinux 时，
vboxsf模块可能被拒绝挂载；执行sudo setsebool -P vagrant_manage_vboxsf 1（需先装selinux-policy-devel） - 别把项目根目录设为
~/code/project这种带软链接的路径，Vagrant 对 symlink 处理不稳定，优先用绝对路径如/home/user/project
用 Vagrantfile 控制关键行为而非依赖默认值
很多人把 Vagrantfile 当成可有可无的配置文件，其实它是环境一致性的核心——网络模式、内存分配、box 更新策略，全靠它显式声明。
- 永远显式指定 box 版本：
config.vm.box_version = "20230817.0.0"，否则vagrant up可能拉取到破坏性更新的 box - 内存不够时不要只调
vb.memory，还要关掉 GUI：vb.gui = false，省下 50MB 显存 - 国内用户务必配镜像源：
config.vm.box_url = "https://mirrors.tuna.tsinghua.edu.cn/ubuntu-cloud-images/releases/bionic/release/ubuntu-18.04-server-cloudimg-amd64-vagrant.box"，否则等半小时下载是常态 - 如果要用
vagrant ssh直连，确保config.ssh.insert_key = true，否则私钥不匹配，连上也立刻断开
最常被忽略的一点：Vagrant 的 up、reload、halt 行为差异极大，但文档里没强调。比如 vagrant reload 会销毁并重建 VM 网络栈，而 vagrant up 不会——这意味着改了 config.vm.network 后，必须 vagrant destroy && vagrant up 才真正生效，仅 reload 是无效的。
