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

docker run --add-host 注入 hosts 记录

把额外的 名称→IP 映射写进容器 /etc/hosts:适合指向宿主机服务或外部固定地址,host-gateway 是代表宿主的特殊值。

Docker 容器速查云更新于 2026-10-12
用途注入 /etc/hosts 条目
语法--add-host 名称:IP(可多次)
特殊值host-gateway 表示宿主机

示例

示例
docker run -d --add-host api.internal:10.0.0.8 --add-host host.docker.internal:host-gateway nginx
docker exec <容器> cat /etc/hosts
Linux 上 host-gateway 常配合 --add-host host.docker.internal:host-gateway 访问宿主机服务,避免写死 IP。

易错点

  • 修改 hosts 里的 IP 需要重建容器(记录在创建时写入),运行中改不了
  • 条目与真实 DNS 同名时会按 /etc/hosts 优先级覆盖,排查解析问题时先看它

数据来源与参考

  • Docker 官方 CLI 参考:docker run 的 --add-host(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌