Docker环境下MongoDB容器IPv6配置失败无法访问及断网问题排查

• 容器失去互联网连接：Docker默认未开启IPv6支持，容器内无有效IPv6路由，MongoDB绑定全IPv6地址后会导致网络栈优先尝试不可用的IPv6路径，阻塞正常IPv4网络请求，最终出现apt update等操作失败。
• 无法通过公网IPv6访问MongoDB：存在三个核心问题：
  1. 启动命令仅映射了IPv4的27017端口，未配置IPv6端口映射，公网IPv6请求无法到达容器
  2. MongoDB配置文件格式错误，MongoDB 5.x使用YAML格式配置，不支持=赋值语法，导致绑定配置未生效
  3. 部分场景下宿主机防火墙/安全组未放行27017端口的IPv6入站规则

步骤1：开启Docker全局IPv6支持 #

编辑Docker daemon配置文件/etc/docker/daemon.json，添加如下配置：

{
  "ipv6": true,
  "fixed-cidr-v6": "fd00::/80",
  "experimental": true,
  "ip6tables": true
}

配置完成后重启Docker服务生效：
systemctl restart docker
上述配置会开启Docker的IPv6支持，自动分配容器IPv6内网段，同时自动管理IPv6端口映射的iptables规则。

步骤2：修正MongoDB相关配置 #

修正配置文件语法 #

将MongoDB配置文件的网络段改为符合YAML规范的写法，同时配置同时监听所有IPv4和IPv6地址：

net:
  port: 27017
  bindIp: ::,0.0.0.0
  ipv6: true

不需要单独绑定公网IPv6地址，监听所有地址即可，避免公网IP变动导致配置失效。

修正容器启动命令 #

无需自定义entrypoint脚本，直接通过官方镜像启动参数配置即可，同时添加IPv6端口映射：

docker run -d \
  -v /Docker/mongoconfig/mongod.conf.orig:/etc/mongod.conf.orig \
  -p 0.0.0.0:27017:27017 \
  -p [::]:27017:27017 \
  mongo:5.0.3 \
  mongod --config /etc/mongod.conf.orig

如果不使用配置文件，也可以直接通过启动参数指定：

docker run -d \
  -p 0.0.0.0:27017:27017 \
  -p [::]:27017:27017 \
  mongo:5.0.3 \
  mongod --bind_ip_all --ipv6

步骤3：验证配置生效 #

1. 进入运行中的容器执行netstat -tulpn，正常会输出以下监听信息：

tcp        0      0 0.0.0.0:27017         0.0.0.0:*               LISTEN      1/mongod            
tcp6       0      0 :::27017              :::*                    LISTEN      1/mongod   

2. 执行apt update验证容器互联网连接正常
3. 公网侧验证：在具备IPv6公网的环境下执行mongo --ipv6 [宿主机公网IPv6地址]:27017，确认可正常连接，若连接失败请检查宿主机安全组、防火墙是否放行27017端口的IPv6入站规则。

内容的提问来源于stack exchange，提问作者mike