Mosdns

https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5
Admin
Mosdns is a pluggable DNS forwarder. Users can customize their DNS processing logic as needed.
Tokens:16,211
Snippets:125
Trust Score:10
Update:1 week ago
Show doc for...
Tokens:
Raw
### Manage mosdns system service with service subcommand

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5

Installs, starts, stops, and uninstalls mosdns as a system service. Requires administrator or root privileges. The service is set to start automatically on system boot, but must be started manually after installation. Not available on Openwrt.

```bash
# 安装服务
mosdns service install -d 工作目录绝对路径 -c 配置文件路径
# 安装成功后手动运行服务。(服务仅设定为随系统自启，安装成功后并不会马上自动运行)
mosdns service start

# 卸载
mosdns service stop
mosdns service uninstall
```

--------------------------------

### prefer_ipv4 sequence examples

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

Two sequence examples showing how to use prefer_ipv4. The first applies to all requests, the second uses a matcher to apply only to specific domains. Both require a forward operation later to generate responses.

```yaml
# 所有请求都优先返回 ipv4，屏蔽 ipv6。
- exec: prefer_ipv4
- ...
- exec: forward 8.8.8.8

# 配合匹配器实现仅特定域名生效。
- matches:
    - qname my.domain
  exec:
    - prefer_ipv4
- ...
- exec: forward 8.8.8.8
```

--------------------------------

### ipset sequence example

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

Example sequence configuration using ipset. It shows a sequence with cache, forward, and ipset operations. The comment explains that ipset is refreshed on every request.

```yaml
tag: ""
type: "sequence"
args:
  - exec: cache 1024
  - matches:        # 如果缓存命中，则不会转发请求至上游。
    - "!has_resp"
    exec: forward 8.8.8.8
  - exec: ipset ...  # ipset 每次请求都能被刷新
```

--------------------------------

### Start mosdns with config file and working directory

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5

Starts the mosdns DNS forwarder with a specified configuration file and working directory. The -c flag specifies the config file path, and -d specifies the working directory.

```bash
mosdns start -c config_file -d working_dir
```

--------------------------------

### nftset example

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

Example usage of the nftset operation. It writes IPs to nftables sets. The example uses inet table family, my_table, my_set, ipv4_addr and ipv6_addr set types, with masks 24 and 48.

```text
nftset inet,my_table,my_set,ipv4_addr,24 inet,my_table,my_set,ipv6_addr,48
```

--------------------------------

### GET /plugins/<plugin_tag>

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/api-shuo-ming

插件 API 的入口，用于调用特定插件。参数取决于插件。

```APIDOC
## GET /plugins/<plugin_tag>

### Description
插件 API 的入口，用于调用特定插件。参数取决于插件。

### Method
GET

### Endpoint
`http://<api_addr>/plugins/<plugin_tag>`

### Parameters
#### Path Parameters
- **plugin_tag** (string) - Required - 插件标签。

### Response
#### Success Response (200)
响应内容取决于插件。

```

--------------------------------

### GET /debug/pprof/

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/api-shuo-ming

pprof 性能分析工具的入口，用于获取性能分析数据。

```APIDOC
## GET /debug/pprof/

### Description
pprof 性能分析工具的入口，用于获取性能分析数据。

### Method
GET

### Endpoint
`http://<api_addr>/debug/pprof/`

### Response
#### Success Response (200)
pprof 性能分析数据。

```

--------------------------------

### GET /metrics

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/api-shuo-ming

Prometheus Metrics API 的入口，用于获取监控指标。包含一些默认数据项，部分插件会添加新数据项。

```APIDOC
## GET /metrics

### Description
Prometheus Metrics API 的入口，用于获取监控指标。包含一些默认数据项，部分插件会添加新数据项。

### Method
GET

### Endpoint
`http://<api_addr>/metrics`

### Response
#### Success Response (200)
Prometheus 格式的指标数据。

```

--------------------------------

### Show help for mosdns and probe subcommand

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5

Displays help for the main mosdns command and the probe subcommand. Use these to see available options and usage details for each command.

```bash
mosdns -h
mosdns probe -h
```

--------------------------------

### qname 匹配器参数

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

匹配请求的 QNAME。参数格式为 qname { domain_rule | $domain_set_tag | &domain_list_file } ...。

```text
qname { domain_rule | $domain_set_tag | &domain_list_file } ...
```

--------------------------------

### 基本配置文件格式示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns

展示 mosdns 配置文件的基本结构，包括日志设置、API 入口、include 选项和插件设置。注意 include 的插件会先于本配置文件中的插件初始化。

```yaml
log:
  level: info   # 日志级别。可选 "debug" "info" "warn" "error"。默认 "info"。
  production: false            # 纯 json 输出。
  file: "/path/to/log/file"    # (实验性) 记录日志到文件。默认输出至 stderr。
                               # 注意: 日志应由守护进程处理而不是直接写入文件。
                               # 此选项仅用于调试。panic 日志不会被记录，其内容仍会
                               # 输出至 stderr 。

  
# (实验性) API 入口设置   
api:
  http: "127.0.0.1:8080" # 在该地址启动 api 接口。

# []string, 从其他配置文件载入 plugins 插件设置。
# include 的插件会比本配置文件中的插件先初始化。
include: []

# 插件设置
plugins:
  - tag: tag1     # 插件的 tag。由用户自由设定但不能重复。可省略。
    type: type1   # 插件类型。详见下文。
    args:         # 插件参数。取决于插件类型。详见下文。
      key1: value1
```

--------------------------------

### env 匹配器参数

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

匹配环境变量。参数格式为 env env_key [env_value]。

```text
env env_key [env_value]
```

--------------------------------

### qname 匹配器示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

示例展示了如何匹配域名表达式、domain_set 标签和 domain_list 文件。

```text
qname google.com full:google.com $local_domains &./local_domains.txt
```

--------------------------------

### 配置示例：缓存、广告屏蔽和 Google DoH 转发

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns

使用 sequence 插件定义处理流程：先匹配广告域名并拒绝，然后查找缓存，若无缓存则转发至 Google DoH。同时启动 UDP 和 TCP 服务器监听 127.0.0.1:5533。广告列表 oisd_dbl_basic.txt 来自 oisd.nl。

```yaml
log:
  level: info

plugins:
  - tag: main
    type: sequence
    args:
      - matches:             # 如果
          - qname &./oisd_dbl_basic.txt # 如果请求的域名在广告列表内。
        exec: reject 3       # 执行 直接返回 NXDOMAIN(3) 屏蔽。
      - exec: cache 1024     # 然后。查找 cache。
      - matches:             # 如果
          - has_resp         # 有应答了(上一步 cache 找到应答)
        exec: accept         # 结束。

      # 上一步没有找到缓存，就会到这一步，转发至 Google 获取应答。
      - exec: forward https://8.8.8.8/dns-query
      # sequence 结束(被 reject，accept，或者运行到末尾)后就会返回调用者。在这个配置文件中
      # 调用者是下面的服务器。服务器就会返回应答至客户端。


  # 启动 udp 和 tcp 服务器。
  - type: udp_server
    args:
      entry: main # 收到的请求会执行上面的逻辑
      listen: 127.0.0.1:5533
  - type: tcp_server
    args:
      entry: main
      listen: 127.0.0.1:5533
```

--------------------------------

### string_exp 匹配器参数

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

字符串匹配器（实验性）。参数格式为 string_exp string_src op [arg_string]。

```text
string_exp string_src op [arg_string]
```

--------------------------------

### mark 匹配器参数

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

匹配请求的标记。参数格式为 mark [uint32] ...。

```text
mark [uint32] ...
```

--------------------------------

### arbitrary 插件初始化配置示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/ke-zhi-xing-cha-jian

arbitrary 插件载入任意 zone file 记录，并在匹配请求时生成应答。rules 中每行是一条 DNS 记录，files 可指定记录文件。

```yaml
tag: ""
type: "arbitrary"
args:
  rules:
    - example.com. 300 IN A 192.0.2.1
    - _sip._tcp.example.com. 86400 IN SRV 0 5 5060 sipserver.example.com.
  files:
    - ./arbitrary.txt
```

--------------------------------

### forward 插件初始化配置示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/ke-zhi-xing-cha-jian

forward 插件用于转发请求至上游服务器。配置中 concurrent 控制并发数，upstreams 至少配置一个。示例展示了 DoH 和 TCP 两种上游，包含 dial_addr、bootstrap、socks5、enable_pipeline 等参数。

```yaml
tag: ""
type: "forward"
args:
  concurrent: 1 # 并发数。每次请求会从下面配置的 upstreams 里随机选取
                # concurrent 个 upstreams 发送请求。取最快返回的应答。超过 3 最多选
                # 3 个。默认 1 。
  upstreams:    # []upstream, 上游服务器。至少要配置一个。
    - tag: google_doh
      addr: "https://dns.google/dns-query"
      dial_addr: "8.8.8.8"
      bootstrap: "8.8.8.8"
      bootstrap_version: 4
      socks5: "127.0.0.1:1080"
      idle_timeout: 30
      enable_pipeline: false
      enable_http3: false
      max_conns: 2
      insecure_skip_verify: false
      so_mark: 0
      bind_to_device: ""
    - addr: "tcp://8.8.8.8"
      enable_pipeline: true
```

--------------------------------

### 配置示例：仅转发至 Google

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns

如果只需转发，无需其他功能，则可以让服务器插件直接将请求转交给 forward 插件。此配置在同一个端口启动 UDP 和 TCP 服务器，并将请求转发至 Google DoH。

```yaml
log:
  level: info

plugins:
  # 转发至 Google 服务器的插件
  - tag: forward_google
    type: forward
    args:
      upstreams:
        - addr: https://8.8.8.8/dns-query

 # 在同一端口启动 udp 和 tcp 服务器。
  - type: udp_server
    args:
      entry: forward_google
      listen: 127.0.0.1:5533
  - type: tcp_server
    args:
      entry: forward_google
      listen: 127.0.0.1:5533
```

--------------------------------

### string_exp 匹配器示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

示例展示了如何匹配 server_name 等于 a.b.c 或 d.e.f。

```text
string_exp `server_name`eq a.b.c d.e.f
```

--------------------------------

### domain_set 初始化参数配置

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/shu-ju-cha-jian

配置 domain_set 插件，通过 exps 指定域名表达式，通过 files 从文本文件载入域名。域名表达式省略前缀默认为 domain 域匹配。

```yaml
tag: ""
type: "domain_set"
args:
  exps:                         # 域名表达式。
    - "google.com"
    - "regexp:.+\.google\.com$"
  files:                        # 从文本文件载入
    - "./domain.txt"
```

--------------------------------

### mark 高级用法示例：逻辑或、连续执行、if...else

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

该示例展示了如何使用 mark 实现逻辑或（通过打相同标签）、连续执行多个 exec（通过匹配 mark 标签），以及实现 if...else（通过匹配 !mark 标签）。

```yaml
- tag: main
  type: sequence
  args:
  
    # 匹配成功后打标
    # 打相同标签可实现"逻辑或"
    - matches:
      - "match_A"
      exec: mark 123456789
    - matches:
      - "match_B"
      exec: mark 123456789

    # 连续执行
    - matches: mark 123456789
      exec: do_something_1
    - matches: mark 123456789
      exec: do_something_2
    # ...
    # 连续执行 else
    - matches: "!mark 123456789"
      exec: else_do_something_1
    - matches: "!mark 123456789"
      exec: else_do_something_2
```

--------------------------------

### ip_set 初始化参数配置

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/shu-ju-cha-jian

配置 ip_set 插件，通过 ips 指定 IP 或 CIDR，通过 files 从文本文件载入 IP 列表。

```yaml
tag: ""
type: "ip_set"
args:
  ips:             # 可以是 IP 或 CIDR。
    - "1.1.1.1"
    - "1.1.1.1/24"
  files:           # 从文本文件载入
    - "./ip.txt"
```

--------------------------------

### qclass 匹配器参数

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

匹配请求的 QCLASS。参数格式为 qclass [uint16] ...。

```text
qclass [uint16] ...
```

--------------------------------

### sequence 插件初始化参数示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

展示 sequence 插件的基本配置结构，包括 matches 和 exec 字段。matches 条件为 AND 关系，支持 ! 前缀取反。exec 指定操作。

```yaml
tag: ""
type: "sequence"
args:  # []rule
  - matches:                # []string, 匹配条件。多个匹配条件为 AND 关系。
    - qname $ad_domain      # [!]{ 内置匹配名称 | $已定义的匹配器插件tag } [参数]
    - "!qname $ad_domain"   # !前缀代表取反。
    exec: reject 3          # string, { 内置操作名称 | $已定义的可执行插件tag } [参数]
  - exec: $forward_google   # matches 条件可省略。
```

--------------------------------

### hosts 插件初始化参数示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/ke-zhi-xing-cha-jian

配置 hosts 插件的初始化参数，包括 entries 和 files 字段，用于域名映射 IP。

```yaml
tag: ""
type: "hosts"
args:
  entries:                         # []string
    - "google.com 108.177.122.113" # 记录
  files:                           # []string
    - "./hosts.txt"                # 从外部文件载入。
```

--------------------------------

### redirect 插件初始化配置示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/ke-zhi-xing-cha-jian

redirect 插件通过插入 CNAME 记录重定向请求域名。rules 中每行格式为 [域名匹配规则] [重定向至域名]，files 可从文件载入规则。

```yaml
tag: ""
type: "redirect"
args:
  rules:
  # 格式 [域名匹配规则] [重定向至域名] 
    - www.google.com dns.google
  files:  # 从文件载入规则
    - ./rediect.txt
```

--------------------------------

### quic_server 配置示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/fu-wu-qi-cha-jian

quic_server 插件配置（实验性），支持 TLS 和空闲超时设置。

```yaml
tag: ""
type: "quic_server"
args:
  entry: executable_tag  # 可执行插件的 tag。
  listen: 127.0.0.1:853 # 监听地址。
  cert: "./path/to/cert"
  key: "./path/to/key" 
  idle_timeout: 30       # 空连接超时。单位秒。默认 30。
```

--------------------------------

### http_server 配置示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/fu-wu-qi-cha-jian

http_server 插件配置，支持多个路径映射到不同可执行插件，并可配置 TLS 和空闲超时。

```yaml
tag: ""
type: "http_server"
args:
  entries:                 # []extry
    - path: /dns-query     # 本路径执行   
      exec: executable_tag # 可执行插件的 tag。  
  src_ip_header: "X-Forwarded-For"  # 从 HTTP 头获取用户 IP。
  listen: 127.0.0.1:443  # 监听地址。
  cert: "./path/to/cert" # 留空 cert 和 key 后会禁用 TLS。
  key: "./path/to/key" 
  idle_timeout: 10       # 空连接超时。单位秒。默认 30。
```

--------------------------------

### resp_ip 匹配器参数

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

匹配应答 A 和 AAAA 记录的 IP。参数格式为 resp_ip { ip | $ip_set_tag | &ip_list_file } ...。

```text
resp_ip { ip | $ip_set_tag | &ip_list_file } ...
```

--------------------------------

### rate_limiter 使用示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/ke-zhi-xing-cha-jian

在 sequence 中使用 rate_limiter 匹配请求，判断 false (超 qps 请求)，取反，返回 REFUSE。

```yaml
- matches: "!$rate_limit"
  exec: reject 3

```

--------------------------------

### udp_server 配置示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/fu-wu-qi-cha-jian

udp_server 插件的基础配置，指定可执行插件 tag 和监听地址。

```yaml
tag: ""
type: "udp_server"
args:
  entry: executable_tag  # 可执行插件的 tag。
  listen: 127.0.0.1:5353 # 监听地址。
```

--------------------------------

### sequence 插件配置示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

展示 sequence 插件的完整配置示例，包括屏蔽广告域名、跳转到其他 sequence、跳过 cache、设置 TTL 以及使用环境变量实现开关功能。

```yaml
tag: ""
type: "sequence"
args:
  # 屏蔽某些域名，比如广告域名。
  - matches:
      - qname $ad_domain
    exec: reject 3
  - ...
  
  # 将内网请求转交给 handle_local_query sequence 另行处理。
  - matches:
      - qname local internal.my.domain
    exec: goto handle_local_query
  - matches:
      - ptr_ip 10.0.0.0/8
    exec: goto handle_local_query

  # 让某些域名跳过 cache，比如的 DDNS 域名。然后仅
  # 修改 DDNS 域名的 TTL。
  - matches:
      - "!qname my.ddns.domain"
    exec: cache 1024
  - exec: forward 8.8.8.8
  - matches:
      - qname my.ddns.domain
    exec: ttl 1

  # env 实现"开关功能"。
  # 运行 mosdns 时设定 MOSDNS_ENABLE_CACHE 环境变量即可开启 cache 功能。
  - matches:
      - env MOSDNS_ENABLE_CACHE
    exec: cache 1024
  - ...
```

--------------------------------

### rate_limiter 配置示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/ke-zhi-xing-cha-jian

配置 rate_limiter 插件，限制客户端请求速率。qps 默认 20，burst 默认 40，mask4 默认 32，mask6 默认 48。

```yaml
tag: ""
type: "rate_limiter"
args:
  qps: 20    # 客户端的请求 qps 限制。默认 20
  burst: 40  # 突发数。允许客户端瞬间突发请求数。默认 40
  mask4: 32  # IPv4 网段掩码。来自同网段的请求会被视为来自同一客户端。默认 32
  mask6: 48  # IPv6 网段掩码。默认 48

```

--------------------------------

### env 匹配器示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

示例展示了如何检查环境变量是否存在或匹配特定值。

```text
env CACHE_ENABLED
```

```text
env NETWORK_TYPE lan
```

--------------------------------

### reverse_lookup 插件初始化配置示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/ke-zhi-xing-cha-jian

reverse_lookup 插件用 IP 反查域名，缓存 IP 与域名的关系。size 为缓存大小，ttl 为缓存时间，handle_ptr 控制是否主动响应 PTR 请求。

```yaml
tag: ""
type: "reverse_lookup"
args:
  size: 65535 # 内置缓存大小。默认 65535。
  
  # 缓存时间。秒。默认 7200 (2h)。应答记录的 TTL 也会被自动修改，限制在该值以下。
  ttl: 7200
  # 是否主动处理/响应 PTR 请求。如果 PTR 的 IP 命中缓存，则生成应答。
  # 用途举例: 使用网络监视类工具查看网络连接时，开启域名反查功能大概率会看到 IP 对应的
  # 真实域名(如果程序先请求域名再建立连接，而且域名经过了该插件处理。)
  handle_ptr: false 
                    
```

--------------------------------

### tcp_server 配置示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/fu-wu-qi-cha-jian

tcp_server 插件配置，支持 TLS (DoT) 和空闲超时设置。

```yaml
tag: ""
type: "tcp_server"
args:
  entry: executable_tag  # 可执行插件的 tag。
  listen: 127.0.0.1:5353 # 监听地址。
  cert: "./path/to/cert" # 配置 cert 和 key 后会启用 TLS (DoT)。
  key: "./path/to/key" 
  idle_timeout: 10       # 空连接超时。单位秒。默认 10。
```

--------------------------------

### cache 插件初始化参数示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/ke-zhi-xing-cha-jian

配置 cache 插件的初始化参数，包括缓存大小、lazy cache 设置和磁盘持久化选项。

```yaml
tag: ""
type: "cache"
args:
  size: 1024  # 内置内存缓存大小。单位: 条。默认: 1024。每个 cache 插件的内存缓存是独立的。

  # (实验性) lazy cache 设定。lazy_cache_ttl > 0 会启用 lazy cache。
  # 所有应答都会在缓存中存留 lazy_cache_ttl 秒，但自身的 TTL 仍然有效。如果命中过期的应答，
  # 则缓存会立即返回 TTL 为 5 的应答，然后自动在后台发送请求更新数据。
  # 相比强行增加应答自身的 TTL 的方法，lazy cache 能提高命中率，同时还能保持一定的数据新鲜度。
  lazy_cache_ttl: 0        # lazy cache 生存时间。单位: 秒。默认: 0 (禁用 lazy cache)。
                           # 建议值 86400（1天）~ 259200（3天）
  
  # (实验性) 将缓存保存在磁盘。插件启动时也会自动从该文件载入缓存。
  # 缓存将在 mosdns 被关闭时保存。
  dump_file: ./cache.dump
  # (实验性) 自动保存间隔。单位秒。默认 600。
  # 如果距离上次 dump 有 1024 次更新，则自动保存。
  dump_interval: 600
```

--------------------------------

### qclass 匹配器示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

示例展示了如何匹配多个 QCLASS 值。

```text
qclass 1 2 3
```

--------------------------------

### hosts 格式示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/ke-zhi-xing-cha-jian

展示 hosts 插件支持的格式，支持一行多个 IP。

```text
# 支持一行多个 IP
dns.google 8.8.8.8 2001:4860:4860::8888 ...
```

--------------------------------

### nftset parameter format

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

Shows the parameter format for the nftset operation. The format is `nftset [table_family,table_name,set_name,set_dtype,mask]*2`.

```text
nftset [table_family,table_name,set_name,set_dtype,mask]*2
```

--------------------------------

### resp_ip 匹配器示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

示例展示了如何匹配多个 IP/CIDR、ip_set 标签和 ip_list 文件。

```text
resp_ip 192.168.1.1/24 8.8.8.8 $local_ips &./local_ips.txt
```

--------------------------------

### fallback 配置示例

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/ke-zhi-xing-cha-jian

配置 fallback 插件，设置主备可执行插件、无响应回滚阈值和备用插件是否始终待命。

```yaml
tag: ""
type: "fallback"
args:
  primary: executable_tag    # 主可执行插件的 tag
  secondary: executable_tag  # 副可执行插件的 tag
  threshold: 500           # 无响应回滚阈值。单位毫秒。默认 500 。
  always_standby: true     # 副可执行插件始终待命。 

```

--------------------------------

### random 匹配器参数

Source: https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v5/ru-he-pei-zhi-mosdns/sequence-cha-jian

以指定概率返回 true。参数格式为 random prob_float64。

```text
random prob_float64
```
Tokens:
Raw