一、Docker网络核心概念
1.1 网络驱动类型
Docker提供了多种网络驱动,每种适用于不同的使用场景:
| 网络类型 | 驱动 | 说明 | 适用场景 |
|---|---|---|---|
| bridge | bridge |
默认网络驱动,创建隔离的桥接网络 | 单主机容器通信(默认) |
| host | host |
与宿主机共享网络栈 | 需要直接访问宿主机网络 |
| none | none |
无网络连接 | 完全隔离的容器 |
| overlay | overlay |
跨主机网络,支持Swarm集群 | Docker Swarm多主机通信 |
| macvlan | macvlan |
为容器分配MAC地址,直接连接到物理网络 | 容器需要独立IP地址 |
| ipvlan | ipvlan |
类似macvlan,但共享MAC地址 | 网络设备限制MAC地址的场景 |
1.2 默认网络特性
bridge网络(默认):
- 容器间可通过IP地址通信
- 不支持容器名解析(重要限制)
- 适合单容器或不需要容器名解析的场景
自定义网络:
- 支持容器名自动DNS解析
- 支持自定义网络段
- 支持网络隔离
- 推荐用于多容器应用
二、Docker网络管理指令
2.1 网络基础操作
查看网络列表
docker network ls
创建自定义网络
# 创建默认bridge驱动的网络
docker network create my-network
# 创建指定子网和网关的网络
docker network create \
--subnet=172.20.0.0/16 \
--gateway=172.20.0.1 \
my-custom-network
# 创建overlay网络(用于Swarm)
docker network create \
--driver overlay \
--subnet=10.0.9.0/24 \
my-overlay-network
查看网络详情
# 查看网络基本信息
docker network inspect my-network
# 查看网络中的容器
docker network inspect my-network | grep -A 10 "Containers"
# 格式化输出(仅显示容器名)
docker network inspect -f '{{range .Containers}}{{.Name}} {{end}}' my-network
删除网络
# 删除指定网络(需先断开所有容器关联)
docker network rm my-network
# 强制删除(不推荐,可能导致容器网络异常)
docker network rm -f my-network
清理未使用的网络
# 删除所有未使用的网络
docker network prune
# 交互式确认
docker network prune -f # -f 表示不询问直接删除
2.2 容器与网络关联/断开
将容器加入网络
# 将运行中的容器加入网络
docker network connect my-network container-name
# 将容器加入多个网络
docker network connect network1 container-name
docker network connect network2 container-name
从网络断开容器
# 断开容器与网络的连接
docker network disconnect my-network container-name
# 强制断开(即使容器正在使用该网络)
docker network disconnect -f my-network container-name
启动容器时指定网络
# 使用 --network 参数
docker run -d \
--name my-container \
--network my-network \
nginx:latest
# 启动时加入多个网络(需先创建容器,再连接)
docker run -d --name my-container nginx:latest
docker network connect network1 my-container
docker network connect network2 my-container
2.3 查看容器网络归属
查看容器关联的所有网络
# 方法1:使用 inspect 命令
docker inspect -f '{{.NetworkSettings.Networks}}' container-name
# 方法2:查看完整网络配置
docker inspect container-name | grep -A 20 "Networks"
# 方法3:格式化输出网络名
docker inspect -f '{{range $key, $value := .NetworkSettings.Networks}}{{$key}} {{end}}' container-name
查看容器的IP地址
# 查看容器在指定网络中的IP
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' container-name
# 查看容器在所有网络中的IP
docker inspect container-name | grep IPAddress
三、Docker Compose网络管理
3.1 Compose网络默认行为
项目前缀规则
- Compose会自动为网络添加项目前缀(默认是当前目录名)
- 例如:目录名为
spacehelper时,网络my-network会被命名为spacehelper_my-network - 可通过
name字段强制指定网络名(避免前缀)
默认网络创建
Compose会自动创建以下网络:
{project}_default:默认网络,所有服务默认加入- 如果定义了自定义网络,会按配置创建
3.2 Compose网络配置
基础网络配置
version: '3.8'
services:
web:
image: nginx:latest
networks:
- frontend
- backend
db:
image: mysql:8.0
networks:
- backend
networks:
frontend:
driver: bridge
name: frontend-network # 自定义最终网络名(避免前缀)
backend:
driver: bridge
name: backend-network
ipam:
config:
- subnet: 172.25.0.0/16
外部网络配置
networks:
external-network:
external: true # 使用已存在的网络
name: my-existing-network # 外部网络名称
3.3 Compose文件目录要求
推荐目录结构
/opt/middle-images/spacehelper/
├── docker-compose.yml # Compose配置文件
├── Dockerfile # 镜像构建文件
├── .env.production # 环境变量文件
├── default.conf # Nginx配置文件(若挂载)
├── logs/ # 日志目录(挂载到容器)
└── data/ # 数据目录(挂载到容器)
Compose文件位置
- 必须:
docker-compose.yml放在与Dockerfile同级目录 - 可选:使用
-f参数指定Compose文件路径docker-compose -f /path/to/docker-compose.yml up -d
3.4 Compose常用指令
服务管理
# 启动所有服务(后台运行)
docker-compose up -d
# 重新构建镜像并启动
docker-compose up -d --build
# 启动指定服务
docker-compose up -d service-name
# 停止所有服务
docker-compose stop
# 停止并删除容器(保留镜像/网络/数据卷)
docker-compose down
# 停止并删除容器、网络、数据卷
docker-compose down -v # -v 删除数据卷
# 重启指定服务
docker-compose restart service-name
# 重启所有服务
docker-compose restart
查看服务状态
# 查看运行中的服务
docker-compose ps
# 查看服务日志
docker-compose logs service-name
# 实时查看日志(类似 tail -f)
docker-compose logs -f service-name
# 查看最近100行日志
docker-compose logs --tail=100 service-name
# 查看所有服务的日志
docker-compose logs
服务操作
# 进入服务容器
docker-compose exec service-name bash
# 执行服务容器中的命令
docker-compose exec service-name ls -la
# 查看服务配置
docker-compose config
# 验证Compose文件语法
docker-compose config --quiet
四、实战场景:解决容器通信问题
4.1 场景描述:容器无法通过容器名解析
问题现象
# 在 middle-nginx 容器中无法通过容器名访问 spacehelper
docker exec -it middle-nginx bash
curl http://spacehelper:3000
# 返回:curl: (6) Could not resolve host: spacehelper
问题原因分析
- 容器未加入同一自定义网络
- 使用默认bridge网络(不支持容器名解析)
- 网络配置错误
4.2 解决步骤
步骤1:创建自定义网络
# 创建自定义网络
docker network create my-network
# 验证网络创建
docker network ls | grep my-network
步骤2:将容器加入网络
# 方法1:将运行中的容器加入网络
docker network connect my-network spacehelper
docker network connect my-network middle-nginx
步骤3:验证通信
# 进入 middle-nginx 容器
docker exec -it middle-nginx bash
# 测试容器名解析
ping spacehelper
# 应返回:PING spacehelper (172.20.0.2) ...
# 测试HTTP连接
curl http://spacehelper:3000
# 应返回服务内容
# 测试端口连通性
nc -zv spacehelper 3000
# 应返回:spacehelper [172.20.0.2] 3000 (?) open
步骤4:验证网络配置
# 查看容器网络配置
docker inspect spacehelper | grep -A 15 "NetworkSettings"
# 查看网络中的容器
docker network inspect my-network
4.3 使用Compose解决通信问题
Compose配置示例
version: '3.8'
services:
spacehelper:
build: .
image: spacehelper:v8.4
container_name: spacehelper
ports:
- "3000:3000"
env_file:
- .env.production
networks:
- app-network
volumes:
- ./logs:/container_logs
logging:
driver: "local"
options:
max-size: "10m"
max-file: "5"
nginx:
image: nginx:latest
container_name: middle-nginx
ports:
- "80:80"
networks:
- app-network
depends_on:
- spacehelper
networks:
app-network:
driver: bridge
name: my-network # 自定义网络名
启动服务
# 在 docker-compose.yml 所在目录执行
docker-compose up -d
# 验证服务运行
docker-compose ps
# 测试通信
docker-compose exec nginx curl http://spacehelper:3000
五、镜像构建与容器启动指令
5.1 镜像构建
基础构建命令
# 基于当前目录的Dockerfile构建镜像
docker build -t <镜像名:版本> -f Dockerfile .
# 示例
docker build -t spacehelper:v8.4 -f Dockerfile .
# 指定构建上下文
docker build -t spacehelper:v8.4 -f Dockerfile /path/to/context
# 不使用缓存构建
docker build --no-cache -t spacehelper:v8.4 -f Dockerfile .
高级构建选项
# 构建时传递构建参数
docker build \
--build-arg NODE_ENV=production \
--build-arg API_URL=https://api.example.com \
-t spacehelper:v8.4 \
-f Dockerfile .
5.2 容器启动(完整配置)
基础启动命令
docker run -itd \
-p 3000:3000 \
--env-file .env.production \
--log-driver=local \
--log-opt max-size=10m \
--log-opt max-file=5 \
-v /opt/middle-images/spacehelper/logs:/container_logs \
--network my-network \
--name spacehelper \
spacehelper:v8.4
参数说明
| 参数 | 说明 | 示例 |
|---|---|---|
-itd |
交互式、终端、后台运行 | -itd |
-p |
端口映射(宿主机:容器) | -p 3000:3000 |
--env-file |
从文件加载环境变量 | --env-file .env.production |
-e |
设置单个环境变量 | -e NODE_ENV=production |
--log-driver |
日志驱动 | --log-driver=local |
--log-opt |
日志选项 | --log-opt max-size=10m |
-v |
数据卷挂载 | -v /host/path:/container/path |
--network |
指定网络 | --network my-network |
--name |
容器名称 | --name spacehelper |
--restart |
重启策略 | --restart unless-stopped |
完整启动示例
docker run -itd \
-p 3000:3000 \
-p 3001:3001 \
--env-file .env.production \
-e NODE_ENV=production \
-e DEBUG=false \
--log-driver=local \
--log-opt max-size=10m \
--log-opt max-file=5 \
--log-opt compress=true \
-v /opt/middle-images/spacehelper/logs:/container_logs:rw \
-v /opt/middle-images/spacehelper/data:/app/data:ro \
--network my-network \
--name spacehelper \
--restart unless-stopped \
--memory="512m" \
--cpus="1.0" \
--health-cmd="curl -f http://localhost:3000/health || exit 1" \
--health-interval=30s \
--health-timeout=10s \
--health-retries=3 \
spacehelper:v8.4
重启策略说明
| 策略 | 说明 |
|---|---|
no |
不自动重启(默认) |
always |
总是重启 |
on-failure |
仅在非零退出码时重启 |
unless-stopped |
除非手动停止,否则总是重启 |
六、常见问题处理
6.1 删除网络时提示"network is in use"
问题现象
$ docker network rm my-network
Error response from daemon: network my-network is in use
解决方法
# 步骤1:查看网络中的容器
docker network inspect my-network | grep -A 10 "Containers"
# 步骤2:断开所有容器关联
docker network disconnect my-network container1
docker network disconnect my-network container2
# 步骤3:删除网络
docker network rm my-network
6.2 Compose启动后网络名带前缀
问题现象
期望网络名为 my-network,实际为 spacehelper_my-network
解决方法
在 docker-compose.yml 的 networks 中添加 name 字段:
networks:
my-network:
name: my-network # 自定义最终网络名(避免前缀)
driver: bridge
6.3 容器无法访问外部网络
问题排查
# 1. 检查容器网络配置
docker inspect container-name | grep -A 20 "NetworkSettings"
# 2. 检查DNS配置
docker inspect container-name | grep -A 5 "Dns"
# 3. 测试网络连通性
docker exec container-name ping 8.8.8.8
docker exec container-name nslookup google.com
# 4. 检查防火墙规则
iptables -L -n | grep DOCKER
解决方法
# 方法1:重启Docker服务
sudo systemctl restart docker
# 方法2:重建网络
docker network rm my-network
docker network create my-network
docker network connect my-network container-name
# 方法3:配置DNS
docker run --dns 8.8.8.8 --dns 8.8.4.4 ...
6.4 端口冲突问题
问题现象
$ docker run -p 3000:3000 ...
Error: bind: address already in use
解决方法
# 方法1:查找占用端口的进程
# Linux
sudo lsof -i :3000
sudo netstat -tulpn | grep 3000
# 方法2:使用不同端口
docker run -p 3001:3000 ...
# 方法3:停止占用端口的容器
docker ps | grep 3000
docker stop <container-id>
七、高级网络配置
7.1 自定义DNS配置
容器级别DNS
# 启动时指定DNS
docker run --dns 8.8.8.8 --dns 8.8.4.4 ...
# 在 docker-compose.yml 中配置
services:
web:
dns:
- 8.8.8.8
- 8.8.4.4
网络级别DNS
# 创建网络时指定DNS
docker network create \
--driver bridge \
--subnet=172.20.0.0/16 \
--gateway=172.20.0.1 \
--opt com.docker.network.bridge.enable_icc=true \
--opt com.docker.network.driver.mtu=1500 \
my-network
7.2 网络隔离与安全
创建隔离网络
# 创建内部网络(不允许外部访问)
docker network create \
--internal \
--driver bridge \
internal-network
网络访问控制
# docker-compose.yml
networks:
frontend:
driver: bridge
internal: false # 允许外部访问
backend:
driver: bridge
internal: true # 仅内部访问
7.3 多网络场景
容器加入多个网络
# 创建多个网络
docker network create frontend-net
docker network create backend-net
docker network create database-net
# 容器加入多个网络
docker run -d --name app \
--network frontend-net \
nginx:latest
docker network connect backend-net app
docker network connect database-net app
Compose多网络配置
services:
web:
networks:
- frontend
- backend
api:
networks:
- backend
- database
db:
networks:
- database
networks:
frontend:
driver: bridge
backend:
driver: bridge
database:
driver: bridge
八、最佳实践与建议
8.1 网络设计原则
- 使用自定义网络:避免使用默认bridge网络
- 网络隔离:按功能划分网络(前端、后端、数据库)
- 命名规范:使用有意义的网络名称
- 文档化:记录网络架构和配置
8.2 容器通信最佳实践
- 使用容器名而非IP:利用DNS解析
- 服务发现:使用环境变量或配置中心
- 健康检查:配置容器健康检查
- 优雅关闭:实现优雅关闭逻辑
8.3 Compose最佳实践
- 版本控制:使用明确的Compose版本
- 环境变量:使用
.env文件管理配置 - 数据持久化:使用命名卷而非绑定挂载
- 资源限制:设置内存和CPU限制
8.4 安全建议
- 最小权限:容器仅暴露必要端口
- 网络隔离:敏感服务使用内部网络
- TLS加密:生产环境使用HTTPS
- 定期更新:保持镜像和Docker版本更新
附录
A. 常用命令速查表
| 操作 | 命令 |
|---|---|
| 查看网络 | docker network ls |
| 创建网络 | docker network create <name> |
| 查看网络详情 | docker network inspect <name> |
| 删除网络 | docker network rm <name> |
| 连接网络 | docker network connect <net> <container> |
| 断开网络 | docker network disconnect <net> <container> |
| 清理网络 | docker network prune |
| Compose启动 | docker-compose up -d |
| Compose停止 | docker-compose down |
| Compose日志 | docker-compose logs -f |
B. 网络故障排查流程
- 检查网络状态:
docker network ls - 检查容器网络:
docker inspect <container> - 测试连通性:
docker exec <container> ping <target> - 检查DNS:
docker exec <container> nslookup <hostname> - 查看日志:
docker logs <container> - 重建网络:删除并重新创建网络
文档版本:v1.0
最后更新:2025年
维护者:Space Helper Team