很多人在 macOS 上跑容器，主要诉求是：启动快、占用低、网络稳定、和日常的 docker/docker compose 兼容。OrbStack 的定位就是把这些体验做得更轻：界面简洁、虚拟化/文件共享更顺滑，适合把它当作“容器运行时 + 管理器”来用。
本文按“安装 -> 迁移 -> 日常使用 -> 提效设置 -> 常见问题”的顺序写，你照着做就能把现有项目平滑搬过去。
工具官网：https://orbstack.dev
官方文档：https://docs.orbstack.dev
1) 打开官网下载安装包并安装，首次启动时按提示授予必要权限（网络扩展/后台运行等）。
2) 启动后你会看到容器、镜像、卷、网络等管理入口。此时先别急着迁移，建议先确认终端里 docker 命令可用。
在终端执行：
docker version
如果能正常输出客户端/服务端信息，说明运行时已就绪。
迁移建议分三类看：
1) 代码仓库/Compose 文件：这类不需要“迁移”，你直接在项目目录运行即可。
2) 镜像：如果你平时主要从仓库拉取（例如 docker pull），那也不需要迁移；切换运行时后重新拉取即可。
3) 数据卷（volumes）：这是最需要谨慎的一类。最好先把关键服务的数据做一次备份，再切换运行时。对于数据库之类服务，优先用导出/导入方式迁移（例如导出 SQL/备份文件），而不是直接复制底层目录。
如果你使用 Compose，切换后常用命令仍然一致：
docker compose up -d
docker compose logs -f --tail=200
docker compose down
看运行中的容器：
docker ps
进入容器执行命令（以 bash 为例）：
docker exec -it <container_name> bash
查看镜像与清理未使用资源：
docker images
docker system prune
提示：清理命令会删除未使用资源，生产环境不要随便跑；本机开发也建议先确认是否会影响正在使用的卷/镜像。
1) 资源占用：如果你同时开着多个大型项目，建议按需调整 CPU/内存配置，避免后台长期占用过高。
2) 文件共享性能：前端/Node.js 项目对文件监听敏感，遇到热更新卡顿时，优先检查是否把项目目录放在合适的位置，并尽量避免把大量 node_modules 反复映射到容器里。
3) 端口与网络：项目访问不到时，先用 docker ps 确认端口映射是否存在；再确认服务监听地址是 0.0.0.0 而不是 127.0.0.1（容器内监听本地回环会导致外部无法访问）。
Q1：切换后原来的 Docker Desktop 要不要卸载？
可以先保留一段时间做对照测试。确认常用项目/Compose 都能稳定跑，再卸载也不迟。
Q2：我只想要命令行，不想要复杂 UI。
OrbStack 主要还是服务于命令行工作流，你完全可以把它当作提供 docker 服务端的轻量运行时，UI 只是辅助管理。
Q3：遇到某个镜像启动报错怎么办？
先用 docker logs 看错误，再对照官方文档的兼容性说明。必要时把镜像版本固定（tag pin），避免“拉到最新导致行为变化”。
