★ FEATURED ARTICLE macOS VirtualBox 一键安装完整指南3 条命令与 10 次回车装好 macOS 虚拟机【免费下载链接】macos-virtualboxPush-button installer of macOS Catalina, Mojave, and High Sierra guests in Virtualbox on x86 CPUs for Windows, Linux, and macOS项目地址: https://gitcode.com/gh_mirrors/ma/macos-virtualbox需要 macOS 环境的场景并不少见编译 Swift 包、跑 iOS 模拟器、验证一套跨平台 UI但手头只有一台 Windows 或 Linux 机器。传统做法要自己拼安装镜像、配置 EFI、处理序列号任何一步出错都得从头再来。macos-virtualbox 把这个过程收敛成一个 Bash 脚本从 Apple 官方服务器拉取未经修改的 macOS 安装文件自动创建、分区并启动 VirtualBox 虚拟机默认安装全程只需要按不超过 10 次回车。 项目定位与核心价值一句话定位macos-virtualbox 是一个 push-button installer按钮式安装器一个 macos-guest-virtualbox.sh 脚本在 Windows、Linux、macOS 三类主机的 x86 CPU 上为 VirtualBox 创建可正常启动的 macOS 客户机。核心能力官方原始安装文件直接从 Apple 的swcdn.apple.com下载不改动、不重打包也不引入任何闭源启动器或 bootloader三个 macOS 版本High Sierra (10.13)、Mojave (10.14)、Catalina (10.15)安装后还可经 Software Update 升级至 Big Sur / Monterey低交互默认安装只需在脚本提示时按回车少于 10 次脚本期间明确要求用户不要手动操作虚拟机窗口分阶段可恢复安装被拆成 17 个 stage失败后可指定阶段断点续跑例如./macos-guest-virtualbox.sh configure_vm and_all_subsequent_stages可选全自动安装tesseract-ocr≥ 4含 eng 语言包后脚本会用 OCR 识别虚拟机屏幕自动完成语言选择、打开 Terminal 等步骤✅ 环境自检清单运行前对照下表逐项确认。脚本自带依赖检查check_dependencies阶段缺什么会给出具体提示提前核对可以少跑几轮。检查项要求备注CPUx86支持 VT-x 或 AMD-V必须是硬件虚拟化NEM 回退模式下 macOS 安装会内存损坏脚本检测到会直接退出主机系统Windows / Linux / macOSREADME 实测环境macOS、CentOS 7、WindowsCygwin主流 Linux 发行版应可用VirtualBox≥ 6.1.6装 Catalina 至少要 6.1.45.2 可能可用但有 VISO 文件系统已知问题ShellGNU Bash ≥ 4.3 或 zsh ≥ 5.5需要交互式shellmacOS 自带 bash 3 不可用基础工具coreutils ≥ 8.22、gzip ≥ 1.5、unzip ≥ 6.0、wget ≥ 1.14、xxd ≥ 1.11需 GNU 版本macOS 上建议用 Homebrew / MacPorts 安装dmg2img≥ 1.6.5Cygwin 下脚本会自动下载其他平台需自行安装可选tesseract-ocr ≥ 4 tesseract-ocr-eng启用 OCR 自动操作免手动回车磁盘空间约 50 GB 可用其中约 25 GB 为临时安装文件装完可删Ubuntu / Debian 上补齐依赖sudo apt-get install virtualbox coreutils gzip unzip wget xxd dmg2img tesseract-ocr tesseract-ocr-eng特别注意Windows 上 Hyper-V、Windows Sandbox、WSL2、内存完整性等功能会占用虚拟化接口导致 VirtualBox 退到 NEM。脚本检测到 NEM 会报错退出——先关掉这些功能再跑。️ 搭建全过程第 1 步获取安装脚本git clone https://gitcode.com/gh_mirrors/ma/macos-virtualbox cd macos-virtualbox第 2 步补齐依赖按上表安装缺失的包。脚本启动时会自动核对版本不满足会打印明确的缺失项与最低版本照装即可。第 3 步运行一键安装chmod x macos-guest-virtualbox.sh ./macos-guest-virtualbox.sh启动后脚本先展示当前配置虚拟机名、macOS 版本、磁盘大小等确认后开始执行。也可以先只看不装./macos-guest-virtualbox.sh documentation第 4 步等待自动完成脚本期间会两次与虚拟机交互进入语言选择界面、在 Terminal 执行自动脚本均由脚本模拟按键完成你要做的只是在终端提示时按回车全程不到 10 次。两个判断标准虚拟机 Terminal 里的进度计数器到 100% 并重启出现 Apple 的 macOS 安装进度条——安装完成脚本提示prompt_delete_temporary_files阶段——临时文件约 25 GB可以删除⚙️ 参数与调优手册默认配置无需任何修改即可安装。想定制时编辑 macos-guest-virtualbox.sh 顶部的set_variables()函数或用外部变量文件覆盖脚本支持macos_vm_vars_file机制export macos_vm_vars_file/path/to/vars.shvars.sh里每行一个变量赋值即可不用改动主脚本。关键变量速查变量默认值取值范围 / 说明vm_namemacOS虚拟机名称macOS_release_nameCatalinaHighSierra/Mojave/Catalinastorage_size80000虚拟磁盘大小MB最小 22000Catalina 要求 ≥ 25000storage_formatvdivdi或vmdk。VDI 可被 VirtualBox 在线扩容VMDK 便于之后导入 QEMU/KVMcpu_profilehostCPU 型号伪装启动失败时按踩坑速查切换cpu_count2最小 2memory_size4096MB最小 2048gpu_vram128MB范围 34–128resolution1280x800支持 11 档5120x2880至640x480如1920x1200、1440x900三个实用的调优方向磁盘扩容装完后 VDI 可在 VirtualBox 里直接增大然后在虚拟机终端执行sudo diskutil repairDisk disk0再让 APFS 容器占满必要时sudo diskutil apfs resizeContainer disk1 0可能要多试几次重启。80 GB 的默认虚拟磁盘初始安装后在宿主机上只占约 25 GB。为 QEMU/KVM 准备把storage_format设为vmdk或装完后VBoxManage clonehd --format vmdk source.vdi target.vmdk之后可以拿到 Linux 上用 KVM 获得接近原生的性能。iCloud / iMessage 连通性脚本写入了一组仿真 Apple 设备参数型号、序列号、主板 SN 等存于 EFI 与 NVRAM不设置也能正常安装使用需要登录 iCloud 时才要关心这组DmiSystem*/ROM/MLB变量。 实测表现用数字说话这个项目的表现更多体现在确定性上——数字都来自 README.md 与脚本本身的实际行为不是营销口径指标数值用户交互次数 10 次回车安装全程安装流水线17 个 stage任一阶段失败可断点续跑默认虚拟磁盘80 GBstorage_size80000MB初始安装宿主机占用约 25 GB稀疏/动态磁盘临时空间需求约 50 GB25 GB 临时文件装完可删支持的 macOS 版本3 个10.13 / 10.14 / 10.15支持的分辨率档位11 档640x480–5120x2880VirtualBox 版本跨度5.2可能至当前 6.x/7.xCatalina 需 ≥ 6.1.4对新手来说最有价值的其实是可预期同样的硬件条件流程会稳定地走到同一个进度点卡住时脚本的报错信息本身就是下一步操作指南。 适合谁、怎么用iOS / macOS 开发在 Windows/Linux 上编译 Swift、跑 xcodebuild、调试跨平台 UI不必为每个项目申请一台 Mac自动化与批量环境脚本支持非交互 shell需搭配 tesseract-ocr配合vars.sh变量文件可以脚本化地批量拉起同构 macOS 环境学习与教学单文件、1700 行、注释密集的脚本本身就是 VirtualBoxVBoxManage、EFI/NVRAM、macOS 安装流程的一份可执行教材QEMU/KVM 过渡方案用vmdk格式把虚拟机养成在 VirtualBox 里再迁移到 Linux KVM 上获得硬件直通性能——README 明确推荐这条路径 踩坑速查高频问题基本都写在脚本的报错和 README.md 里按现象对照处理现象原因解法脚本提示检测到 NEM 后退出Hyper-V、WSL2、内存完整性等占用了 VT-x/AMD-V关闭这些功能Windows 上优先用 WSL1 或 Cygwin 跑脚本启动卡在LoadKernelFromStream/EndRandomSeed/EXITBS较新的 CPU2020 年后常见不被 macOS 识别关机状态下依次尝试--cpu-profile host--cpuidremoveall再逐个换预置 CPU profilei7-2635QM、i7-5600U 等 6 种Catalina 装不上脚本报版本错误VirtualBox 6.1.4升级 VirtualBox下载 Apple 文件失败提示证书不受信任宿主机缺 CA 证书安装ca-certificates包装完系统后磁盘空间不够虚拟磁盘是 80 GB 上限扩容 VDI 后执行diskutil repairDisk APFS 扩容见调优手册升级 Monterey 后反复重启原地升级不稳定挂第二块虚拟盘并选它作为安装目标声音 / 显示缩放 / FileVault 密码提示不正常属于 VirtualBox 与 macOS 的既有限制不在脚本范围内需要 OpenCore 等额外配置脚本明确标注 out of scope排查时先跑./macos-guest-virtualbox.sh troubleshoot会生成包含系统信息、VirtualBox 日志和安装文件校验和的诊断文件方便定位。 项目内幕一个脚本怎么干完所有事仓库只有三个文件结构极简文件说明macos-guest-virtualbox.sh全部逻辑1700 行17 个 stageREADME.md使用说明与已知限制LICENSEGPL 2.0 或更高版本工作原理可以拆成五条主线拿官方文件先拉 Apple 的swscan.apple.comsucatalog解析出InstallAssistantAuto.smd的下载基址再取回BaseSystem.dmg、InstallESDDmg.pkg等原始文件超过 2 GB 的 pkg 会切成 1 GB 分卷绕开 VirtualBox VISO 与 ISO9660 的单文件限制造虚拟介质用dmg2img把BaseSystem.dmg转成磁盘镜像再用 VirtualBox 的 VISO 机制把安装文件、EFI 启动脚本、NVRAM 二进制文件打包成虚拟光驱写 NVRAM用xxdgzipcrc32手工构造MLB、ROM、system-id、csr-active-config四个 NVRAM 条目的二进制文件启动后经 EFI Shell 的dmpstore写入满足 iCloud 等设备识别需求自动操作虚拟机脚本内置了一张完整的 QWERTY 键盘 scancode 表通过VBoxManage controlvm keyboardputscancode逐键模拟输入替你点语言选择、开 Terminal、执行分区与startosinstall脚本OCR 兜底全自动装了 tesseract 后脚本会定时截图虚拟机并识别屏幕文字Language 界面、Utilities 菜单匹配成功就自动按键彻底免交互整个流程以stages数组驱动每个 stage 都是可独立调用的函数——这也是断点续跑能力的来源。 持续维护与贡献版本与许可当前脚本版本 0.99.2.4GPL 2.0 or higher维护者招募中README 明确标注 Maintainer wanted并在 issue #645 中征集新维护者。项目功能稳定但缺少活跃维护这正是参与者能产生实际价值的窗口贡献路径克隆仓库 → 复现一个 issueCPU 兼容性、WSL 路径问题、报错文案是常见方向→ 修复后提交。脚本大部分内容是文档、注释和可执行的错误信息阅读门槛比一般脚本低不少边界提醒OpenCore 音频/显示缩放、FileVault、QEMU/KVM 迁移、配置管理批量部署都在脚本声明的范围之外做相关改进时建议作为独立文档或工具而不是塞进主脚本 第一步行动建议不用一次看完再动手按这个顺序走最稳git clone https://gitcode.com/gh_mirrors/ma/macos-virtualbox cd macos-virtualbox ./macos-guest-virtualbox.sh documentation # 先通读文档 ./macos-guest-virtualbox.sh # 准备就绪后正式开跑跑之前花两分钟对照环境自检清单把 VirtualBox 版本和 50 GB 空间确认掉跑的过程中如果卡住把终端提示的 stage 名称记下来配合troubleshoot命令基本就能对上踩坑速查表里的解法。【免费下载链接】macos-virtualboxPush-button installer of macOS Catalina, Mojave, and High Sierra guests in Virtualbox on x86 CPUs for Windows, Linux, and macOS项目地址: https://gitcode.com/gh_mirrors/ma/macos-virtualbox创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
