# VirtualBuddy

在 Apple 芯片上创建并运行 macOS 和部分 ARM Linux 虚拟机，支持下载安装器及客户机共享。

> 这是 OpenNavo 上 VirtualBuddy 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/virtualbuddy>

- **最新版本**: `2.2.1,430`
- **开发者**: Guilherme Rambo
- **主页**: <https://github.com/insidegui/VirtualBuddy>
- **分类**: [虚拟化与容器](https://opennavo.com/zh/categories/virtualization)
- **安装**: `brew install --cask virtualbuddy`
- **近 30 天安装**: 384
- **Homebrew**: 可以安装，应用会自行更新
- **下载地址**: <https://github.com/insidegui/VirtualBuddy/releases/download/2.2.1/VirtualBuddy_v2.2.1-430.dmg>
- **SHA-256**: `16fac6dddbb012548911c0a6807a882e8df5b5b4897a218923b108aaa333fc63`
- **附带命令**: vctool

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "app": [
        "VirtualBuddy.app"
      ],
      "target": "/Applications/VirtualBuddy.app"
    },
    "phase": "install",
    "sources": [
      "VirtualBuddy.app"
    ],
    "target": "/Applications/VirtualBuddy.app",
    "type": "app"
  },
  {
    "declaration": {
      "binary": [
        "$APPDIR/VirtualBuddy.app/Contents/MacOS/vctool",
        {
          "target": "vctool"
        }
      ],
      "target": "$HOMEBREW_PREFIX/bin/vctool"
    },
    "phase": "install",
    "sources": [
      "$APPDIR/VirtualBuddy.app/Contents/MacOS/vctool"
    ],
    "target": "$HOMEBREW_PREFIX/bin/vctool",
    "type": "binary"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/VirtualBuddy",
            "~/Library/Caches/codes.rambo.VirtualBuddy",
            "~/Library/Caches/VirtualBuddy",
            "~/Library/HTTPStorages/codes.rambo.VirtualBuddy",
            "~/Library/Preferences/codes.rambo.VirtualBuddy.plist"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

VirtualBuddy 是一款面向开发者的 Mac 虚拟化应用，专注于在不同 macOS 版本（包括受支持的测试版环境）中测试应用。它也可以运行部分 ARM Linux 发行版。

### 功能
- 使用安装向导和恢复映像目录创建虚拟机。
- 从 Apple 托管的 IPSW、自定义 URL 或现有本地映像安装 macOS。
- 从 ISO 文件或下载链接安装受支持的 ARM Linux 发行版。
- 配置虚拟硬件、网络和共享文件夹。
- 保存和恢复受支持的 macOS 虚拟机状态。
- 在客户机系统支持的情况下，使用客户机伴侣实现剪贴板和共享文件夹集成。

### 安装与要求
下载官方 DMG 并复制到 Applications，或使用 `brew install --cask virtualbuddy`。2.2 及以后版本要求 Apple 芯片 Mac 和 macOS 14 或更高版本，应以对应版本的官方说明及更新源为准，README 中的通用 macOS 13 要求较旧。官方更新源将 2.2.1 对应到 build 430，完整 DMG 为 22,041,237 字节；这不是安装后体积，也不包括虚拟机存储。请为客户机另行分配足够的内存和磁盘空间。

项目支持 macOS 12 及以后版本的客户机和部分 ARM Linux，具体兼容性取决于主机和客户机。在 macOS 26 主机安装 macOS Golden Gate 测试版，需要 VirtualBuddy 2.2 beta 2 或更高版本及 Apple 最新设备支持文件，或包含这些文件的 Xcode 27 测试版。其他较新的 macOS 测试版也可能需要更新设备支持。Apple Developer 下载可能需要 Apple 账户；稳定版客户机并非一律要求 Xcode。

### 客户机集成与权限
当前客户机伴侣要求 macOS 14 或更高版本，才能共享剪贴板并自动挂载共享文件夹。旧版 macOS 13 伴侣仅能挂载共享文件夹；macOS 12 不支持客户机应用。请审慎检查共享文件夹和剪贴板访问权限，因为它们会将客户机活动与主机数据连接起来。未声明存在名为 Homebrew cask 的冲突。经查阅的项目文档未要求日常使用时一律授予辅助功能、屏幕录制或完全磁盘访问权限。

### 账户、网络与许可
VirtualBuddy 免费且采用 BSD 风格许可证开源；付费下载和赞助都是支持开发者的可选方式。项目文档未说明需要 VirtualBuddy 账户。目录、下载和联网的客户机任务需要网络访问。安装完成后，本地客户机可执行本地工作，无需依赖 VirtualBuddy 云账户，但仍须满足客户机软件自身的要求。客户机操作系统的许可证要求另行适用。

### 实用注意事项
虚拟机适用于测试，但共享文件夹、剪贴板集成和网络访问可能突破隔离边界。请避免将包含敏感数据的主机文件夹连接到不可信的客户机。升级前请备份重要的虚拟机文件，并确保主机有充足资源。测试版客户机可能不稳定。请查阅 Apple 软件许可条款和 macOS 虚拟化的硬件支持条件，不要将 IPSW 可用误认为所有用途均获许可。

目录记录 2.2.1,430 和 2.2.1 对应同一上游版本，官方更新源标明 build 430。下一条记录是 2.2,428。保存运行状态需要已完成安装的受支持 macOS 客户机，磁盘映像须位于支持文件克隆的卷上的虚拟机包内，且 USB 设备必须断开。USB 直通，以及在首次启动前创建客户机账户以跳过设置助理，均要求主机和客户机同时运行 macOS 27 或更高版本。

来源：[官方项目与要求](https://github.com/insidegui/VirtualBuddy)、[官方发布](https://github.com/insidegui/VirtualBuddy/releases)、[官方更新源](https://su.virtualbuddy.app/appcast.xml)、[许可证](https://github.com/insidegui/VirtualBuddy/blob/main/LICENSE)。

[2.2](https://github.com/insidegui/VirtualBuddy/releases/tag/2.2) · [2.2.1](https://su.virtualbuddy.app/releasenotes.html)

## 系统要求

- macOS 14 起 · 应用版本: 2.2.1,430 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · 核查于 2026-11-22
  - <https://github.com/insidegui/VirtualBuddy/releases/download/2.2.1/VirtualBuddy_v2.2.1-430.dmg>
  - SHA-256: `16fac6dddbb012548911c0a6807a882e8df5b5b4897a218923b108aaa333fc63`

## VirtualBuddy 的安全事实

这里只列可以核验的事实，并注明来源和日期，不是安全认证。要检查你下载的文件，可以用 OpenNavo 在本机扫描。

- <https://github.com/insidegui/VirtualBuddy> · 是否开源: 是 — <https://github.com/insidegui/VirtualBuddy> · 核查于 2026-11-13

## 卸载

- `brew uninstall --cask virtualbuddy`

普通卸载会删除应用本身，设置和缓存会保留。

### 深度清理（可选）

- `brew uninstall --zap --cask virtualbuddy`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/Library/Application Support/VirtualBuddy` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Caches/codes.rambo.VirtualBuddy` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Caches/VirtualBuddy` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/HTTPStorages/codes.rambo.VirtualBuddy` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Preferences/codes.rambo.VirtualBuddy.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 2.3-b1-prerelease (2026-11-18)

### What's New in VirtualBuddy 2.3 Beta 1

#### Change Settings While a Virtual Machine Is Running

You can now add or remove shared folders and change the display resolution while a virtual machine is running. Open Virtual Machine Settings from the window toolbar or the Guest menu.

For macOS virtual machines, changing the display resolution while running requires macOS 14 or later on both the host and the guest.

#### Guest Appearance

You can now turn Dark Mode on or off in a macOS virtual machine from its window toolbar. Click the VirtualBuddyGuest status button and turn on “Automatically Sync with Host” if you want the guest to follow your Mac’s appearance.

These controls require an up-to-date copy of VirtualBuddyGuest running in the virtual machine.

#### Guest System Information

The library now shows the macOS version and build last reported by VirtualBuddyGuest, even after you update macOS inside the virtual machine. Control-click a virtual machine and choose Get Info to see details such as its kernel version, memory, and System Integrity Protection status. You can still view the last report when the virtual machine is shut down.

#### Other Changes & Improvements

- If a virtual machine stops responding, choose Guest > Force Stop & Close or Option-click the window’s close button. Once you confirm, VirtualBuddy stops the virtual machine immediately and closes its window.
- VirtualBuddyGuest now checks that an update supports the guest’s macOS version before installing it.
- Administrators can now use managed preferences to disable the SSH and automatic login options when setting up a new macOS virtual machine.
- The software catalog now shows shared compatibility warnings above the list of restore images and tells you when an image requires a newer version of VirtualBuddy.
- VirtualBuddy now explains that installing a new macOS 27 virtual machine from a restore image requires a host Mac running macOS 26 or later with compatible device support. You can still upgrade an existing virtual machine using Software Update inside the guest.

**Full Changelog**: [2.2.1...2.3-b1](https://github.com/insidegui/VirtualBuddy/compare/2.2.1...2.3-b1)

## 资料与来源

- <https://opennavo.com/zh/apps/virtualbuddy>
- <https://opennavo.com/zh/apps/virtualbuddy/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/v/virtualbuddy.rb> · 核查于 2026-11-22
- <https://formulae.brew.sh/cask/virtualbuddy>
- <https://github.com/insidegui/VirtualBuddy> · 核查于 2026-11-13
