> For the complete documentation index, see [llms.txt](https://irine-sistiana.gitbook.io/mosdns-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://irine-sistiana.gitbook.io/mosdns-wiki/mosdns-v4.md).

# mosdns v4

版本: v4.5.0

## 功能概述

mosdns 是一个插件化的 DNS 转发器。用户可以按需拼接插件，定制自己的 DNS 处理逻辑。

## 插件概述

以下是 mosdns 以及自带插件的功能:

* 匹配器:
  * `query_matcher`: 匹配请求的特性。域名，类型，来源 IP 等。
  * `response_matcher`: 匹配应答的特性。应答 IP，CNAME 等。
* 常用功能:
  * `forward`: 转发请求至上游服务器。
  * `cache`: 缓存应答。支持 redis 外部缓存。
  * `_prefer_ipv4/6`: 自动判断域名是否是双栈域名然后屏蔽 IPv4/6 请求，不会影响纯 IPv6/4 域名。
  * `ecs`: 在请求上附加 ECS。可以是预设 IP 也可以自动使用客户端的 IP。
  * `hosts`: 为域名设定 IP。
  * `blackhole`: 能丢弃应答，生成空应答，或者生成包含特定 IP 应答。用于屏蔽请求。
  * `ttl`: 修改应答的 TTL。
  * `redirect`: 替换(重定向)请求的域名。请求域名 A，但返回域名 B 的记录。
  * `padding`: 将加密 DNS 的报文填充至固定长度，防止流量分析。
  * `bufsize`: 修改请求的 EDNS0 的 UDP Size。防止 UDP 碎片。
  * `arbitrary`: 面向高级用户。可以手动构建包含任意记录的应答。
  * `reverse_lookup` : 可通过 IP 反查经过 mosdns 处理的域名。支持处理 PTR 请求，支持通过 HTTP 接口查询。
  * `client_limiter`: 限制客户端的最大 QPS。
* 动态路由
  * `ipset`: 将应答 IP 写入 ipset。
  * `nftset`: 将应答 IP 写入 nftables。

插件详细说明在

{% content-ref url="/pages/GQUrh0OKaMvcZ1OXZt9I" %}
[插件及其参数](/mosdns-wiki/mosdns-v4/cha-jian-ji-qi-can-shu.md)
{% endcontent-ref %}

还可以添加自己编写的插件到 mosdns 内。详见

{% content-ref url="/pages/nuEVfWziXnpYZECDeAqA" %}
[如何编写新插件](/mosdns-wiki/mosdns-v4/ru-he-bian-xie-xin-cha-jian.md)
{% endcontent-ref %}

## 如何配置

配置说明和示例，详见:

{% content-ref url="/pages/WBt2J73ng9HzsPmcdRqT" %}
[如何配置 mosdns](/mosdns-wiki/mosdns-v4/ru-he-pei-zhi-mosdns.md)
{% endcontent-ref %}

## 如何使用

mosdns 只有一个二进制文件，命令行运行即可。

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

mosdns 还附带一些常用小工具命令。

* probe 可以探测 TCP/TLS 服务器是否支持连接复用，pipeline 连接复用，空闲连接保持时间。
* config 可以生成 yaml 配置文件模板，转换配置文件格式。
* service 可以将 mosdns 安装成系统服务。

详见各个子命令的帮助。

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

### 安装至系统服务

mosdns service 是一个简单的系统服务管理工具。可将 mosdns 安装成系统服务实现自启。需要管理员或 root 权限。理论上可用于 Windows XP+, Linux/(systemd | Upstart | SysV), 和 OSX/Launchd 平台。Windows，Ubuntu，Debian 实测可用。Openwrt 不可用。

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

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

## 更多工具

开放列表，排名不分前后。欢迎提交 issue 编辑本列表。

### Openwrt

用于 Openwrt 系统的 mosdns。自带 Luci 管理界面。

[sbwml / luci-app-mosdns](https://github.com/sbwml/luci-app-mosdns)

[QiuSimons/openwrt-mos](https://github.com/QiuSimons/openwrt-mos)

### [pmkol/easymosdns](https://github.com/pmkol/easymosdns)

适用于 Linux 的辅助脚本。借助 mosdns，仅需几分钟即可搭建一台支持 ECS 的无污染 DNS 服务器。内置中国大陆地区的优化规则，满足DNS日常使用场景，开箱即用。

### [mosdns-cn](https://github.com/IrineSistiana/mosdns-cn)

简单易用加密 DNS 转发器。内置域名 & IP 分流策略，只需用户提供上游服务器地址和分流用的域名 IP 表，即可实现的本地/远程域名分流。

### [cfdohpw](https://github.com/IrineSistiana/cfdohpw)

一个 Cloudflare Workers 脚本。借助 Cloudflare CDN 平台中转加速任意 DoH (RFC8484) 流量。只需一个 Cloudflare 账号，无需自备服务器和域名。