如何让Docker容器使用服务器指定的IoT网段静态IP？

问题背景 #

服务器配置双静态IP：主网段192.168.1.100，IoT独立网段192.168.7.200，希望HomeAssistant容器使用IoT网段IP对外提供服务，但配置自定义Docker桥接网络后，无法通过192.168.7.200:8123访问HomeAssistant界面，Portainer通过主IP正常访问，容器网络配置在Portainer中显示无异常。

原配置文件：

version: '3.0'

services:
  portainer:
    container_name: portainer
    image: portainer/portainer-ce
    restart: always
    ports:
      - "9000:9000/tcp"
    environment:
      - TZ=Europe/London
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /opt/portainer:/data
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - /opt/homeassistant/config:/config
      - /etc/localtime:/etc/localtime:ro
    restart: unless-stopped
    privileged: true
    networks:
      static-network:
        ipv4_address: 192.168.7.200
networks:
  static-network:
    ipam:
      config:
        - subnet: 192.168.7.0/24

问题根源 #

你创建的static-network是Docker默认的桥接网络，属于内部NAT虚拟网络，和服务器物理网卡的IoT网段192.168.7.0/24完全重叠，导致外部数据包路由混乱：发往192.168.7.200的请求会被Docker的NAT规则拦截，无法正确转发到容器。

解决方案 #

方案一：端口绑定指定IP（简单易操作） #

不需要自定义网络，直接在HomeAssistant服务的ports配置中，指定绑定到服务器的IoT网段IP，让容器端口仅监听该IP：

version: '3.0'

services:
  portainer:
    container_name: portainer
    image: portainer/portainer-ce
    restart: always
    ports:
      - "9000:9000/tcp"
    environment:
      - TZ=Europe/London
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /opt/portainer:/data
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - /opt/homeassistant/config:/config
      - /etc/localtime:/etc/localtime:ro
    restart: unless-stopped
    privileged: true
    ports:
      - "192.168.7.200:8123:8123/tcp" # 仅绑定IoT网段IP的8123端口

修改后执行docker-compose up -d重启容器，即可通过192.168.7.200:8123访问HomeAssistant。

方案二：使用Macvlan网络（容器成为IoT网段独立设备） #

如果需要容器拥有IoT网段的独立IP（无需端口映射，和服务器IP同网段），可以创建Macvlan网络直接关联物理网卡：

1. 先通过ip addr命令查看服务器物理网卡名称（例如eth0）
2. 修改Compose配置，注意容器IP不能和服务器的192.168.7.200重复，同时指定IoT网段网关：

version: '3.0'

services:
  portainer:
    container_name: portainer
    image: portainer/portainer-ce
    restart: always
    ports:
      - "9000:9000/tcp"
    environment:
      - TZ=Europe/London
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /opt/portainer:/data
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - /opt/homeassistant/config:/config
      - /etc/localtime:/etc/localtime:ro
    restart: unless-stopped
    privileged: true
    networks:
      iot-macvlan:
        ipv4_address: 192.168.7.201 # 与服务器IoTIP不重复
networks:
  iot-macvlan:
    driver: macvlan
    driver_opts:
      parent: eth0 # 替换为你的物理网卡名称
    ipam:
      config:
        - subnet: 192.168.7.0/24
          gateway: 192.168.7.1 # 替换为IoT网段实际网关

注意：Macvlan网络默认隔离主机与容器，服务器本身无法直接访问容器IP，适合仅外部IoT设备访问的场景。

内容的提问来源于stack exchange，提问作者Erick W