如何在Docker中设置静态IP地址？

Docker容器设置静态IP地址的完整指南

在Docker中为容器分配静态IP地址有多种方法，以下是详细的解决方案：

方法一：使用自定义bridge网络（推荐）

这是最常用的静态IP分配方式，适用于大多数场景：

# 1. 创建自定义网络
docker network create \
  --driver=bridge \
  --subnet=172.20.0.0/16 \
  --gateway=172.20.0.1 \
  --ip-range=172.20.5.0/24 \
  my-static-net

# 2. 运行容器并分配静态IP
docker run -d --name web-server \
  --network my-static-net \
  --ip 172.20.5.10 \
  nginx:alpine

# 3. 验证IP分配
docker exec web-server ip addr show eth0

🌉 方法二：使用macvlan网络（容器获取物理网络IP）

当容器需要直接接入物理网络时：

# 1. 创建macvlan网络
docker network create -d macvlan \
  --subnet=192.168.1.0/24 \
  --gateway=192.168.1.1 \
  --ip-range=192.168.1.100/28 \
  -o parent=eth0 \
  macvlan-static

# 2. 运行容器并分配静态IP
docker run -d --name network-app \
  --network macvlan-static \
  --ip=192.168.1.101 \
  nginx:alpine

📝 方法三：使用docker-compose配置静态IP

适用于docker-compose部署场景：

version: '3.7'

services:
  web:
    image: nginx:alpine
    networks:
      static-net:
        ipv4_address: 172.22.0.10

  db:
    image: postgres:13
    networks:
      static-net:
        ipv4_address: 172.22.0.20

networks:
  static-net:
    driver: bridge
    ipam:
      config:
        - subnet: 172.22.0.0/24
          gateway: 172.22.0.1

启动服务：docker-compose up -d

🔧 方法四：修改现有容器的IP地址

修改已运行容器的IP需要重新创建容器：

# 1. 停止并删除容器
docker stop my-container && docker rm my-container

# 2. 创建自定义网络（如果尚未创建）
docker network create --subnet=10.5.0.0/16 custom-net

# 3. 使用新IP重新运行容器
docker run -d --name my-container \
  --network custom-net \
  --ip 10.5.0.100 \
  nginx:alpine

🔍 验证静态IP配置

# 检查容器IP
docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' web-server

# 进入容器测试网络
docker exec -it web-server sh
ping 8.8.8.8

⚠️ 注意事项及常见问题解决

1. IP地址冲突

   • 解决方案：使用--ip-range限制可用IP范围
   • 检查IP是否可用：ping <目标IP>

2. 默认bridge网络不支持静态IP

   • 必须创建自定义网络

3. macvlan网络宿主机无法访问容器

   • 解决方法：创建macvlan接口

   sudo ip link add host-macvlan link eth0 type macvlan mode bridge
   sudo ip addr add 192.168.1.99/24 dev host-macvlan
   sudo ip link set host-macvlan up
   

4. 云环境限制问题

   • 解决方案：改用ipvlan模式

   docker network create -d ipvlan \
     --subnet=192.168.1.0/24 \
     --gateway=192.168.1.1 \
     -o parent=eth0 \
     -o ipvlan_mode=l2 \
     ipvlan-net
   

📊 静态IP与动态IP对比

特性	静态IP	动态IP
地址稳定性	永久固定	容器重启可能改变
网络配置	需要手动管理	自动分配
适用场景	服务发现、固定端点的应用	临时性、无状态应用
容器间通信	可直接通过IP访问	需要通过容器名或服务名

💡 最佳实践建议

1. 使用自定义DNS名称替代IP

   docker run -d --name service1 --network my-net nginx
   docker run -d --name service2 --network my-net alpine ping service1
   

2. 结合端口映射使用

   docker run -d --name web \
     --network my-static-net \
     --ip 172.20.5.10 \
     -p 8080:80 \
     nginx:alpine
   

3. 多容器网络配置

   docker network create app-network --subnet=10.1.0.0/24
   
   docker run -d --name db \
     --network app-network \
     --ip 10.1.0.100 \
     postgres
   
   docker run -d --name app \
     --network app-network \
     --ip 10.1.0.101 \
     -e DB_HOST=10.1.0.100 \
     my-app-image
   

通过以上方法，您可以根据实际需求为Docker容器配置静态IP地址，确保网络配置的稳定性和可预测性。