如果你只是想在 macOS 上稳定跑起 Docker 引擎、执行 docker/docker compose、配合开发工具完成日常容器开发,那么 Colima 是一个很省心的选择:它用轻量虚拟机把容器运行时跑起来,日常体验更接近“装好就用”。
项目主页与文档:https://github.com/abiosoft/colima
建议先确认你已安装 Homebrew(如果没有,可参考):https://brew.sh/
安装 Colima 与 Docker CLI:
brew install colima docker
如果你需要使用 Docker Compose(推荐新语法 docker compose),可以安装 compose 插件:
brew install docker-compose
首次启动可以顺手把 CPU/内存/磁盘设到你习惯的值(示例):
colima start --cpu 4 --memory 8 --disk 60
查看运行状态:
colima status
确认 Docker CLI 连接到正确的上下文(不同版本表现略有差异,常用检查方式):
docker context ls
试跑一个容器验证链路(能拉取镜像并输出内容即可):
docker run --rm hello-world
1) 拉取镜像:
docker pull nginx:latest
2) 启动并映射端口:
docker run -d --name demo-nginx -p 8080:80 nginx:latest
3) 查看运行中的容器:
docker ps
4) 停止并删除:
docker stop demo-nginx
docker rm demo-nginx
5) Compose 项目(在 docker-compose.yml 所在目录):
docker compose up -d
docker compose logs -f
更多 Docker 命令与参考:https://docs.docker.com/reference/
如果你用 VS Code 做开发,强烈建议把依赖环境放进 Dev Container,做到“换机不怕、拉仓即跑”。重点是让 VS Code 能访问到本机的 Docker 上下文(Colima 提供的 Docker 引擎)。
Dev Containers 文档:https://code.visualstudio.com/docs/devcontainers/containers
常见排查思路:
docker info 能正常返回;docker ps 能看到容器;再打开 VS Code 的 Dev Containers 扩展进行构建/进入容器即可。
1) 资源占用怎么调? 直接停止后按需重启并调整参数:
colima stop
colima start --cpu 6 --memory 12 --disk 80
2) 端口访问不通? 优先确认容器确实监听端口、以及你是否做了端口映射(例如 -p 8080:80)。
3) 要不要用图形化界面? 日常开发基本用 CLI + VS Code 足够;如果需要查看镜像/容器状态,可以再选你习惯的可视化工具,但保持“工具少而精”更不容易出问题。
https://github.com/abiosoft/colima