如何在无IPAM配置的Docker桥接网络中自动分配静态IP？

当Docker网络未配置IPAM时，直接在docker-compose.yml中指定ipv4_address会触发报错：

$ docker compose up -d
[+] Running 1/2
 ⠿ Network br-uplink  Created
 ⠋ Container nginx    Creating
Error response from daemon: user specified IP address is supported only when connecting to networks with user configured subnets

手动进入容器执行以下命令可成功设置静态IP：

docker compose exec nginx bash
ip add flush dev eth0
ip add add 192.168.11.2/24 dev eth0

解决方案：通过entrypoint实现IP配置自动化 #

无需自定义Dockerfile，只需在docker-compose.yml中通过entrypoint覆盖容器启动流程，先执行IP配置命令再启动原有服务。以linuxserver/nginx镜像为例（该镜像默认以/init作为启动入口），修改后的配置如下：

version: "2.1"
services:
  nginx:
    image: ghcr.io/linuxserver/nginx
    container_name: nginx
    volumes:
      - ./config:/config
    ports:
      - 443:443
    restart: always
    networks:
      - br-uplink
    # 先完成IP配置，再启动原有服务进程
    entrypoint: >
      bash -c "ip addr flush dev eth0 && ip addr add 192.168.11.2/24 dev eth0 && exec /init"

networks:
  br-uplink:
    driver: bridge
    name: br-uplink

关键说明： #

• exec /init用于替换当前进程为容器原有服务进程，确保容器能正常接收停止、重启等系统信号，避免进程脱离管理。
• 若使用其他基础镜像，需将/init替换为对应镜像的启动命令（如官方nginx镜像需改为nginx -g 'daemon off;'）。
• 需确保容器内预装ip命令（多数Linux发行版镜像默认包含该工具）。

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