Docker 学习笔记（三）：Docker 网络、bridge、子网和容器互通
学 Docker 网络时，最容易卡在一句话：
容器里面的 localhost，不是你的电脑。
很多后端项目本地可以连接数据库，一放进 Docker 就报错：
ECONNREFUSED 127.0.0.1:27017原因往往不是 MongoDB 挂了，而是你在容器里写了localhost。
这篇文章专门讲 Docker 网络。
1. 先记住一个原则
在宿主机上访问容器：用 localhost + 映射端口 容器访问另一个容器：用容器名 / 服务名 + 容器端口比如：
浏览器访问后端： localhost:3000 后端容器访问 MongoDB 容器： mongodb://mongo:27017/app不要混用。
2. Docker 默认 bridge 网络
安装 Docker 后，默认会有几个网络：
dockernetworkls常见输出：
NETWORK ID NAME DRIVER SCOPE xxxx bridge bridge local xxxx host host local xxxx none null local其中最常见的是bridge。
可以把 bridge 理解成 Docker 在你电脑里创建的一台“虚拟交换机”：
宿主机 │ ├── docker0 / bridge 网络 │ ├── container A │ ├── container B │ └── container C │ └── 本机网络容器加入 bridge 网络后，会获得一个内部 IP。
3. 查看网络详情
dockernetwork inspect bridge你会看到类似信息：
{"Name":"bridge","Driver":"bridge","IPAM":{"Config":[{"Subnet":"172.17.0.0/16","Gateway":"172.17.0.1"}]}}这里有两个重要字段：
| 字段 | 含义 |
|---|---|
Subnet | Docker 网络使用的子网范围 |
Gateway | 这个 Docker 网络的网关 |
172.17.0.0/16表示这个网络里可以分配一批内部 IP，例如：
172.17.0.2 172.17.0.3 172.17.0.4这些 IP 主要用于容器之间通信。
4. 为什么不推荐直接用容器 IP？
你可能会想：既然容器有 IP，那后端连接 MongoDB 写 IP 不就行了？
比如：
mongodb://172.17.0.2:27017/app不推荐。
原因是容器 IP 可能变化：
- 容器删除后重建，IP 可能变；
- Compose 重新启动服务，IP 可能变；
- 网络重新创建，IP 也可能变。
更推荐使用容器名或服务名。
mongodb://mongo:27017/app这类似一个内部 DNS。
5. 自定义 bridge 网络
默认 bridge 网络能用，但实际项目更推荐自己创建网络。
dockernetwork create app-net查看：
dockernetworkls启动 MongoDB：
dockerrun-d\--namemongo\--networkapp-net\-eMONGO_INITDB_ROOT_USERNAME=root\-eMONGO_INITDB_ROOT_PASSWORD=123456\-vmongo-data:/data/db\mongo:7启动后端：
dockerrun-d\--nameapi\--networkapp-net\-p3000:3000\-eMONGO_URL="mongodb://root:123456@mongo:27017/app?authSource=admin"\my-api:1.0后端里的mongo就能解析到 MongoDB 容器。
6. 创建指定子网的网络
有时公司内网、VPN、虚拟机网络可能和 Docker 默认网段冲突。
这时可以指定 Docker 网络的子网：
dockernetwork create\--driverbridge\--subnet172.30.0.0/16\--gateway172.30.0.1\app-net解释一下：
| 参数 | 作用 |
|---|---|
--driver bridge | 使用 bridge 网络驱动 |
--subnet 172.30.0.0/16 | 指定网络子网 |
--gateway 172.30.0.1 | 指定网关 |
app-net | 网络名字 |
创建后查看：
dockernetwork inspect app-net7. 端口映射和 Docker 网络不是一回事
很多人会把-p和 Docker 网络混在一起。
其实它们解决的问题不同。
7.1-p解决的是宿主机访问容器
-p3000:3000表示：
宿主机 localhost:3000 -> 容器 3000也就是浏览器、Postman、curl 从宿主机访问容器。
7.2 Docker 网络解决的是容器访问容器
api 容器 -> mongo 容器这时不需要-p 27017:27017，只要两个容器在同一个网络里，后端就能访问：
mongodb://mongo:27017/app当然，如果你还想从宿主机上的 MongoDB Compass 连接容器里的 MongoDB，那就需要映射端口：
-p27017:270178. 为什么容器里不能写 localhost？
假设后端容器里写：
mongodb://localhost:27017/app在后端容器看来，localhost指的是：
后端容器自己不是 MongoDB 容器，也不是宿主机。
所以它会在后端容器内部找 27017 端口，找不到就报错。
正确写法：
mongodb://mongo:27017/app这里的mongo是 MongoDB 容器名或 Compose 服务名。
9. 常见排查命令
查看网络：
dockernetworkls查看网络详情：
dockernetwork inspect app-net查看容器属于哪个网络：
dockerinspect api进入容器：
dockerexec-itapish在容器里测试服务名解析：
pingmongo有些精简镜像没有ping，可以用：
getent hosts mongo或者临时启动一个网络测试容器：
dockerrun--rm-it--networkapp-net alpinesh10. 第三篇小结
Docker 网络可以这样记：
宿主机访问容器：localhost + -p 映射端口 容器访问容器：服务名/容器名 + 容器端口 容器里的 localhost：容器自己常见命令：
# 查看网络dockernetworkls# 创建网络dockernetwork create app-net# 创建指定子网的网络dockernetwork create--driverbridge--subnet172.30.0.0/16--gateway172.30.0.1 app-net# 查看网络详情dockernetwork inspect app-net# 让容器加入网络dockernetwork connect app-net api下一篇进入 Dockerfile：如何把自己的项目打成镜像。
参考资料
- Docker networking overview: https://docs.docker.com/engine/network/
- Bridge network driver: https://docs.docker.com/engine/network/drivers/bridge/
- docker network create: https://docs.docker.com/reference/cli/docker/network/create/
- Docker Compose networking: https://docs.docker.com/compose/how-tos/networking/
