Docker容器DNS搜索域持久化需通过daemon.json全局配置或docker-compose.yml项目配置实现。运行时--dns-search仅临时有效；daemon.json设置dns-search字段可使所有新建容器默认继承；docker-compose.yml中用dns_search键支持数组或字符串格式，兼顾版本控制与团队协作。
在 Docker 中配置容器的 DNS 搜索域（DNS search domain）并实现持久化，关键在于区分运行时临时配置与长期生效的配置方式。默认情况下，Docker 容器会继承宿主机的 /etc/resolv.conf，但不自动继承搜索域；而手动用 --dns-search 启动的容器，其设置在重启后会丢失——所以“持久化”必须落实到 Docker 的配置文件或编排工具中。
使用 --dns-search 运行时指定（临时有效）
这是最直接的方式，适用于调试或单次运行：
- 启动容器时通过
--dns-search添加搜索域，可多次使用以添加多个域 - 例如：
docker run --dns-search example.com --dns-search internal.net nginx - 进入容器执行
cat /etc/resolv.conf，可见search example.com internal.net行 - ⚠️ 注意：该配置仅对当前容器实例有效，
docker start重启不会保留，也不影响镜像构建过程
通过 daemon.json 全局配置（宿主机级持久化）
若希望所有新创建的容器（除非显式覆盖）都默认包含指定搜索域，修改 Docker 守护进程配置是最稳妥的持久化方式：
- 编辑
/etc/docker/daemon.json（Linux/macOS），Windows Docker Desktop 需通过 Settings → Docker Engine 修改 - 添加
dns-search字段，例如：
{
"dns-search": ["example.com", "svc.cluster.local"]
}- 保存后执行
sudo systemctl restart docker（或 Windows/macOS 上重启 Docker） - 此后所有新建容器（包括
docker-compose up启动的）都会自动包含这些搜索域 - ✅ 优势：统一管理、无需每次写参数、兼容 CI/CD 和编排环境
在 docker-compose.yml 中声明（项目级持久化）
对具体应用项目，推荐在 docker-compose.yml 中定义，兼顾可读性与版本控制：
- 在服务下使用
dns_search键（注意是下划线，非短横线） - 示例：
services:
app:
image: nginx
dns_search:
- example.com
- dev.internal- 支持数组形式，也可写成字符串
dns_search: "example.com dev.internal" - 该配置随 compose 文件一起提交 Git，团队协作和部署时自动生效
- ⚠️ 注意：
docker run命令行参数优先级高于 compose 配置，会覆盖后者
构建镜像时固化（仅限 /etc/resolv.conf 内容，不推荐）
不建议在 Dockerfile 中用 RUN echo "search ..." > /etc/resolv.conf，原因如下：
- Docker 构建阶段的
/etc/resolv.conf仅用于 build-time DNS 解析（如apt update），与运行时无关 - 容器启动时，Docker 会重新生成
/etc/resolv.conf，覆盖镜像中的内容 - 强行挂载或只读绑定会破坏容器网络功能，引发不可预知问题
