---
title: Docker 容器 IP 网段调整与固定 IP 配置实践
description: 面向企业 IT 运维，说明 Docker 默认网桥网段与内网冲突时的处理思路：通过 daemon 配置调整 bip、使用自定义 network 分配固定 IP，并给出准备、风险、验证、回退与常见问题要点。
url: "https://www.lanever.com/docs/docker-%e5%ae%b9%e5%99%a8-ip-%e7%bd%91%e6%ae%b5%e8%b0%83%e6%95%b4%e4%b8%8e%e5%9b%ba%e5%ae%9a-ip-%e9%85%8d%e7%bd%ae%e5%ae%9e%e8%b7%b5/"
updated: "2026-10-12"
category: Kubernetes
---

# Docker 容器 IP 网段调整与固定 IP 配置实践

> **参考来源与致谢**
>
>
>
> - **引用来源：**[docker如何修改容器ip范围_docker_脚本之家](https://www.jb51.net/article/277494.htm)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

Docker 默认网桥通常占用一个私有网段，若与企业内网、VPN 或其它虚拟化平台网段重叠，会出现路由冲突、容器无法访问外部或跨主机通信异常。本文适用于以下情况：

- 容器网段与办公网、数据中心网段重叠，需要调整默认网桥地址。
- 需要为容器分配相对固定的 IP，便于内部访问与排障。
- 多台 Docker 主机之间需要容器跨主机互访。

> 不同 Docker 版本对 daemon 配置项、网络驱动与默认行为的支持存在差异，具体可用参数请以对应版本官方文档为准。

## 准备与风险

调整容器网段属于网络层变更，操作前必须完成以下准备：

1. 确认当前 Docker 版本、存储驱动与网络驱动，记录现有容器、网络与端口映射关系。
2. 在测试环境先行验证，确认新网段不与现有路由、防火墙、NAT 规则冲突。
3. 备份 daemon 配置文件与相关网络配置，例如 `/etc/docker/daemon.json`。
4. 准备回退方案：保留原配置文件副本，明确重启 Docker 的时间窗口。

风险提示：修改默认网桥网段或重启 Docker 守护进程，可能导致运行中容器短暂中断；若配置错误，可能造成容器网络不可用。生产环境请在维护窗口执行，并确认业务可容忍重启。

## 处理步骤

### 一、调整默认网桥网段

若仅需避开冲突网段，可在 daemon 配置中指定网桥 IP 与掩码。编辑 `/etc/docker/daemon.json`，加入类似内容：

```
{
 "bip": "[网桥地址]/24"
}
```

其中 `bip` 用于指定默认网桥地址，掩码长度需结合内网规划确定。保存后重启 Docker 服务使配置生效。重启前请确认没有依赖该网段的关键业务正在运行。

### 二、使用自定义网络分配固定 IP

若需要容器使用固定 IP，可创建自定义网络并指定子网：

```
docker network create --subnet=[自定义子网]/24 [网络名称]
```

启动容器时指定该网络与 IP：

```
docker run -d --net [网络名称] --ip [容器地址] --name [容器名称] [镜像名称]
```

说明：自定义网络的子网需为规划中的空闲网段；容器 IP 必须落在该子网内。使用自定义网络后，容器重启一般仍会保留网络配置，但具体行为与版本相关，建议以官方文档为准。

### 三、跨主机容器互访

多台 Docker 主机之间若需容器互访，除各自配置自定义网络外，还需在主机上添加路由规则，使对端容器网段可达。示例形式如下：

```
ip route add [对端容器网段]/24 via [对端主机地址] dev [出口网卡]
```

添加后可用 `ip route` 或 `route` 查看。删除规则可使用：

```
ip route del [对端容器网段]/24
```

注意：路由规则需在通信双方主机上分别配置，且应纳入配置管理，避免重启后丢失。

## 验证方法

- 在主机上查看网桥与路由：`ip addr`、`ip route`。
- 查看容器网络信息：`docker network inspect [网络名称]`。
- 进入容器确认地址：`docker exec -it [容器名称] /bin/sh`，再执行 `ip addr` 或 `ifconfig`。
- 连通性测试：从主机 ping 容器地址，从容器 ping 网关与对端容器地址。
- 检查端口映射与业务访问是否正常，确认无路由环路或冲突。

## 回退建议

1. 恢复备份的 daemon 配置文件，重启 Docker 服务。
2. 删除新建的自定义网络：`docker network rm [网络名称]`，注意需先停止使用该网络的容器。
3. 删除新增路由规则：`ip route del [对端容器网段]/24`。
4. 若容器已按新网络启动，需重新按原网络配置启动，并核对端口映射与依赖关系。

## 常见问题

- 修改后容器无法上网：检查网段是否与内网冲突、NAT 与转发规则是否正常。
- 固定 IP 不生效：确认容器启动时指定了自定义网络，且 IP 在子网范围内。
- 跨主机不通：确认双方路由规则、防火墙策略与出口网卡是否正确。
- 重启后配置丢失：daemon 配置与路由规则应纳入配置管理或启动脚本。
- 参数含义不确定：请查阅对应 Docker 版本的官方文档，不要直接套用其它版本配置。
