首页/云/Docker 容器速查/容器 DNS 参数 --dns / --dns-search 配置
本包目录(366 条)
基础命令50 条镜像与构建107 条
网络与存储52 条
Compose 编排55 条资源与安全50 条容器排障52 条

容器 DNS 参数 --dns / --dns-search 配置

自定义容器的 DNS 上游服务器与搜索域:隧道、内网域名环境下需要显式指定 DNS,否则新环境里域名解析会异常。

Docker 容器速查云更新于 2026-10-12
用途控制容器 DNS 与搜索域
参数--dns IP / --dns-search 域 / --dns-opt 选项
持久化daemon.json 的 dns 字段

示例

示例
docker run -d --dns 223.5.5.5 --dns 119.29.29.29 app/web:1.0
docker exec <容器> cat /etc/resolv.conf
docker run --dns-search internal.example.com --dns-opt timeout:2 app:1.0
自定义网络下容器名仍由内嵌 DNS 解析,--dns 影响的是外部域名转发方向。

易错点

  • 容器内手改 /etc/resolv.conf 在容器重建后丢失,正确做法是 run 参数或 daemon 级配置
  • 公司内网 DNS 与公共 DNS 混用时解析结果不一致,按环境要求固定上游

数据来源与参考

  • Docker 官方 CLI 参考:docker run 的 --dns 系列参数(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌