container

<!-- WEHUB_ZH_README -->
> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。  
> [English](./README.en.md) · [原始项目](https://github.com/apple/container) · [上游 README](https://github.com/apple/container/blob/HEAD/README.md)  
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

<h1>
  <img alt="Containerization 徽标" src="./assets/Containerization-Logo.png" width="70" valign="middle">
  &nbsp;container
</h1>

`container` 是一款工具，可用于在 Mac 上以轻量级虚拟机的方式创建和运行 Linux 容器。它使用 Swift 编写，并针对 Apple 芯片进行了优化。

该工具可消费并生成 [OCI 兼容的容器镜像](https://github.com/opencontainers/image-spec),，因此你可以从任何标准容器镜像仓库拉取并运行镜像。你也可以将构建的镜像推送到这些仓库，并在任何其他 OCI 兼容应用中运行这些镜像。

`container` 使用 [Containerization](https://github.com/apple/containerization) Swift 包来进行底层容器、镜像和进程管理。

![展示一些基本命令的入门视频](./docs/assets/landing-movie.gif)

## 快速开始

### 系统要求

你需要一台搭载 Apple 芯片的 Mac 才能运行 `container`。若要构建它，请参阅 [BUILDING](./BUILDING.md) 文档。

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

### 初次安装

从 [GitHub 发布页面](https://github.com/apple/container/releases). 下载 `container` 的最新签名安装包。

要安装该工具，请双击安装包文件并按说明操作。在提示时输入管理员密码，以授予安装程序将文件安装到 `/usr/local` 下的权限。

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

```bash
container system start
```

### 升级或降级

无论是升级还是降级，你都可以按照 [初次安装](#initial-install) 中的步骤手动下载并安装签名安装包，或使用 `update-container.sh` 脚本（安装于 `/usr/local/bin`）。

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

```bash
container system stop
```

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

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

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

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

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

```bash
container system start
```

### 卸载

使用 `uninstall-container.sh` 脚本（安装于 `/usr/local/bin`）从系统中移除 `container`。若要同时删除用户数据，请运行：

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

若要保留用户数据以便日后重新安装时仍可使用，请运行：

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

## 后续步骤

- 参加 [`container` 引导式导览](./docs/tutorials/start-here.md)，通过构建、运行并发布一个简单的 Web 服务器镜像。
- 了解如何 [使用 `container` 的各项功能](./docs/how-to.md)。
- 阅读 `container` 的简要说明与 [技术概览](./docs/technical-overview.md)。
- 浏览 [完整命令参考](./docs/command-reference.md)。
- 在你自己的开发系统上 [构建并运行](./BUILDING.md) `container`。
- 查看项目 [API 文档](https://apple.github.io/container/documentation/).

## 参与贡献

欢迎并鼓励为 `container` 做出贡献。更多信息请参阅我们的 [主要贡献指南](https://github.com/apple/containerization/blob/main/CONTRIBUTING.md)。

## 项目状态

container 项目目前处于积极开发中。无论是作为 Swift 包消费该项目，还是使用 `container` 工具，其稳定性仅在补丁版本之间得到保证，例如 0.1.1 与 0.1.2 之间。在我们发布 1.0.0 版本之前，次要版本发布可能包含破坏性变更。