apple container

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

开始使用

系统要求

你需要一台配备 Apple 芯片的 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 版本之前，次要版本发布可能包含破坏性更改。