Apple Container 快速入门

Apple Container 快速入门

目录

1. 一句话了解 Apple Container

Apple Container（命令 container）是 Apple 开源的 macOS 容器工具：在 Apple 芯片 Mac 上把 Linux 容器跑在独立轻量级 VM 里（非传统「一个大 VM 里塞多容器」）。Swift 编写，OCI 镜像互通，底层依赖 Containerization 包，深度集成 Virtualization、vmnet、XPC、Launchd。

为什么用？

• VM 级隔离：每个容器独立 VM，安全与隐私优于共享内核方案
• 原生 macOS：与系统虚拟化、网络、钥匙串、统一日志集成
• 生态兼容：拉 Docker Hub / GHCR 镜像、Dockerfile + BuildKit 构建

2. 核心概念（CLI → APIServer → 轻量 VM）

#mermaid-svg-j15TRfYDmJmgC1nS{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-j15TRfYDmJmgC1nS .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-j15TRfYDmJmgC1nS .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-j15TRfYDmJmgC1nS .error-icon{fill:#552222;}#mermaid-svg-j15TRfYDmJmgC1nS .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-j15TRfYDmJmgC1nS .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-j15TRfYDmJmgC1nS .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-j15TRfYDmJmgC1nS .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-j15TRfYDmJmgC1nS .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-j15TRfYDmJmgC1nS .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-j15TRfYDmJmgC1nS .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-j15TRfYDmJmgC1nS .marker{fill:#333333;stroke:#333333;}#mermaid-svg-j15TRfYDmJmgC1nS .marker.cross{stroke:#333333;}#mermaid-svg-j15TRfYDmJmgC1nS svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-j15TRfYDmJmgC1nS p{margin:0;}#mermaid-svg-j15TRfYDmJmgC1nS .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-j15TRfYDmJmgC1nS .cluster-label text{fill:#333;}#mermaid-svg-j15TRfYDmJmgC1nS .cluster-label span{color:#333;}#mermaid-svg-j15TRfYDmJmgC1nS .cluster-label span p{background-color:transparent;}#mermaid-svg-j15TRfYDmJmgC1nS .label text,#mermaid-svg-j15TRfYDmJmgC1nS span{fill:#333;color:#333;}#mermaid-svg-j15TRfYDmJmgC1nS .node rect,#mermaid-svg-j15TRfYDmJmgC1nS .node circle,#mermaid-svg-j15TRfYDmJmgC1nS .node ellipse,#mermaid-svg-j15TRfYDmJmgC1nS .node polygon,#mermaid-svg-j15TRfYDmJmgC1nS .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-j15TRfYDmJmgC1nS .rough-node .label text,#mermaid-svg-j15TRfYDmJmgC1nS .node .label text,#mermaid-svg-j15TRfYDmJmgC1nS .image-shape .label,#mermaid-svg-j15TRfYDmJmgC1nS .icon-shape .label{text-anchor:middle;}#mermaid-svg-j15TRfYDmJmgC1nS .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-j15TRfYDmJmgC1nS .rough-node .label,#mermaid-svg-j15TRfYDmJmgC1nS .node .label,#mermaid-svg-j15TRfYDmJmgC1nS .image-shape .label,#mermaid-svg-j15TRfYDmJmgC1nS .icon-shape .label{text-align:center;}#mermaid-svg-j15TRfYDmJmgC1nS .node.clickable{cursor:pointer;}#mermaid-svg-j15TRfYDmJmgC1nS .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-j15TRfYDmJmgC1nS .arrowheadPath{fill:#333333;}#mermaid-svg-j15TRfYDmJmgC1nS .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-j15TRfYDmJmgC1nS .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-j15TRfYDmJmgC1nS .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-j15TRfYDmJmgC1nS .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-j15TRfYDmJmgC1nS .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-j15TRfYDmJmgC1nS .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-j15TRfYDmJmgC1nS .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-j15TRfYDmJmgC1nS .cluster text{fill:#333;}#mermaid-svg-j15TRfYDmJmgC1nS .cluster span{color:#333;}#mermaid-svg-j15TRfYDmJmgC1nS div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-j15TRfYDmJmgC1nS .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-j15TRfYDmJmgC1nS rect.text{fill:none;stroke-width:0;}#mermaid-svg-j15TRfYDmJmgC1nS .icon-shape,#mermaid-svg-j15TRfYDmJmgC1nS .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-j15TRfYDmJmgC1nS .icon-shape p,#mermaid-svg-j15TRfYDmJmgC1nS .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-j15TRfYDmJmgC1nS .icon-shape .label rect,#mermaid-svg-j15TRfYDmJmgC1nS .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-j15TRfYDmJmgC1nS .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-j15TRfYDmJmgC1nS .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-j15TRfYDmJmgC1nS :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

container CLI

XPC

APIServer

每容器一个轻量 VM

OCI 镜像 / 进程

与 Docker Desktop 等「共享 VM」对比：container 一容器一 VM，隔离更强，启动仍保持轻量。

3. 环境要求

维护方主要支持 macOS 26 上的问题复现。

4. 5 分钟上手

4.1 安装（推荐 .pkg）

从 GitHub Releases 下载签名 .pkg，安装到 /usr/local：

• /usr/local/bin/container — 主 CLI
• /usr/local/bin/container-apiserver — 后台守护进程

4.2 启动系统服务

container system start

首次可能提示安装默认 Linux 内核，按 Y 确认。验证：

container system status
container system version

4.3 跑第一个容器

container run –rm docker.io/python:alpine echo "Hello from container!"

run 会拉镜像、建 VM、配网络、执行命令；–rm 退出后自动删除容器。

4.4 后台运行 + 访问

container run –name my-web –detach –rm -p 127.0.0.1:8080:80 <你的镜像>
container ls
curl http://127.0.0.1:8080

container ls 可看到容器在 192.168.64.x 虚拟网段的 IP；-p 把本机端口转发进容器。

5. 常用命令速览

container –help
container ls -a
container –version

支持别名：ls≈list，rm≈delete。

6. 构建镜像与端口转发

Dockerfile 构建（BuildKit 跑在独立构建器 VM 内）：

container build -t my-app:latest -f Dockerfile .

常用 run 参数：

7. 常见问题

8. 下一步

• 官方：apple/container — docs/tutorials/start-here.md、BUILDING.md。
• 建议顺序：引导教程 → 架构概述 → 容器创建与运行时 → CLI 命令参考。