apple container

container 是一款工具，可用于在 Mac 上创建并运行 Linux 容器，使其像轻量级虚拟机一样工作。它使用 Swift 编写，并针对 Apple 芯片进行了优化。该工具生成并消费符合 OCI 标准的容器镜像，因此你可以从任何标准容器仓库拉取并运行镜像。你也可以将构建的镜像推送到这些仓库，并在其他任何兼容 OCI 的应用中运行这些镜像。container 使用 Containerization Swift 包进行底层容器、镜像和进程管理。

开始使用

系统要求

你需要一台配备 Apple 芯片的 Mac 才能运行 container。如需构建它，请参阅 BUILDING 文档。container 支持 macOS 26，因为它利用了该版本中虚拟化和网络方面的新功能与增强。我们不支持旧版本的 macOS，并且 container 维护者通常不会处理无法在 macOS 26 上重现的问题。

初始安装

从 GitHub 发布页面下载最新的 signed installer package for container。要安装该工具，请双击包文件并按照说明操作。在提示时输入管理员密码，以授予安装程序将文件安装到 /usr/local 下的权限。

使用以下命令启动系统服务：

container system start

升级或降级

对于升级和降级，你可以按照初始安装步骤手动下载并安装 signed installer package，或者使用 update-container.sh 脚本（已安装到 /usr/local/bin）。

如果你正在升级或降级，必须停止现有的 container：

container system stop

要升级到最新版本，只需运行以下命令：

/usr/local/bin/update-container.sh

要降级，你必须卸载现有的 container（-k 标志保留用户数据，-d 标志则删除用户数据）：

/usr/local/bin/uninstall-container.sh -k
/usr/local/bin/update-container.sh -v 0.3.0

使用以下命令启动系统服务：

container system start

卸载

使用 uninstall-container.sh 脚本（已安装到 /usr/local/bin）从系统中移除 container。

要同时移除工具和用户数据，请运行：

/usr/local/bin/uninstall-container.sh -d

要保留用户数据以便将来重新安装时可用，请运行：

/usr/local/bin/uninstall-container.sh -k

后续步骤

通过构建、运行和发布一个简单的 web 服务器镜像，参加 container 的 guided tour。
了解如何使用各种 container 功能。
阅读 container 的简要描述和技术概述。
浏览完整的命令参考。
在自己的开发系统上构建并运行 container。
查看项目 API 文档。

贡献

欢迎并鼓励对 container 做出贡献。请参阅我们的主要贡献指南以获取更多信息。

项目状态

container 项目目前正在积极开发中。其稳定性（无论是作为 Swift 包使用还是作为 container 工具）仅在小版本内得到保证，例如 0.1.1 和 0.1.2 之间。在达到 1.0.0 版本之前，次版本发布可能包含破坏性更改。