Docker 新手必须掌握的八个命令

引言

Docker 的命令很多，但日常真正高频使用的其实就八个。先把这八个练熟，就能覆盖启动、查看、进入容器、打包、清理这些最常见的场景。

下面按实际使用流程排列，示例都基于 Linux 环境。

一、docker run：把容器跑起来

这是最重要的一个。新手最常忘记 -d（后台运行），导致终端一关容器就停。

docker run -d \
  --name myapp \
  -p 8080:80 \
  -v /data/app:/usr/share/nginx/html \
  --restart unless-stopped \
  nginx:alpine

几个参数的含义：

• -d：后台运行
• --name：起个名字，后面操作就不用记 ID
• -p 宿主机端口:容器端口：端口映射
• -v 宿主机目录:容器目录：挂载数据，容器删了数据还在
• --restart unless-stopped：开机自动拉起

新手必踩的坑：不加 -v 挂载，容器一删数据全丢。

二、docker ps：看清楚在跑什么

docker ps              # 运行中的容器
docker ps -a           # 所有容器（含已停止）
docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

第三种写法输出清爽，排查时很好用。当你发现端口冲突或不清楚别人部署了什么时，先跑这个。

三、docker logs：排错的第一入口

容器起不來或行为异常，第一件事一定是看日志。

docker logs myapp              # 看历史日志
docker logs -f myapp           # 持续跟踪
docker logs --tail 100 myapp   # 只看最后 100 行
docker logs -f --tail 50 myapp # 组合使用，最常用

绝大多数"容器起不来"的问题，日志里都写过原因——配置错误、端口占用、依赖连不上，一眼就能看出来。

四、docker exec：进入容器内部

docker exec -it myapp sh       # Alpine 镜像用 sh
docker exec -it myapp bash     # Ubuntu/CentOS 镜像用 bash

用于临时查看文件、验证配置。但要牢记一条原则：容器应当是无状态的，别在里面改配置当持久存储用——容器一旦重建，修改就没了。

只想执行一条命令也可以：

docker exec myapp nginx -t     # 校验 nginx 配置

五、docker build：把代码打成镜像

docker build -t myapp:1.0 .
docker build -t myapp:1.0 -f Dockerfile.prod .

注意最后的 . 是构建上下文路径，别漏。同时建议：

• 写 .dockerignore：避免把 node_modules、.git 塞进镜像
• 版本号要变：别一直用 latest，否则分不清线上跑的是哪一版

六、镜像与清理：别让磁盘悄悄满了

docker images                  # 列出镜像
docker rmi myapp:1.0           # 删除指定镜像
docker system df               # 看占用
docker system prune -a         # 清理无用镜像/容器/网络

docker system prune -a 要谨慎：它会删掉所有未被容器引用的镜像，生产环境执行前确认没有备用的老版本。

很多服务器磁盘告警，最后查出来都是 Docker 的悬空镜像和日志堆积。

七、容器的生命周期操作

docker stop myapp       # 优雅停止
docker start myapp      # 启动已存在的容器
docker restart myapp    # 重启
docker rm -f myapp      # 强制删除

记住一个对应关系：run = 创建并启动新容器，start = 启动已存在的。重复执行 run 会因为名字冲突而报错，这点新手经常困惑。

八、docker compose：多容器一把梭

单个容器还能手动 run，一旦涉及应用 + 数据库 + 缓存，就必须用编排：

docker compose up -d        # 后台启动所有服务
docker compose down         # 停止并移除
docker compose logs -f      # 看全部日志
docker compose ps           # 看服务状态
docker compose restart web  # 重启单个服务

注意新版 Docker 是 docker compose（子命令），老环境是 docker-compose（带横杠）。两者用法基本一致。

排错顺序速查

容器出问题时，按这个顺序走，基本不会乱：

1. docker ps -a —— 看它在不在、状态是什么
2. docker logs --tail 100 —— 看它为什么说不出话
3. docker exec -it 进去 —— 验证配置是否如你所想
4. 检查 -p 映射与 -v 挂载 —— 端口和目录是否正确
5. docker inspect —— 看完整配置细节

结语

Docker 上手的关键不是背命令，而是理解三件事：镜像是模板、容器是实例、数据要靠挂载留下来。

把这八个命令练到不用查文档的程度，日常开发和部署的效率会有明显提升。剩下的进阶内容（网络、多阶段构建、健康检查），等你踩到实际需求再学也不迟。