# DNS、靜態記錄與廣告過濾

## `[dns]`

| 鍵 | 類型 | 說明 |
|---|---|---|
| `system-dns` | IP 清單 | 已棄用的舊覆寫設定，僅在自訂 App 分流與簡易模式都關閉時使用。新設定檔請優先使用 `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 上游；App 提供預設值。 |
| `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 回答，不是路由規則，也不是萬用網域後綴。請另外設定路由，並在此範例啟用 App 分流：

```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
```