Docker 網絡 IP 地址沖突這個問題其實稍微有一點點麻煩，網上也沒有看到有比較全面正確的文章， 值得單獨寫一篇記錄一下。

1前置知識

因為交換機的能力有限制，以及網線的連接不可能無限長， 所以我們不可能把所有的主機都連到同一個交換機上，然后處于同一個二層網絡中。

就算能，主機間的 ARP 廣播也會讓這個網絡瞬間癱瘓。

所以我們得把主機拆分到一個個的小的子網里，然后通過路由器再并成三層網絡。

我們俗稱的 IP 地址其實由兩個部分組成，網絡地址和主機地址。比如10.0.0.1/8中，第一個10是網絡地址，后面的0.0.1是主機地址。那我怎么知道怎么去拆分這兩段呢？靠的就是子網掩碼，也就是那個/8。

IP 其實是由 32 位的二進制組成的，x.x.x.x只是為了方便人類閱讀將其轉成了十進制。有個簡單粗暴的辦法就是可以認為每一段都是 8 位，所以/8就代表第一段是網絡地址。

同理，/16就代表前兩段都是網絡地址，10.0.0.0/16中， 網絡地址是10.0，后兩位0.0代表每個子網中的主機地址。

比如10.0.0.1/16和10.0.0.2/16是同一個子網的兩個主機。10.0.0.1/16和10.1.0.1/16是不同的子網的兩個主機。

這里只是簡單粗暴的介紹下，更多的信息還是自己去查資料了解學習。

2問題表現

docker 進程無法啟動

容器端口無法訪問，抓包顯示為有入站但是沒有出站

3排查

此處針對的是 dockerd 無法啟動的情況，如果 dockerd 能啟動，可以直接跳到解決一節

首先是看下日志

$systemctlstatusdocker
$journalctl-udocker
$dmesg|grepdocker

一般能看到如下日志：

docker0:linkisnotready
docker_gwbridge:linkisnotready

或者更簡單的排查方法，直接手動啟動 dockerd 看看。啟動方法可以通過grep ExecStart /usr/lib/systemd/system/docker.service查看。

一般來說按如下執行就行：

$/usr/bin/dockerd--debug

然后能看到最后輸出：

INFO[2021-07-29T0255.811673622Z]stoppingeventstreamfollowinggracefulshutdownerror=""module=libcontainerdnamespace=moby
failedtostartdaemon:Errorinitializingnetworkcontroller:listbridgeaddressesfailed:PredefinedLocalScopeDefaultNetworksList:[10.252.0.0/2410.252.1.0/2410.252.2.0/24]:noavailablenetwork

這時候可以看下ip addr，是否有docker0和docker_gwbridge，

如果發現沒有docker0，那基本可以肯定是 docker0 無法創建導致 dockerd 啟動失敗了。

4解決

找到占用的網段

默認的 docker0 網段是172.17.0.0/16，docker_gwbridge 網段是172.18.0.0/24，你需要確認下這兩個網段是否被占用了。

最簡單的方法就是 ping 一下，如果無響應的話，那么就說明沒有被占用。

其次就是看一下本機的路由表route -n，確認一下有沒有沖突的段。一般來說，你會發現相關網段要么已經被占用，要么是路由表里存在沖突。

案例

比如在我的環境里，我給 docker0 配置為10.252.0/24，然后 dockerd 起不來。

排查后發現route -n里有這么一條：

10.0.0.0172.21.0.1255.0.0.0UG000eth0

也就是說10/8被占用了，導致和我的10.252.0/24沖突。后來聯系網管刪除了這條10/8的路由后解決。

修改 docker 占用的網段

以下操作需要先停止 docker 進程

$systemctlstopdocker

如果你用 docker service，那么 docker 會占用四個網段：

docker0

docker_gwbridge

ucp（docker engine 占用，不常見）

ingress

其中前三個的網段可以通過配置文件配置，第四個只能手動創建。

前三個網段會讀取/etc/docker/daemon.json這個配置文件， 這個文件默認是沒有的，需要手動創建。

{
"bip":"",
"default-address-pools":[
{"base":"10.252.0.0/24","size":24},
{"base":"10.252.1.0/24","size":24},
{"base":"10.252.2.0/24","size":24}
]
}

注意這個default-address-pools至少要有兩項，按順序依次為：

docker0

docker_gwbridge

ucp

以防萬一的話，配置三個是最好的。

接下來是修改 ingress，這個比較麻煩，需要手動創建。

我的辦法是在初始化 docker swarm 以后，啟動 docker stack/service 以前，執行以下腳本：

刪除 ingress

刪除 my-ingress（不一定存在，不存在就忽略）

新建 my-ingress

$yes'y'|dockernetworkrmingress
$yes'y'|dockernetworkrmmy-ingress2>&1|true
$dockernetworkcreate
--driveroverlay
--ingress
--subnet=10.252.3.0/24#指定ingress的網段，不要和上面daemon.json的網段沖突
--gateway=10.252.3.2
--optcom.docker.network.driver.mtu=1200
my-ingress

ingress 是默認名，之所以新建一個名字不一樣的，是因為刪除 ingress 是異步的。如果你刪除 ingress 后立刻新建一個也叫 ingress 的網絡，很可能會報一個重名的錯誤。

重啟 docker 前，最好先清理一下 docker 的緩存：

$iplinkdeldevdocker0
$iplinkdeldevdocker_gwbridge
$rm-rf/var/lib/docker/network

另一種粗糙簡單的解決辦法

另一種粗糙簡單的解決辦法就是干脆直接手動創建一個 docker0。

這種解決方法最簡單，但是機器 reboot 后 docker0 會自動被刪掉， 所以這方法并不持久。

而且，實際上也不一定能解決網段沖突的問題，只是說 docker 能啟動了而已。

iplinkaddnamedocker0typebridge
ipaddradddevdocker010.252.0.1/24