IPv6端口映射失效需多层协同：启用Docker IPv6支持、应用监听::、开启内核转发、配置ip6tables及云安全组，并避免双栈绑定冲突。
容器端口映射在 IPv6 环境下失效，不是单纯“加个 -p 就行”，而是涉及内核、Docker 配置、网络栈、防火墙、应用绑定等多层协同。常见表现是：容器已分配 IPv6 地址、docker ps 显示端口映射正常，但 curl -6 http://[2001:db8::2]:8080 超时或拒绝连接。问题核心在于 IPv6 流量未被正确路由、NAT 或监听所接纳。
确认 Docker 已启用 IPv6 支持
Docker 默认禁用 IPv6，必须显式开启并指定子网。否则即使宿主机有 IPv6，容器也仅获得 IPv4 地址，-p 映射对 IPv6 无效。
- 编辑 /etc/docker/daemon.json，确保包含：
{
"ipv6": true,
"fixed-cidr-v6": "2001:db8:1::/64"
}
- 重启生效：
sudo systemctl restart docker - 验证：运行
docker network inspect bridge | grep -A 5 IPv6，应看到"EnableIPv6": true和有效 IPv6 子网
检查容器内服务是否监听 IPv6 地址
很多应用（如 Node.js、Python Flask、Nginx 默认配置）只监听 127.0.0.1 或 0.0.0.0，不响应 IPv6 连接。IPv6 下需明确监听 ::（即 IPv6 的通配地址）。
- 进入容器：
docker exec -it <容器名> sh - 检查监听：
ss -tln6 | grep :<端口>（注意-6参数） - 若无输出，说明服务未监听 IPv6。需修改应用配置，例如：
- Nginx：
listen [::]:80; - Node.js：
server.listen(3000, '::'); - Spring Boot：
server.address=::或启动参数加--server.address=::
- Nginx：
验证宿主机 IPv6 路由与防火墙策略
IPv6 没有 NAT 的传统概念，但 Linux 内核仍需正确路由和允许转发。Docker 的 IPv6 端口映射依赖 ip6tables 规则和内核参数。
- 启用 IPv6 转发：
sudo sysctl -w net.ipv6.conf.all.forwarding=1，并写入 /etc/sysctl.conf 永久生效 - 检查
ip6tables是否放行目标端口：sudo ip6tables -L INPUT -n | grep <端口>；若无，添加规则：sudo ip6tables -I INPUT -p tcp --dport <端口> -j ACCEPT - 云服务器用户务必检查安全组——多数云平台 IPv4/IPv6 安全组独立，需单独放行 IPv6 入方向 TCP 规则
排查双栈环境下的地址绑定冲突
当容器同时拥有 IPv4 和 IPv6 地址时，部分应用（如旧版 Overleaf、某些 Java 框架）会因绑定逻辑缺陷，导致 IPv6 监听失败或端口被 IPv4 实例独占。
- 运行
docker inspect <容器名> | jq '.[].NetworkSettings.Networks.bridge.IPv6Gateway, .[].NetworkSettings.IPv6Address'，确认容器确实获取了 IPv6 地址 - 避免使用
0.0.0.0:<端口>同时绑定双栈，改用明确的[::]:<端口>或分实例部署 - 若使用
docker-compose，在 service 下添加sysctls:块确保容器内启用 IPv6：net.ipv6.conf.all.disable_ipv6=0
