arcbox

环境要求

• macOS 系统（README 明确说明是面向 macOS 的容器与虚拟机运行时）
• 使用 Homebrew 安装时需已安装 Homebrew
• 使用脚本安装时需能访问 https://get.arcbox.dev
• 运行容器前需本机可执行 docker 命令

安装与启动步骤

1. 1安装 ArcBox

   在 macOS 上二选一：Homebrew cask 或官方安装脚本，二者任选其一执行即可完成安装。

   brew install --cask arcboxlabs/tap/arcbox
   curl -fsSL https://get.arcbox.dev | bash

   复制

2. 2启动守护进程

   ArcBox 采用单守护进程架构，先启动 daemon，后续容器、沙箱、虚拟机都跑在它之上。

   abctl daemon start

   复制

3. 3启用 Docker 兼容

   开启 Docker 兼容层后，才能直接用 docker 命令操作 ArcBox 运行时。

   abctl docker enable

   复制

4. 4运行测试容器

   用标准 docker 命令拉取并后台运行 nginx，把容器 80 端口映射到本机 8080。

   docker run -d -p 8080:80 nginx

   复制

5. 5访问验证

   请求本机 8080 端口，若返回 nginx 页面说明容器与端口映射均正常。

   curl http://localhost:8080

   复制

6. 6检查运行时状态

   abctl doctor 自检运行时；abctl --help 可查看全部可用子命令。

   abctl doctor
   abctl --help

   复制

7. 7可选：迁移旧环境

   从 OrbStack 或 Docker Desktop 迁移镜像、卷、网络与容器，建议先 dry-run 预演不改动任何东西。

   abctl migrate from orbstack --dry-run
   abctl migrate from orbstack
   abctl migrate from docker-desktop

   复制

8. 8可选：查看资源占用

   abctl top 流式显示 System VM 的 CPU/内存/磁盘/网络，有容器时还会附加每容器表格。

   abctl top
   abctl disk usage

   复制

如何确认成功

执行 abctl doctor 检查运行时无异常，且 curl http://localhost:8080 能返回 nginx 页面，说明守护进程、Docker 兼容与端口映射都正常。

常见问题

注意事项

• ArcBox 目前处于公开测试（public beta）阶段。
• 官方说明为 macOS 上的 Docker Desktop / OrbStack 开源替代品，非 macOS 环境不适用。
• 沙箱、Linux 机器、macOS 客户机等能力通过 abctl sandbox / machine / macos 等子命令提供，本教程未逐条展开。
• 本地运行的沙箱与 ArcBox Platform 云端是同一套原语，本地代码可直接扩展到云端。