如何将Docker-Compose网络固定到容器同一内部接口？

问题背景 #

我用Docker-Compose部署了Pi-hole容器，配置了两个网络接口：

• 一个是macvlan类型的pihole_network（网段192.168.2.0/24），负责提供DHCP和DNS服务
• 另一个是bridge网络，用于容器间通信（比如反向代理访问Pi-hole管理界面）

但每次重建容器（比如更新镜像）时，负责DHCP的接口会随机被分配为eth0或eth1，导致dnsmasq无法按配置指定的接口处理DHCP请求。

现有Docker-Compose配置如下：

networks:
  pihole_network:                    
    driver: macvlan
    driver_opts:
      parent: eth2                   
    ipam:
      config:
        - subnet: 192.168.2.0/24
          gateway: 192.168.2.1
          ip_range: 192.168.2.50/32

services:
  pihole:
    container_name: pihole
    image: pihole/pihole:latest 
    ports:
    - "53:53/tcp"
    - "192.168.2.199:53:53/udp"
    - "67:67/udp"
    - "8081:8080/tcp"
    - "30001:443/tcp"
    networks:
      pihole_network: 
        ipv4_address: 192.168.2.50
    dns:
      - 127.0.0.1
      - 8.8.8.8
    environment:
      ServerIP: 192.168.2.50  
      TZ: 'Europe/Zurich'
      WEBPASSWORD: 'XXX'
      DHCP_ACTIVE: 'false'
      WEBTHEME: 'default-dark'
      WEB_PORT: 8081
      DNSMASQ_USER: 'root'
    labels:
      // LABELS// 
    volumes:
      // VOLUMES// 
    cap_add:
      - NET_ADMIN
    restart: unless-stopped
    logging:
      driver: json-file
      options:
        max-size: "10m"

  connect-bridge:
    image: stmllr/docker-client
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    depends_on:
        - pihole
    command: /bin/sh -c 'docker ps -f label=networks=bridge --format "{{.ID}}" | xargs docker network connect bridge pihole'  

解决方案 #

1. 直接在Docker-Compose中控制网络连接顺序（最简便） #

原来通过connect-bridge容器动态连接bridge网络的方式，会导致网络接口顺序不可控。改为直接在Pi-hole服务的networks字段中按顺序声明两个网络，Docker会按照列表顺序为容器分配接口：第一个网络对应eth0，第二个对应eth1。

修改后的Docker-Compose配置：

networks:
  pihole_network:                    
    driver: macvlan
    driver_opts:
      parent: eth2                   
    ipam:
      config:
        - subnet: 192.168.2.0/24
          gateway: 192.168.2.1
          ip_range: 192.168.2.50/32
  # 使用Docker默认的bridge网络
  bridge:
    external: true

services:
  pihole:
    container_name: pihole
    image: pihole/pihole:latest 
    ports:
    - "53:53/tcp"
    - "192.168.2.199:53:53/udp"
    - "67:67/udp"
    - "8081:8080/tcp"
    - "30001:443/tcp"
    networks:
      # 第一个网络：pihole_network，对应容器内eth0（DHCP服务用）
      pihole_network: 
        ipv4_address: 192.168.2.50
      # 第二个网络：bridge，对应容器内eth1（容器间通信用）
      bridge:
    dns:
      - 127.0.0.1
      - 8.8.8.8
    environment:
      ServerIP: 192.168.2.50  
      TZ: 'Europe/Zurich'
      WEBPASSWORD: 'XXX'
      DHCP_ACTIVE: 'false'
      WEBTHEME: 'default-dark'
      WEB_PORT: 8081
      DNSMASQ_USER: 'root'
    labels:
      // LABELS// 
    volumes:
      // VOLUMES// 
    cap_add:
      - NET_ADMIN
    restart: unless-stopped
    logging:
      driver: json-file
      options:
        max-size: "10m"

这样每次启动/重建容器时，pihole_network都会被分配为eth0，bridge网络为eth1，彻底固定接口顺序。

2. 强制dnsmasq绑定特定IP/接口（双重保障） #

即使接口顺序意外变化，也可以通过配置dnsmasq强制绑定提供DHCP服务的IP或接口：

• 在Pi-hole的持久化目录中创建/etc/dnsmasq.d/99-custom.conf文件
• 添加以下配置（二选一即可）：

  # 绑定到固定IP（推荐，不受接口名影响）
  interface=192.168.2.50
  # 或者绑定到固定接口名（如果已经通过方法1固定了接口顺序）
  # interface=eth0
  # 禁止dnsmasq监听所有接口
  bind-interfaces
  

3. 修改Docker容器网络接口命名规则（进阶） #

如果需要更底层的控制，可以修改Docker的daemon配置，自定义容器网络接口的命名规则：

• 编辑/etc/docker/daemon.json（如果不存在则创建）
• 添加以下配置：

  {
    "default-address-pools": [
      {"base": "172.17.0.0/16", "size": 24}
    ],
    "bridge": "docker0",
    "ip-forward": true,
    "ip-masq": true,
    "networks": {
      "pihole_network": {
        "interface": "eth0"
      },
      "bridge": {
        "interface": "eth1"
      }
    }
  }
  

• 重启Docker服务：systemctl restart docker

内容的提问来源于stack exchange，提问作者Henrik P. Hessel