Docker容器静态IP外部访问超时问题求助

我尝试为应用分配静态IP，已通过docker-compose.yaml配置指定IP为172.16.238.10，容器内可通过curl访问该IP，但外部通过浏览器或curl访问时出现超时；本地访问http://localhost:3000正常，请问能否将该静态IP暴露给外部？

配置文件（docker-compose.yaml） #

version: '3.8'
services:
  client:
    container_name: client
    build: ./frontend
    ports:
      - 3000:3000
    working_dir: /app
    volumes:
      - ./frontend:/app/
      - /app/node_modules
    networks:
      app_net:
        ipv4_address: 172.16.238.10
    hostname: client
    command: npm run dev
networks:
  app_net:
    driver: bridge
    ipam:
      driver: default
      config:
        - subnet: "172.16.238.0/24"

容器启动日志 #

client    | > frontend@0.0.0 dev
client    | > vite
client    | 
client    | 
client    |   VITE v3.2.2  ready in 710 ms
client    | 
client    |   ➜  Local:   http://localhost:3000/
client    |   ➜  Network: http://172.16.238.10:3000/

外部访问报错信息 #

This site can’t be reached
172.16.238.10 took too long to respond.
ERR_CONNECTION_TIMED_OUT

• 容器静态IP无法直接暴露给外部的原因：你配置的172.16.238.10是Docker桥接网络的内部私有IP，属于Docker默认内网范围，仅在宿主机和容器集群内部可见，外部设备（包括同一局域网的其他机器）无法直接访问该IP——因为这个网段没有被路由到外部网络中。

• 可行的访问方案：

  1. 使用宿主机IP+映射端口访问：你已经配置了ports: - 3000:3000端口映射，外部可以直接通过宿主机的公网/局域网IP加上3000端口访问，比如http://[宿主机IP]:3000，这是Docker暴露服务的标准方式。
  2. 优化Vite监听配置（可选）：确保Vite服务监听容器的所有网卡，可修改启动命令为npm run dev -- --host 0.0.0.0，虽然日志显示Vite已经识别了内部IP，但加上--host 0.0.0.0能避免服务仅绑定localhost的情况，提升兼容性。

• localhost访问正常的原因：localhost:3000是通过Docker端口映射规则直接转发到容器内部服务，宿主机的localhost会直接关联端口映射，因此能正常访问。

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