家庭局域网Docker容器静态IP配置失败问题排查

错误根源 #

你当前的配置错误地将容器端口绑定到宿主机未分配的IP（192.168.1.241/242），Docker无法在宿主机上绑定不存在的IP地址，导致启动报错。你混淆了「宿主机端口绑定」和「容器独立静态IP」的实现逻辑。

正确配置容器静态IP的方法 #

要让容器在自定义bridge网络中拥有专属静态IP，需为自定义网络指定子网段，并给每个服务分配子网内的固定IP。修改后的lab.yml配置如下：

version: "3"

services:
  postgres:
    image: postgres:14.1
    container_name: postgres
    restart: always
    # 若需通过宿主机IP访问，保留端口映射；仅通过容器静态IP访问可省略此段
    ports:
      - "5432:5432"
    depends_on:
      - webmin
    environment:
      POSTGRES_USER: openfire
      POSTGRES_PASSWORD: password
      POSTGRES_HOST_AUTH_METHOD: trust
    networks:
      docker-lab:
        ipv4_address: 192.168.200.2  # 给postgres分配静态IP

  webmin:
    image: 'chsliu/docker-webmin'
    container_name: webmin
    restart: always
    ports:
      - "10000:10000"
      - "53:53/tcp"
      - "53:53/udp"
    environment:
      POSTGRES_USER: openfire
      POSTGRES_PASSWORD: password
      POSTGRES_HOST_AUTH_METHOD: trust
    networks:
      docker-lab:
        ipv4_address: 192.168.200.3  # 给webmin分配静态IP

networks:
  docker-lab:
    driver: bridge
    ipam:
      config:
        - subnet: 192.168.200.0/24  # 自定义子网段，需与家庭局域网（192.168.1.x）不重叠

核心要点说明 #

• 子网段选择：自定义网络的子网必须和家庭局域网网段（你的是192.168.1.x）不重复，避免IP冲突。示例中用了192.168.200.0/24，可按需调整。
• 容器静态IP分配：每个服务的ipv4_address必须落在自定义网络的子网范围内。
• 访问方式：家庭局域网内设备可直接通过容器静态IP访问服务（如192.168.200.2:5432访问PostgreSQL，192.168.200.3:10000访问Webmin）。

执行步骤 #

1. 清理现有容器（若已启动）：

   docker-compose -f lab.yml down
   

2. 启动修改后的容器：

   docker-compose -f lab.yml up -d
   

3. 验证容器IP是否配置成功：

   docker inspect postgres | grep -A2 IPAddress
   docker inspect webmin | grep -A2 IPAddress
   

内容的提问来源于stack exchange，提问作者Hid-K