OrbStack：在 Mac 上运行容器与 Linux

适合谁

OrbStack 帮助开发者在 Mac 上运行 Docker 容器和 Linux 环境。容器把程序及运行依赖组织在一起，适合启动测试数据库、复现项目环境或构建软件。它提供图形管理界面，并兼容 Docker 命令行和 Compose 工作流。官方快速入门

如果只需要写文档、上网或安装普通 Mac 应用，暂时用不到它。它也不是用来运行任意 Windows 桌面软件的通用方案。容器、镜像和数据卷仍有学习成本，第一次使用应先分清“程序模板”“正在运行的实例”和“需要保留的数据”。

获取与费用

从 OrbStack 官方下载页 选择 Apple 芯片或 Intel 版本。核查时支持 macOS 14.0 及以后；旧教程中的最低系统要求可能已经过时。个人、非商业用途提供免费方案，商业用途需核对 Pro 或企业授权，具体价格与条款以 官方价格页 为准。

首次打开时，按提示准备运行环境。管理员授权可能用于安装命令行工具或设置 Docker socket 兼容链接，属于需要理解的系统变化；官方说明这些设置可以选择。不要把安装开发工具理解成必须开放全部磁盘或关闭系统安全保护。权限说明

第一次使用：运行一个短任务

本练习会下载一个公开示例镜像、创建临时容器，结束后移除该容器；镜像仍会留在本机。它不挂载个人文件夹、不发布服务端口。先阅读 终端基础，确保知道命令在哪里运行。

1. 打开 OrbStack，等待 Docker 环境就绪。如果已有 Docker Desktop 或其他容器环境，先记录自己正在使用的环境与重要服务。

2. 新开终端，运行以下查询，确认列表中存在 orbstack：

   docker context ls

3. 使用明确的目标环境运行示例：

   docker --context orbstack run --rm hello-world

4. 看到包含 Hello from Docker! 的输出后，再查看运行列表：

   docker --context orbstack ps

--context orbstack 指定这次命令操作的环境；run 创建并运行容器，--rm 在它退出后清理这个临时实例。因此这个短任务结束后不会一直出现在运行列表中，列表里仍可能有你之前的其他服务。OrbStack 的 Docker 环境、Docker 运行参数

如果提示找不到 Docker，检查命令行工具安装是否完成；如果连接不到引擎，先确认 OrbStack 正在运行；下载失败则检查镜像源、网络和代理。不要直接重置整个容器环境来修复一次下载问题。

文件、网络与恢复

容器隔离不代表可以任意运行陌生代码。把 Mac 目录挂载进去后，容器可能读写其中的文件；首次练习不共享文稿、SSH 密钥或整个个人目录。数据卷用于持久保存内容，删除容器和删除数据卷是不同操作。使用数据库时，应另做符合数据库一致性要求的备份。文件共享与卷

发布端口后，服务可能被局域网设备访问。以后学习 Web 服务时，先核对绑定地址与 OrbStack 的局域网暴露选项，避免把本地测试数据库意外开放出去。容器网络说明

停止不需要的容器可以减少资源占用。卸载或重置前先导出需要的数据，并确认能恢复；切换 Docker context 不会自动迁移旧环境的数据。不要照抄批量清理镜像和卷的命令。

练习与替代方案

再运行一次同样的短任务，观察已下载镜像如何复用，并解释为什么任务退出后没有长期运行的容器。成功标准是能说清资源存在哪里、哪些可以重建、哪些必须备份。需要公司统一工具链时优先遵循团队环境；比较 Docker Desktop、Colima 等方案时，再分别核查功能、维护成本与授权。