持久化 dns 搜索域有三种可靠路径：全局守护进程级（修改 daemon.json）、项目编排级（docker-compose.yml 中 dns_search）、运行时临时指定（--dns-search）；不推荐在 dockerfile 中硬编码 resolv.conf。
要在 Docker 中让容器稳定使用指定的 DNS 搜索域（比如访问 db 自动补全为 db.example.com），关键不是“每次启动都加参数”，而是把搜索域固化进配置体系——否则容器重启、重部署后就失效。持久化有三种可靠路径：全局守护进程级、项目编排级、以及（不推荐的）镜像构建级。
通过 daemon.json 全局设置（推荐用于统一环境）
修改 Docker 守护进程配置，使所有新建容器默认携带搜索域，适合团队共用或 CI/CD 流水线：
- 编辑
/etc/docker/daemon.json（Linux/macOS）或通过 Docker Desktop 的 Settings → Docker Engine（Windows/macOS） - 添加
"dns-search"字段，支持数组格式：
{ "dns-search": ["example.com", "svc.cluster.local"] } - 保存后重启 Docker 服务：
sudo systemctl restart docker（Linux）或点击 Docker Desktop 的 “Apply & Restart” - 此后所有新创建的容器（包括
docker-compose up启动的）都会在/etc/resolv.conf中自动生成search example.com svc.cluster.local行
在 docker-compose.yml 中声明（推荐用于项目协作）
将 DNS 搜索域作为服务属性写入编排文件，便于 Git 版本管理、环境隔离和复现：
- 在服务定义下使用
dns_search（注意是下划线，不是短横线）键 - 支持字符串或数组形式，例如：
services:
app:
image: nginx
dns_search:
- example.com
- dev.internal - 该配置随 compose 文件一起生效，
docker-compose up启动即加载，无需额外命令 - 注意：
docker run --dns-search参数优先级更高，会覆盖 compose 中的设置
运行时临时指定（仅限调试验证）
适用于快速验证或单次测试，但不持久：
- 启动容器时用
--dns-search添加一个或多个域：docker run --dns-search example.com --dns-search internal.net nginx - 进入容器执行
cat /etc/resolv.conf可看到search example.com internal.net - ⚠️ 容器停止再
docker start后该设置丢失；镜像构建阶段也不受此影响
不建议的固化方式：Dockerfile 中硬编码 resolv.conf
虽然可行，但违背容器设计原则，容易引发冲突：
- 在 Dockerfile 中用
RUN echo "search example.com" >> /etc/resolv.conf会覆盖基础镜像原有内容 - 若基础镜像已含
search或后续被其他工具（如 k8s initContainer）修改，结果不可控 - 无法动态适配不同环境（开发/测试/生产），维护成本高
