Docker中配置IPv6传输代理时出现无法绑定地址错误

核心原因 #

Docker默认网络命名空间与宿主机隔离，容器内缺少宿主机配置的IPv6本地路由，且无权限修改网络参数（如启用非本地IP绑定），导致代理无法绑定指定网段内的任意IPv6地址。

解决方案 #

1. 赋予容器网络管理权限并传递sysctl配置 #

容器需要NET_ADMIN和NET_RAW权限才能修改路由与网络参数，同时需启用非本地IP绑定：

docker run \
  --cap-add=NET_ADMIN \
  --cap-add=NET_RAW \
  --sysctl net.ipv6.ip_nonlocal_bind=1 \
  -p 4747:4747 \
  jannchie/6tp \
  --subnet=xxxx:xxxx:xxxx:xxxx::/64 \
  --proxy-address="[::]:4747"

2. 在容器内添加IPv6本地路由 #

容器默认没有宿主机配置的IPv6网段路由，需在启动时手动添加：

docker run \
  --cap-add=NET_ADMIN \
  --cap-add=NET_RAW \
  --sysctl net.ipv6.ip_nonlocal_bind=1 \
  -p 4747:4747 \
  jannchie/6tp \
  sh -c "ip route add local xxxx:xxxx:xxxx:xxxx::/64 dev eth0 && 6tp --subnet=xxxx:xxxx:xxxx:xxxx::/64 --proxy-address="[::]:4747""

注意：替换命令中的eth0为容器内实际网卡名称（可通过docker exec <容器ID> ip link查看）。

3. 确保Docker守护进程启用IPv6 #

若宿主机IPv6正常但Docker未开启IPv6支持，修改/etc/docker/daemon.json：

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

重启Docker服务生效：

systemctl restart docker

4. 验证配置 #

启动容器后，进入容器检查网络配置：

# 进入容器
docker exec -it <容器ID> sh

# 查看IPv6路由
ip -6 route

# 检查非本地绑定参数
sysctl net.ipv6.ip_nonlocal_bind

确认路由中存在目标IPv6网段的本地路由，且net.ipv6.ip_nonlocal_bind值为1。

关于--network=host的说明 #

使用--network=host时，容器直接复用宿主机网络命名空间，因此宿主机的路由与网络参数直接生效，但会失去容器的网络隔离性，不建议生产环境使用。

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