Ubuntu 系统 Docker 启动失败(iptables/nf\_tables)

Ubuntu 系统 Docker 启动失败(iptables/nf_tables)问题排查与修复详解

在 Ubuntu 系统中安装 Docker 后,有部分用户在启动 Docker 服务时遇到如下报错:

bash 复制代码
Failed to start Docker Application Container Engine.
failed to create NAT chain DOCKER: iptables v1.8.7 (nf_tables): Could not fetch rule set generation id: Invalid argument

本文将详细解释该问题的原因,并提供完整的修复方案。


问题现象

使用以下命令启动 Docker:

bash 复制代码
sudo systemctl start docker

执行后,使用以下命令查看docker运行情况

bash 复制代码
sudo systemctl status docker

发现状态为 failed

使用以下命令查看详细错误日志

bash 复制代码
sudo journalctl -u docker.service --no-pager --since "10 minutes ago"

伴随日志提示:

复制代码
failed to create NAT chain DOCKER: iptables v1.8.7 (nf_tables): Could not fetch rule set generation id: Invalid argument

这是 Docker 在使用默认 iptables-nft 后端时,与内核的 nf_tables 实现存在兼容性问题,无法创建 NAT 表中用于容器网络的 DOCKER chain。


原因分析

Ubuntu 从 20.04 起,iptables 默认使用 nf_tables 模式,而 Docker 更稳定地支持 iptables-legacy 模式。

这就导致 Docker 启动时无法正确配置网络桥接规则,从而守护进程失败退出。


解决方案:切换为 iptables-legacy 模式

1. 确保系统已安装 iptables(非 nft 工具包)

bash 复制代码
sudo apt install iptables

2. 执行切换命令(无需单独安装 iptables-legacy 包)

bash 复制代码
sudo update-alternatives --config iptables

系统会提示你可选项,例如:

选择带有 iptables-legacy 的序号(如 1),然后回车。

同理,切换 IPv6:

bash 复制代码
sudo update-alternatives --config ip6tables

3. 若缺少 iptables-legacy 可用项,可软链接模拟:

bash 复制代码
sudo ln -sf /usr/sbin/iptables /usr/sbin/iptables-legacy
sudo ln -sf /usr/sbin/ip6tables /usr/sbin/ip6tables-legacy

sudo update-alternatives --install /usr/sbin/iptables iptables /usr/sbin/iptables-legacy 100
sudo update-alternatives --install /usr/sbin/ip6tables ip6tables /usr/sbin/ip6tables-legacy 100

然后再次运行 --config 命令进行选择。

4. 重启 Docker 服务

bash 复制代码
sudo systemctl daemon-reexec
sudo systemctl restart docker

5. 验证是否恢复正常

bash 复制代码
docker info
docker run hello-world

如无报错即修复成功。


相关推荐
‍。。。3 小时前
ubuntu 安装 vllm
linux·运维·ubuntu
xiao-xiang3 小时前
zookeeper-集群扩缩容
linux·分布式·zookeeper·中间件·注册中心·zk
zzz100664 小时前
Shell 编程基础(续):流程控制与实践
linux·运维·服务器
蒲公英的孩子4 小时前
Linux下OpenRadioss源码编译安装及使用
linux·分布式·开源软件
三坛海会大神5555 小时前
《Shell 大道:筑基篇(下)—— 流控筑根基,数据任驱驰》
linux·运维·服务器·bash
坐吃山猪6 小时前
Docker03-知识点整理
docker
宇宙的有趣8 小时前
Fedora SSH 连接时智能防止系统挂起
linux
zml_20159 小时前
docker 1分钟 快速搭建 redis 哨兵集群
linux·redis·docker·docker-compose
草履虫建模10 小时前
若依微服务一键部署(RuoYi-Cloud):Nacos/Redis/MySQL + Gateway + Robot 接入(踩坑与修复全记录)
redis·mysql·docker·微服务·云原生·nacos·持续部署
半梦半醒*10 小时前
playbook剧本
linux·运维·服务器·ssh·ansible·运维开发