在 Mac 上使用 Colima + Docker + Docker
Compose
,建议把常用命令分成四个层次来学习:

  1. Colima:管理 Mac 上的 Linux 虚拟机。
  2. Docker:管理容器、镜像、网络、数据卷。
  3. Docker Compose:管理多个容器组成的应用。
  4. Linux:进入容器或虚拟机后,管理文件、进程、网络、权限和服务。

Colima 常用命令

Colima 可以理解为:在 macOS 上启动一个轻量级 Linux 虚拟机,让 Docker
容器运行在 Linux 环境中。

命令 作用


colima start 启动 Colima
colima stop 停止 Colima
colima restart 重启 Colima
colima status 查看运行状态
colima list 查看所有 Profile
colima delete 删除 Colima 实例
colima ssh 进入 Colima Linux 虚拟机
colima version 查看版本

启动 Colima

1
colima start

指定 CPU、内存、磁盘:

1
2
3
4
colima start \\
--cpus 2 \\
--memory 4 \\
--disk 20

查看状态

1
colima status

进入 Linux 虚拟机

1
colima ssh

进入之后可以使用 Linux 命令:

1
2
3
4
uname -a
df -h
free -h
ps aux

停止和重启

1
2
colima stop
colima restart

查看 Docker Context

1
docker context ls

切换到 Colima:

1
docker context use colima

查看当前 Context:

1
docker context show

Docker 常用命令

Docker 主要管理四种资源:

  • Image:镜像,相当于容器的模板。
  • Container:容器,镜像运行后的实例。
  • Network:容器网络。
  • Volume:数据卷,持久化存储数据。

镜像管理

命令 作用


docker images 查看本地镜像
docker pull nginx 下载镜像
docker push 上传镜像
docker rmi 镜像名 删除镜像
docker image inspect nginx 查看镜像详细信息
docker image prune 清理无用镜像
docker image ls 查看镜像列表

示例:

1
2
3
docker pull apache/kafka:4.1.2
docker images
docker image inspect apache/kafka:4.1.2

容器管理(最常用)

命令 作用


docker ps 查看运行中的容器
docker ps -a 查看所有容器
docker run 创建并启动容器
docker start 启动已存在的容器
docker stop 停止容器
docker restart 重启容器
docker rm 删除容器
docker logs 查看容器日志
docker inspect 查看容器详情
docker exec 进入运行中的容器
docker stats 查看容器资源使用情况
docker top 查看容器内部进程

创建容器

1
2
3
4
docker run -d \\
--name nginx \\
-p 8080:80 \\
nginx

参数解释:

  • -d:后台运行。
  • --name:容器名称。
  • -p 8080:80:Mac 的 8080 端口映射到容器 80 端口。
  • nginx:使用的镜像。

查看容器

1
2
docker ps
docker ps -a

查看日志

1
2
3
4
docker logs nginx
docker logs -f nginx
docker logs --tail 100 nginx
docker logs -f --tail 100 nginx
  • -f:持续跟踪日志。
  • --tail 100:只看最后 100 行。

进入容器

1
docker exec -it nginx bash

如果没有 bash:

1
docker exec -it nginx sh

停止、启动、删除

1
2
3
4
docker stop nginx
docker start nginx
docker restart nginx
docker rm -f nginx

查看容器资源

1
2
docker stats
docker stats nginx

Docker 网络管理

命令 作用


docker network ls 查看网络
docker network create my-net 创建网络
docker network inspect my-net 查看网络详情
docker network connect 将容器接入网络
docker network disconnect 将容器移出网络
docker network rm 删除网络

示例:

1
2
3
docker network create my-net
docker network ls
docker network inspect my-net

Docker Volume 数据卷管理

命令 作用


docker volume ls 查看数据卷
docker volume create 创建数据卷
docker volume inspect 查看数据卷详情
docker volume rm 删除数据卷
docker volume prune 清理未使用的数据卷

示例:

1
2
3
docker volume create mysql-data
docker volume ls
docker volume inspect mysql-data

注意: 删除 Volume
可能导致持久化数据丢失,执行前先确认数据是否还需要。


Docker Compose 常用命令

Docker Compose 主要解决一个问题:

一个项目可能需要同时启动 MySQL、Redis、Kafka、Nacos、Spring
Boot,如何一次性管理它们?

通过 docker-compose.yml 文件描述所有服务。

现在推荐使用 Docker Compose V2,也就是 docker compose(中间有空格)。

项目启动和停止

命令 作用


docker compose up 创建并启动服务
docker compose up -d 后台启动
docker compose down 停止并删除容器、网络
docker compose stop 停止服务,不删除容器
docker compose start 启动已经存在的服务
docker compose restart 重启服务
docker compose pause 暂停服务
docker compose unpause 恢复服务

常用:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 后台启动全部服务
docker compose up -d

# 启动指定服务
docker compose up -d kafka

# 停止全部服务
docker compose stop

# 重启 Kafka
docker compose restart kafka

# 停止并删除容器、网络
docker compose down

查看服务状态

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 查看所有服务
docker compose ps

# 查看服务日志
docker compose logs

# 持续查看日志
docker compose logs -f

# 查看 Kafka 日志
docker compose logs -f kafka

# 查看最近 100 行
docker compose logs --tail 100 kafka

# 查看配置解析后的最终内容
docker compose config

构建和更新

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 构建镜像
docker compose build

# 强制重新构建
docker compose build --no-cache

# 拉取镜像
docker compose pull

# 拉取并启动
docker compose up -d --pull always

# 重新创建容器
docker compose up -d --force-recreate

进入 Compose 服务

1
docker compose exec kafka bash

如果容器没有 bash:

1
docker compose exec kafka sh

执行容器内的命令:

1
2
3
4
docker compose exec kafka \\
/opt/kafka/bin/kafka-topics.sh \\
--bootstrap-server localhost:9092 \\
--list

指定 Compose 文件

1
docker compose -f docker-compose.yml up -d

多个配置文件:

1
2
3
4
docker compose \\
-f docker-compose.yml \\
-f docker-compose-dev.yml \\
up -d

指定项目名称:

1
docker compose -p my-project up -d

Docker Compose 实战目录

假设有一个 Kafka 项目:

1
2
3
4
~/docker/kafka/
├── docker-compose.yml
├── config/
└── data/

进入目录:

1
cd ~/docker/kafka

常用操作:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 启动 Kafka
docker compose up -d

# 查看状态
docker compose ps

# 查看日志
docker compose logs -f kafka

# 进入 Kafka
docker compose exec kafka bash

# 停止
docker compose stop

# 重启
docker compose restart kafka

# 删除容器和网络
docker compose down

一个非常重要的区别:

命令 是否删除容器 是否删除 Volume


docker compose stop 否 否
docker compose down 是 否
docker compose down -v 是 是

down -v 可能删除数据库持久化数据,谨慎使用。


Linux 常用命令

Linux 命令是使用 Docker 时最需要掌握的部分。进入容器:

1
docker exec -it kafka bash

实际上就是进入了容器内部的 Linux 环境。

文件和目录管理

命令 作用


pwd 查看当前目录
ls 查看文件
ls -l 详细查看文件
ls -la 查看所有文件,包括隐藏文件
cd 切换目录
mkdir 创建目录
mkdir -p 递归创建目录
touch 创建文件
cp 复制文件
mv 移动或重命名
rm 删除文件
rm -rf 强制递归删除
find 查找文件
tree 树形查看目录

示例:

1
2
3
4
5
6
7
8
pwd
ls -lah
mkdir -p /data/kafka/logs
touch app.log
cp app.log app-backup.log
mv app.log kafka.log
find /data -name "*.log"
tree /data

注意: rm -rf 是高风险命令,执行前确认路径。

文件内容查看

命令 作用


cat 查看文件全部内容
less 分页查看
more 分页查看
head 查看前几行
tail 查看最后几行
tail -f 实时查看日志
grep 搜索文本
wc -l 统计行数
vi / vim 编辑文件

常用排查:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 查看日志
cat app.log

# 查看前 20 行
head -n 20 app.log

# 查看最后 100 行
tail -n 100 app.log

# 实时跟踪日志
tail -f app.log

# 搜索 ERROR
grep "ERROR" app.log

# 忽略大小写搜索
grep -i "error" app.log

# 显示行号
grep -n "ERROR" app.log

# 统计 ERROR 数量
grep -c "ERROR" app.log

# 递归搜索目录
grep -rn "Exception" /var/log/

特别推荐:

1
tail -f app.log | grep --line-buffered ERROR

实时查看日志中的 ERROR。

Linux 进程管理

命令 作用


ps aux 查看所有进程
ps -ef 查看进程详细信息
top 实时查看进程
kill 发送信号
kill -9 强制终止进程
pgrep 根据名称查找进程
pstree 查看进程树
nohup 让进程不依赖终端退出

示例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 查看所有进程
ps aux

# 查找 Java 进程
ps aux | grep java

# 根据进程名称查询 PID
pgrep -af java

# 终止进程
kill 1234

# 强制终止
kill -9 1234

# 实时查看资源
top

注意:

  • kill PID 默认发送 SIGTERM,给进程机会正常退出。
  • kill -9 PID 发送 SIGKILL,无法执行正常清理逻辑。

Linux 网络管理

这是后端开发和排查 Docker 网络问题时最重要的一组命令。

命令 作用


ip addr 查看 IP 地址
ip route 查看路由
ip link 查看网络接口
ping 测试网络连通性
curl 发送 HTTP 请求
wget 下载文件
ss -tunlp 查看网络连接和监听端口
netstat -tunlp 查看端口(需要安装)
nslookup DNS 查询
dig DNS 查询
traceroute 路由追踪

示例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 查看 IP
ip addr

# 查看路由
ip route

# 测试网络
ping 8.8.8.8

# 测试 DNS
nslookup registry-1.docker.io

# 查看监听端口
ss -tunlp

# 查看 9092 端口
ss -tunlp | grep 9092

# 测试 Kafka 端口
nc -zv localhost 9092

# 测试 HTTP 接口
curl -v http://localhost:8080

# 只查看 HTTP 响应头
curl -I http://localhost:8080

特别理解一下:

1
ss -tunlp

参数含义:

  • -t:TCP。
  • -u:UDP。
  • -n:数字显示,不解析名称。
  • -l:只显示监听状态。
  • -p:显示对应进程。

Linux 磁盘和内存

命令 作用


df -h 查看磁盘使用情况
du -sh 查看目录大小
du -h 查看文件大小
free -h 查看内存
lsblk 查看块设备
mount 查看挂载
uptime 查看系统运行时间

示例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 磁盘使用率
df -h

# 查看当前目录大小
du -sh .

# 查看 Docker 数据目录大小
du -sh /var/lib/docker

# 查看内存
free -h

# 查看系统运行时间
uptime

Linux 用户和权限

命令 作用


whoami 当前用户
id 用户身份信息
sudo 使用管理员权限
su 切换用户
chmod 修改权限
chown 修改所有者
groups 查看用户组

示例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 查看当前用户
whoami

# 查看权限
ls -l

# 修改文件权限
chmod 755 startup.sh

# 修改文件所有者
chown root:root startup.sh

# 管理员执行
sudo systemctl status nginx

权限 755 的含义:

对象 数值 权限


所有者 7 rwx
所属组 5 r-x
其他用户 5 r-x

Linux 服务管理

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 查看服务状态
systemctl status nginx

# 启动服务
systemctl start nginx

# 停止服务
systemctl stop nginx

# 重启服务
systemctl restart nginx

# 开机自启
systemctl enable nginx

# 查看系统日志
journalctl -u nginx

# 实时查看服务日志
journalctl -u nginx -f

注意:并不是所有 Docker 容器都运行 systemd。很多容器只有一个主进程,没有
systemctl。在这种情况下,应通过 Docker 管理容器生命周期。


macOS 与 Linux 命令的区别

你是在 Mac 上运行 Colima,所以要区分三个环境:

macOS 本机终端

1
2
3
brew install colima docker docker-compose
colima start
docker ps

管理 Colima 和 Docker 客户端。

Colima Linux 虚拟机

1
2
3
colima ssh
uname -a
df -h

管理 Docker 运行环境。

Docker 容器内部

1
2
3
docker exec -it kafka bash
ps aux
ls -lah

管理具体应用运行环境。

几个容易混淆的地方:

命令 macOS Linux


查看 IP ifconfig ip addr
查看进程 ps aux ps aux
查看端口 lsof -i ss -tunlp
查看内存 vm_stat free -h
查看磁盘 df -h df -h
包管理 brew apt / yum
服务管理 launchctl systemctl(适用时)


Docker 常见故障排查命令

这部分建议重点掌握。

Docker 无法连接

1
2
3
4
5
colima status
docker context ls
docker context show
docker version
docker info

如果 Docker 无法连接:

1
2
3
colima start
docker context use colima
docker ps

容器启动失败

1
2
3
4
docker ps -a
docker logs 容器名称
docker inspect 容器名称
docker stats

端口冲突

例如 Kafka 的 9092 端口无法启动:

1
2
3
4
5
# Mac 上检查端口
lsof -i :9092

# Linux 中检查端口
ss -tunlp | grep 9092

Docker DNS 解析失败

可以分层排查:

1
2
3
4
5
6
7
8
9
# Mac 本机
nslookup registry-1.docker.io

# Colima 虚拟机
colima ssh -- nslookup registry-1.docker.io

# 容器内部
docker exec -it kafka sh
nslookup registry-1.docker.io

这样可以区分是 Mac、Colima 虚拟机,还是容器内部的 DNS 问题。

Docker 清理磁盘

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 查看 Docker 磁盘使用
docker system df

# 清理无用容器
docker container prune

# 清理无用镜像
docker image prune

# 清理无用网络
docker network prune

# 清理未使用的构建缓存
docker builder prune

# 清理未使用的资源
docker system prune

注意: 不要随意执行
docker system prune -a --volumes,它可能删除你还需要的镜像和数据卷。


日常开发最值得记住的命令清单

Colima

1
2
3
4
5
colima start
colima stop
colima restart
colima status
colima ssh

Docker

1
2
3
4
5
6
7
8
docker ps -a
docker images
docker pull nginx
docker logs -f kafka
docker exec -it kafka bash
docker restart kafka
docker stats
docker inspect kafka

Docker Compose

1
2
3
4
5
6
docker compose up -d
docker compose down
docker compose ps
docker compose logs -f
docker compose restart kafka
docker compose exec kafka bash

Linux

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
pwd
ls -lah
cd
mkdir -p
cp
mv
rm
cat
tail -f
grep -rn
ps aux
top
df -h
du -sh
ip addr
ss -tunlp

建议的学习顺序

结合 Kafka、Nacos、Spring Boot 技术栈,建议按下面顺序学习:

  1. Colima:理解 Mac 如何运行 Linux 虚拟机。
  2. Docker:理解镜像、容器、网络、数据卷。
  3. Docker Compose:学会部署 Kafka、Redis、MySQL、Nacos。
  4. Linux:理解进程、端口、网络、文件权限、日志。
  5. Docker 网络:理解容器之间如何通过服务名通信。
  6. Linux 排错:掌握 DNS、端口占用、磁盘、内存和进程排查。

核心区别:

  • Colima 管理本机 Linux 虚拟机。
  • Docker 管理容器和镜像等资源。
  • Docker Compose 管理一组有关联的容器服务。
  • Linux 命令用于管理虚拟机或容器内部的操作系统环境。

下一步可以基于现有的 ~/docker/backend/,从 Mac 终端启动 Colima,使用
Docker Compose 部署 Kafka、Redis、MySQL,再进入 Linux
容器排查端口、DNS、日志、进程和磁盘问题。这样能把四类命令串成一套完整的后端开发运维技能。