Docker容器排错实战｜常见问题一网打尽
用Docker这几年，各种奇葩问题都遇到过。整理出来，下次再遇到直接查。
一、容器无法启动
1.1 查看启动日志
查看容器日志
docker logs <container_id>
实时查看
docker logs -f <container_id>
### 1.2 常见原因
**原因1：端口被占用**
错误信息
Error: bind: address already in use
解决：查看端口占用
lsof -i :80
netstat -tlnp | grep 80
**原因2：权限问题**
错误信息
Permission denied
解决：修改目录权限
chmod -R 777 /data/xxx
### 1.3 进入失败的容器调试
改用交互模式启动
docker run -it --entrypoint /bin/sh
---
## 二、容器内网络问题
### 2.1 容器无法访问外网
测试网络
docker run --rm alpine ping -c 3 8.8.8.8
如果ping不通，检查：
1. 宿主机能否上网
2. Docker网络配置
3. 重启Docker
systemctl restart docker
### 2.2 容器间无法通信
同一网络下的容器才能互相访问
docker network create mynet
docker run --network mynet --name app1 ...
docker run --network mynet --name app2 ...
可以用容器名访问
docker exec app1 ping app2
### 2.3 DNS解析失败
解决：指定DNS
docker run --dns 8.8.8.8 --dns 114.114.114.114 ...
---
## 三、存储/挂载问题
### 3.1 挂载目录权限问题
解决1：指定用户
docker run -u $(id -u)😒(id -g) -v /data:/data ...
解决2：SELinux问题（CentOS）
docker run -v /data:/data:Z ...
### 3.2 磁盘空间不足
查看Docker占用空间
docker system df
清理方案
docker container prune # 清理停止的容器
docker image prune -a # 清理无用镜像
docker volume prune # 清理无用数据卷
docker system prune -a # 一键清理所有
---
## 四、镜像问题
### 4.1 拉取镜像失败
配置镜像加速器
cat > /etc/docker/daemon.json << EOF
{
"registry-mirrors": [
"https://mirror.ccs.tencentyun.com"
]
}
EOF
systemctl daemon-reload
systemctl restart docker
### 4.2 镜像太大
优化方案：
1. 使用alpine基础镜像
FROM alpine:3.18
2. 多阶段构建
FROM golang:1.21 AS builder
RUN go build -o app
FROM alpine:3.18
COPY --from=builder /app /app
---
## 五、容器资源问题
### 5.1 容器占用CPU过高
查看容器资源使用
docker stats
限制CPU
docker run --cpus=2 ...
### 5.2 OOM Killed
查看是否被OOM杀掉
docker inspect
解决：增加内存限制
docker run -m 1g ...
---
## 六、深入理解Docker网络
### 6.1 Docker网络模式
| 模式 | 特点 | 适用场景 |
|------|-----|---------|
| bridge | 默认模式，NAT转发 | 大多数场景 |
| host | 共享宿主机网络栈 | 高性能需求 |
| none | 无网络 | 安全隔离 |
| container | 共享其他容器网络 | Pod模式 |
### 6.2 容器间通信原理
容器A (172.17.0.2) → docker0网桥 → 容器B (172.17.0.3)
查看网桥
brctl show docker0
查看veth pair
ip link show | grep veth
### 6.3 DNS解析流程
容器内DNS查询流程：
- /etc/resolv.conf → 127.0.0.11（Docker内置DNS）
- Docker DNS → 容器名解析
- 未命中 → 转发到宿主机DNS
---
## 七、容器资源限制原理
### 7.1 Cgroups限制
```bash
# CPU限制（--cpus=2）
cat /sys/fs/cgroup/cpu/docker/<container_id>/cpu.cfs_quota_us
# 内存限制（-m 512m）
cat /sys/fs/cgroup/memory/docker/<container_id>/memory.limit_in_bytes
7.2 OOM Killer触发条件
当容器内存使用达到限制时：
1. 内核尝试回收页面缓存
2. 回收失败 → 触发OOM Killer
3. 选择得分最高的进程kill
# 查看OOM得分
cat /proc/<pid>/oom_score
八、远程服务器排查
如果Docker服务器在公司内网，在家怎么排查？
我用星空组网把本地和服务器连起来，然后直接SSH上去操作：
# 组网后直接连
ssh root@192.168.188.10
docker logs xxx
docker exec -it xxx /bin/sh
比VPN稳定，也不用申请跳板机权限，排查效率高很多。
十、常用排查命令汇总
# 容器状态
docker ps -a # 所有容器
docker inspect <container> # 容器详情
docker logs <container> # 容器日志
# 资源使用
docker stats # 资源统计
docker system df # 磁盘占用
# 进入容器
docker exec -it <container> /bin/bash
# 清理
docker system prune -a # 清理所有
八、快速排查流程
遇到容器问题，按这个顺序排查：
1. docker ps -a → 看容器状态
2. docker logs xxx → 看启动日志
3. docker inspect xxx → 看详细配置
4. docker exec -it xxx /bin/sh → 进入容器调试
5. docker stats → 看资源使用
总结
Docker排错核心思路：
| 问题类型 | 排查方向 |
|---|---|
| 启动失败 | 看日志、检查端口、检查权限 |
| 网络问题 | 检查网络模式、DNS、防火墙 |
| 存储问题 | 检查权限、SELinux、磁盘空间 |
| 性能问题 | docker stats、限制资源 |
记住：docker logs是第一步
有问题评论区交流~
浙公网安备 33010602011771号