努力
加油

Ubuntu 20.04安装Docker后无法启动容器怎么办?

Ubuntu 20.04 装完 Docker 后容器起不来,这确实是很多新手(甚至老手)容易踩的坑。别慌,这个问题通常不是 Docker 本身坏了,而是环境配置、权限或者镜像源的问题。

我按排查优先级从高到低给你梳理一下,照着做基本能解决 90% 的情况。

第一步:看日志,别瞎猜

首先,你要知道具体是哪个容器挂了,以及为什么挂。不要只看 docker ps 显示状态为 Exited,那只是结果,不是原因。

执行以下命令查看最近失败的容器日志:

# 查看最近一个失败的容器日志
docker logs <container_id>

# 或者查看所有容器的简要状态,找出 STATUS 为 Exited 的那个
docker ps -a

常见日志报错及对策:

  1. Permission denied / PermissionError:

    • 原因:容器内进程没有权限访问主机文件或资源。
    • 解决:检查挂载卷(volume)的文件权限。如果是宿主机目录映射到容器,确保宿主机文件权限正确(比如 chmod 755)。如果在非 root 用户下运行,可能需要加 --user 参数或修改 /etc/docker/daemon.json 中的 userns-remap(不推荐新手用这个,容易搞乱权限)。
  2. OSError: [Errno 98] Address already in use:

    • 原因:端口冲突。你启动的容器占用的端口(如 80, 3306, 5432)已经被其他进程占用了。
    • 解决:用 netstat -tlnp 或 lsof -i :<port> 查哪个进程占了端口,杀掉它或改容器端口映射。
  3. 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。

解决方案:

  1. 安装必要的内核模块:

    sudo apt-get install linux-image-extra-virtual

    (注意:这个包在较新的 Ubuntu 版本中可能已被移除或合并,如果是标准桌面版服务器,通常不需要。)

  2. 降级存储驱动(不推荐,性能差):
    编辑 /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+)有兼容性问题。

解决方案:

  1. 卸载旧的 Docker Compose:

    sudo apt-get remove docker-compose
  2. 安装最新的 Docker Compose V2(插件形式):

    sudo apt-get update
    sudo apt-get install docker-compose-plugin
  3. 使用新命令:
    现在应该用 docker compose up(注意中间有空格,是子命令而不是独立二进制文件)。


第五步:镜像拉取失败(国内网络问题)

如果你的容器启动瞬间就退出,且日志显示 pulling image failed 或超时,那就是网络问题。

解决方案:

配置阿里云或腾讯云镜像提速器。

  1. 打开 /etc/docker/daemon.json:

    sudo nano /etc/docker/daemon.json
  2. 添加以下内容(以阿里云为例,需替换为你自己的提速地址):

    {
      "registry-mirrors": ["https://your-code.mirror.aliyuncs.com"]
    }
  3. 重启 Docker:

    sudo systemctl daemon-reload
    sudo systemctl restart docker

总结排查清单

  1. 先看日志:docker logs <container_id>,这是最直接的线索。
  2. 再看服务:systemctl status docker,确保 Docker 引擎活着。
  3. 三看网络:是不是端口冲突?是不是 UFW 防火墙拦截?试试 docker network create。
  4. 四看权限:你是不是非 root 用户?有没有 sudo?有没有加进 docker 组?
  5. 五看镜像:是不是因为国内网络拉不下来基础镜像?配个镜像提速器。

大多数情况下,日志里的错误信息已经指明了方向。把 docker logs 的输出贴出来,基本就能定位问题了。