Ubuntu 20.04 装完 Docker 后容器起不来,这确实是很多新手(甚至老手)容易踩的坑。别慌,这个问题通常不是 Docker 本身坏了,而是环境配置、权限或者镜像源的问题。
我按排查优先级从高到低给你梳理一下,照着做基本能解决 90% 的情况。
第一步:看日志,别瞎猜
首先,你要知道具体是哪个容器挂了,以及为什么挂。不要只看 docker ps 显示状态为 Exited,那只是结果,不是原因。
执行以下命令查看最近失败的容器日志:
# 查看最近一个失败的容器日志
docker logs <container_id>
# 或者查看所有容器的简要状态,找出 STATUS 为 Exited 的那个
docker ps -a
常见日志报错及对策:
-
Permission denied / PermissionError:
- 原因:容器内进程没有权限访问主机文件或资源。
- 解决:检查挂载卷(volume)的文件权限。如果是宿主机目录映射到容器,确保宿主机文件权限正确(比如
chmod 755)。如果在非 root 用户下运行,可能需要加--user参数或修改/etc/docker/daemon.json中的userns-remap(不推荐新手用这个,容易搞乱权限)。
-
OSError: [Errno 98] Address already in use:
- 原因:端口冲突。你启动的容器占用的端口(如 80, 3306, 5432)已经被其他进程占用了。
- 解决:用
netstat -tlnp或lsof -i :<port>查哪个进程占了端口,杀掉它或改容器端口映射。
-
Connection refused / Cannot connect to the Docker daemon:
- 原因:Docker 服务本身没起来,或者当前用户没有权限操作 Docker socket。
- 解决:先确认 Docker 服务状态:
systemctl status docker。如果没启动,sudo systemctl start docker。另外,如果你是非 root 用户,需要把自己加入 docker 组:sudo usermod -aG docker $USER,然后重新登录终端。
第二步:检查 Ubuntu 20.04 特有的网络问题(最常见!)
Ubuntu 20.04 默认使用 systemd-networkd 或 NetworkManager,而 Docker 默认创建的 docker0 网桥可能会和系统网络管理工具冲突,导致容器无法获取 IP 或无法联网。
现象:容器能创建,但 ping 不通网络,或者容器内部 IP 分配异常。
解决方案 A:禁用 Netfilter 对 bridge 的检查(临时测试)
有些情况下,iptables 规则冲突会导致数据包被丢弃。你可以尝试关闭这个检查来验证是否是网络问题:
sudo sysctl net.bridge.bridge-nf-call-iptables=0
sudo sysctl net.bridge.bridge-nf-call-ip6tables=0
如果关掉后容器能通了,说明是 iptables 问题。但这只是临时方案,永久修复需要配置 Docker 守护进程。
解决方案 B:配置 Docker 自定义网络(推荐)
不要用默认的 bridge 网络,创建一个自定义网络,这样更稳定:
# 创建自定义网络
docker network create my-net
# 启动容器时指定网络
docker run --network my-net -d <image_name>
解决方案 C:检查防火墙(UFW)
Ubuntu 默认开启了 UFW 防火墙。虽然 Docker 会自动处理一些规则,但有时会被干扰。
# 查看 UFW 状态
sudo ufw status
# 如果启用了,尝试暂时关闭测试
sudo ufw disable
# 如果此时容器能通,再重新启用并添加允许规则
sudo ufw enable
sudo ufw allow in on docker0
第三步:内核模块缺失(overlay2 存储驱动问题)
Docker 默认使用 overlay2 作为存储驱动,这需要 Linux 内核支持 overlay 文件系统。Ubuntu 20.04 的内核版本较新(5.4),通常没问题,但在某些虚拟机环境或定制内核中可能缺失。
检查方法:
cat /proc/filesystems | grep overlay
如果没有输出,说明内核不支持 overlay。
解决方案:
-
安装必要的内核模块:
sudo apt-get install linux-image-extra-virtual(注意:这个包在较新的 Ubuntu 版本中可能已被移除或合并,如果是标准桌面版服务器,通常不需要。)
-
降级存储驱动(不推荐,性能差):
编辑/etc/docker/daemon.json,添加:{ "storage-driver": "vfs" }然后重启 Docker:
sudo systemctl restart docker。
警告:VFS 驱动性能极差,仅用于紧急测试,生产环境千万别用。
第四步:Docker Compose 版本与语法兼容性问题
如果你是用 docker-compose up 启动的,Ubuntu 20.04 自带的旧版 Docker Compose(v1.x)可能与新版 Docker Engine(v20+)有兼容性问题。
解决方案:
-
卸载旧的 Docker Compose:
sudo apt-get remove docker-compose -
安装最新的 Docker Compose V2(插件形式):
sudo apt-get update sudo apt-get install docker-compose-plugin -
使用新命令:
现在应该用docker compose up(注意中间有空格,是子命令而不是独立二进制文件)。
第五步:镜像拉取失败(国内网络问题)
如果你的容器启动瞬间就退出,且日志显示 pulling image failed 或超时,那就是网络问题。
解决方案:
配置阿里云或腾讯云镜像提速器。
-
打开
/etc/docker/daemon.json:sudo nano /etc/docker/daemon.json -
添加以下内容(以阿里云为例,需替换为你自己的提速地址):
{ "registry-mirrors": ["https://your-code.mirror.aliyuncs.com"] } -
重启 Docker:
sudo systemctl daemon-reload sudo systemctl restart docker
总结排查清单
- 先看日志:
docker logs <container_id>,这是最直接的线索。 - 再看服务:
systemctl status docker,确保 Docker 引擎活着。 - 三看网络:是不是端口冲突?是不是 UFW 防火墙拦截?试试
docker network create。 - 四看权限:你是不是非 root 用户?有没有
sudo?有没有加进 docker 组? - 五看镜像:是不是因为国内网络拉不下来基础镜像?配个镜像提速器。
大多数情况下,日志里的错误信息已经指明了方向。把 docker logs 的输出贴出来,基本就能定位问题了。
云技术博客