ArcBox Desktop：macOS 容器与虚拟机管理

项目简介

ArcBox Desktop 是 ArcBox 的原生 macOS 图形界面，把容器、Kubernetes、Linux 虚拟机和 Agent 沙箱集中到一个窗口里管理，定位为 OrbStack 的开源替代方案。整个 App 使用 SwiftUI 编写，运行时由独立的 arcbox-daemon（Rust，负责 VMM、网络与存储）提供，二者通过 gRPC 与 Docker Engine API 通信，daemon 再经 vsock 与 Linux 客户机中的 arcbox-agent 交互。

运行时完全在你自己的 Mac 上运行，不需要平台账号或云端控制平面；只有更新、镜像下载和可选的匿名遥测会使用网络。

主要功能

界面采用「来源 — 列表 — 详情」三栏布局，覆盖 daemon 运行的所有资源：

• Docker：容器、镜像、卷、网络管理。容器按 Compose 项目分组，每个容器可查看信息、流式日志、交互式终端，以及合并只读 ~/ArcBox/docker 导出层的文件浏览器。
• Kubernetes：查看 daemon 托管的 k3s 集群中的 Pod 和 Service。
• Machines：完整的 Linux 虚拟机，可从发行版镜像创建、控制生命周期并连接交互式终端。
• Sandboxes：基于模板的一次性 microVM，支持端口、快照和事件日志。
• Activity：实时查看系统虚拟机与每个运行中容器的 CPU、内存和网络占用。
• 通知：容器崩溃告警可区分意外退出与近期的 Docker stop / 终止请求（含显式致命信号），可在「设置 → General」中配置。

所有视图都是事件驱动的：Docker、机器和沙箱的事件流驱动去抖更新，因此从 docker、abctl 或 kubectl 发起的操作无需手动刷新即可反映到界面。

从已有 Docker 环境迁移：保持 Docker Desktop 或 OrbStack 运行，选择 Help → Migrate from Docker Desktop or OrbStack…，确认资源数量、警告和需要替换的项后再执行迁移。支持的资源会被复制而不是从源环境删除；迁移期间请保持两边引擎开启。

存储健康检查：「设置 → Storage」分别展示数据卷与元数据卷状态，可用 Check Storage 停止工作负载并检查文件系统，或在检查通过后用 Recover Read-Write 恢复读写；诊断报告可在恢复前导出。

安装与使用

通过 Homebrew 安装：

brew install --cask arcbox

也可以从 Releases 下载 DMG，打开后把 ArcBox 拖入「应用程序」。应用自带 arcbox-daemon 运行时和 abctl CLI，并通过 Sparkle 自动更新，无需额外安装其他组件。

系统要求：Apple Silicon 芯片，macOS 15（Sequoia）或更高版本。

注意事项

• 本项目为原生 macOS 应用，不提供 Windows 或 Linux 版本。
• 迁移过程中退出应用会等待已连接的迁移完成；若退出时连接中断，ArcBox 会停止重连并保留运行时，因为迁移可能仍在复制数据，重试前请检查两边环境。
• 存储检查会停止工作负载并保留运行时磁盘、将存储置为写保护；只有恢复成功才会解除写保护。Reset Docker Data 只删除 Docker 资源，不修复文件系统。
• 旧版运行时会报告未知的存储健康状态；运行时断开时界面会保留上一次观测并标记为过期。
• README 声明代码以 MIT 或 Apache-2.0 双许可发布；ArcBox 名称、标识与截图属于品牌资产，不在源码许可范围内。

---

本作品整理自 GitHub 开源项目 arcboxlabs/arcbox-desktop，原作者 @arcboxlabs，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。