apple container

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

开始使用

系统要求

您需要一台配备 Apple silicon 的 Mac 才能运行 container。如需构建它，请参阅 BUILDING 文档。

container 支持 macOS 26，因为它利用了该版本中虚拟化和网络方面的新功能与增强特性。我们不支持更早版本的 macOS，并且 container 维护者通常不会处理无法在 macOS 26 上复现的问题。

初始安装

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

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

container system start

升级或降级

对于升级和降级，您都可以按照初始安装中的步骤手动下载并安装签名安装包，或者使用 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 版本之前，次版本发布可能包含破坏性变更。