首页/云/Docker 容器速查/compose extra_hosts 注入 hosts 记录
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条
Compose 编排55 条
资源与安全50 条容器排障52 条

compose extra_hosts 注入 hosts 记录

在 compose 文件里为服务追加 /etc/hosts 记录:常用 host-gateway 指向宿主机,或把内部系统域名解析到固定地址。

Docker 容器速查云更新于 2026-10-12
字段extra_hosts(列表或映射)
特殊值host-gateway 代表宿主机
用途容器访问宿主服务、内网域名固定解析

示例

示例
services:
  api:
    image: app/api:1.4.2
    extra_hosts:
      - "host.docker.internal:host-gateway"
      - "legacy.internal:10.0.0.8"
    environment:
      - UPSTREAM=http://host.docker.internal:9000
记录在容器创建时写入;宿主地址变化后需要重建容器,不太适合频繁变动的地址。

易错点

  • host-gateway 仅在支持的 Docker 版本与平台上可用,老版本需用宿主真实 IP
  • 与容器 DNS 解析同名冲突时按 /etc/hosts 优先,排查解析先看这里

数据来源与参考

  • Docker 官方文档:Compose extra_hosts(docs.docker.com/reference/compose-file/services)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌