如何在群晖中，正确配置 docker 的 ipv6 地址

参考

2023年9月12日

• https://synocommunity.com/
• https://github.com/wangliangliang2/fix_synology_docker_ipv6
• https://post.smzdm.com/p/an3np8m7/

正文

关于这个话题，国内搜索引擎得到的结果出奇的一致，且过时。
（看的我脑壳痛）
（何为万众一心，齐心协力，见识到了）

这里记录我认为的，正确的，便捷的，配置方法 for 有缘人

方法一： 通过 docker web ui 配置 ipv6 网络

国内教程千篇一律说要 ssh 连接后台改 docker 配置，诸如：
/var/packages/Docker/etc/dockerd.json
/volume1/@appconf/Docker/dockerd.json
/usr/syno/etc/packages/Docker/dockerd.json
(用 /var/packages/Docker/scripts/start-stop-status 启停)

加

{"ipv6": true,"fixed-cidr-v6": "2001:db8:1::/64","experimental": true,"ip6tables": true
}

大概是受到，这篇 docker 官方文档的影响：（假设cver们懂看官方文档）
https://docs.docker.com/config/daemon/ipv6/

其实完全不用，群晖早在 17年 就支持 ipv6 的 web ui 配置了
https://www.synology.com/en-br/releaseNote/Docker

相比 global 全局 的配置 network，单独添加好处：

1. web ui 支持，无需 ssh 进入后台设置
2. 影响可控/影响范围小 —— 哪个需要给哪个开 ipv6

方法二： 通过 cli 添加 docker network (包括分析IP地址如何选择)

命令行添加更方便管理 docker / docker-compose
参考：
https://gdevillele.github.io/engine/userguide/networking/default_network/ipv6/
https://dev.to/joeneville_/build-an-ipv6-network-with-docker-compose-434i
https://stackoverflow.com/questions/39649458/how-to-assign-ipv6-address-with-docker-compose

创建虚拟网卡

docker network create --ipv6 \--subnet=172.16.2.0/24 \--gateway=172.16.2.1  \--subnet=<mynetv6-prefix/subnet> \--gateway=<mynetv6-gw> \mynetv6-1

or

# 自动选择 ipv4 内网地址段
docker network create --ipv6 \--subnet=<mynetv6-prefix/subnet> \--gateway=<mynetv6-gw> \mynetv6-1

or

# 自动选择 ipv4 内网地址段
# 自动决定 ipv6 网关
docker network create --ipv6 \--subnet=<mynetv6-prefix/subnet> \mynetv6-1

<mynetv6-prefix/subnet> 和 <mynetv6-gw> 如何填写？
建议写一个 nat6 地址 (ipv6的局域网网端)
fc00::/7
fc00::/8 (未启用)
fd00::/8 (推荐)
e.g.
fd00:996:996:996::/64 - subnet
fd00:996:996:996::1 - gw

更多 ipv6 网络划分等基础概念，推荐参考：

1. 视频 - 中文 by 老湿基 - https://www.bilibili.com/video/BV1N14y1j7Ku/
2. 视频 - 德国人说英文 by OneMarcFifty - https://www.youtube.com/watch?v=oItwDXraK1M
3. 文字 (推荐) - IPv6 Cheat Sheet - https://github.com/onemarcfifty/cheat-sheets/blob/main/networking/ipv6.md

测试

docker run --rm --name testnetv6 --network ip6net -p 80:80 traefik/whoami 

$ curl http://[::1]:80
Hostname: d87e379f092b
IP: 127.0.0.1
IP: ::1
IP: 172.22.0.2
IP: fdff:db80:ab::2
IP: fe80::42:acff:fe16:2
RemoteAddr: [fdff:db80:ab::1]:51470
GET / HTTP/1.1
Host: [::1]:80
User-Agent: curl/7.79.1
Accept: */*

例子： 配置 docker qbittorrent ipv6 nat6 端口映射 外网访问

todo