# DNS、静态记录与广告过滤

## `[dns]`

| 键 | 类型 | 说明 |
|---|---|---|
| `system-dns` | IP 列表 | 已弃用的旧覆盖设置，仅当自定义应用分流和简易模式都关闭时使用。新配置优先使用 `direct-dns`。 |
| `app-routing-enabled` | 布尔值 | 启用域名分流与分流 DNS。新配置设为 `true`；旧 `false` 路径已弃用。 |
| `direct-dns` | DNS 上游列表 | `app-routing-enabled=true` 时用于直连的 DNS，支持普通 IP DNS、DoT、DoH。 |
| `vpn-dns` | DNS 上游列表 | `app-routing-enabled=true` 时用于 VPN/代理的 DNS，支持普通 IP DNS、DoT、DoH。 |
| `bootstrap-dns` | IP 列表 | 1.9.0 新增，用于解析以域名配置的加密 VPN DNS 上游；应用提供默认值。 |
| `direct-dns-follow-vpn` | 布尔值 | 1.8.0 新增，直连 DNS 服务器是否遵循分流规则。 |
| `optimistic-dns-caching` | 布尔值 | 1.9.0 新增，启用乐观 DNS 缓存刷新，默认 `true`。 |
| `l4proxy-synthetic-ip` | 布尔值 | 为 L4 代理域名分流启用合成 IP 处理，默认 `false`。 |

DNS 上游格式：

- 普通 IP DNS：`1.1.1.1`、`8.8.8.8`
- DNS-over-TLS：`tls://cloudflare-dns.com` 或 `tls://1.1.1.1`
- DNS-over-HTTPS：`https://dns.google/dns-query`

当 `vpn-dns` 含带域名的加密 DNS 服务器（如 `tls://p2.freedns.controld.com`），添加 `VPN-DNS-SERVER-DOMAINS` 路由，使其域名解析经由所选 VPN/代理，避免引导查询走直连网络。

```ini
[dns]
app-routing-enabled=true
direct-dns=223.5.5.5,114.114.114.114
vpn-dns=tls://p2.freedns.controld.com,https://dns.google/dns-query
bootstrap-dns=1.1.1.1,8.8.8.8
optimistic-dns-caching=true
```

## `[dns-hosts]`（Pro）

精确主机名到 IPv4 地址的映射，由 MintFlow DNS 提供。这些是 DNS 应答，不是路由规则，也不是通配域名后缀。另行配置路由，并在此示例中启用应用分流：

```ini
[dns]
app-routing-enabled=true
direct-dns=1.1.1.1,8.8.8.8

[dns-hosts]
nas.example.com=192.168.40.10
```

最多支持 256 个主机名，每个主机名 1–16 个 IPv4 地址。静态主机记录与派生 Tailscale 记录受权限及生效 DNS 配置检查约束，请查看编译报告。

## `[dns-adblock]`（免费）

可选的本地 DNS 广告拦截，支持简易模式和规则模式，必须启用内部 DNS。设置、优先级、更新和限制见[内部 DNS 服务器](../core-components/internal-dns.md)。

| 键 | 说明 |
|---|---|
| `enabled` | 布尔值，默认 `false`。启用所选过滤列表。 |
| `list` | 可选 `adguard-dns`（默认）、`hagezi-normal` 或 `oisd-small`，不支持自定义 URL 或叠加列表。 |

```ini
[dns-adblock]
enabled=true
list=adguard-dns
```