基于规则的 DNS 代理，按域名将请求路由到不同的上游解析器。支持 UDP DNS、DoH、DoT，内置缓存和热重载。
- Resolver 链：按顺序匹配，第一个命中的 resolver 处理请求
- 域名规则：后缀匹配、精确匹配、关键字、正则表达式，支持黑名单
- 多种上游协议：UDP、DNS-over-HTTPS (DoH)、DNS-over-TLS (DoT)、DNSCrypt
- v2fly 域名列表：原生集成 v2fly/domain-list-community，自动下载缓存
- 本地解析：hosts 文件、dnsmasq 租约文件
- 全局缓存：按 resolver 或全局 TTL 缓存响应
- nftset 策略路由：resolver 解析出的 A 记录可自动写入 nftables 集合（带 timeout），供路由器按域名做策略路由（本期仅 IPv4）
- mDNS 桥接：把 DNS-only 客户端（容器 / VM / 无 avahi 的 Linux）的
.local主机名查询桥接到 LAN mDNS，回设备自宣告的活答案（querier-only，不宣告不应答；详见 USAGE 与docs/adr/0001） - 热重载：修改配置文件后自动重载，无需重启
- HTTP API：可选的 HTTP 查询接口
- Web Portal：内置 Web 管理页面——浏览器查询 DNS 解析结果，并可结构化表单在线编辑 resolvers（校验 + 备份 + 热替换，详见下文）
go build -o dns-switchy
./dns-switchy -c config.yaml命令行参数：
| 参数 | 默认值 | 说明 |
|---|---|---|
-c |
config.yaml |
配置文件路径 |
-x |
false |
日志中显示时间戳 |
程序启动后在配置的 UDP 端口监听 DNS 请求。修改配置文件会自动触发热重载。
设置 http 后，浏览器访问 http://<host>:<port>/ 即可使用内置管理页面，含两块功能：
- Lookup：输入域名 + 类型，查看由哪个 resolver 解析及结果（不走缓存）。
- Config：以结构化表单在线编辑 resolvers——增删 / 调序 resolver（顺序即匹配优先级）、按 type 编辑字段、逐条编辑规则（
v2fly:/include:/!黑名单/keyword:/regexp:原样保留）。保存前校验、自动备份旧配置、原子写盘并热替换 resolver 链；保存失败不写盘，运行中的 DNS 解析全程不中断。
作用域与安全：
- Web 仅能改
resolvers；顶层addr/http/nftset_table/ttl为只读（如需修改请直接编辑配置文件）。 - 保存会重写配置文件，保留
v2fly:/include:等指令与未知字段，但不保证保留 YAML 注释 / 原始格式；旧配置存为带时间戳的.bak备份。 - 接口无鉴权，写操作可改上游 DNS。请仅在可信内网使用，切勿暴露到公网（已内置同源 / CSRF、请求方法、请求体大小等基础防护）。
HTTP 接口（http 开启时）：
| 方法 & 路径 | 说明 |
|---|---|
GET /api/query?question=<域名>&type=<类型> |
DNS 查询（不走缓存） |
GET /api/config |
读取当前配置（JSON）+ 内容版本号 |
POST /api/config/validate |
校验一组 resolvers（解析 + 构造 + 严格检查），不写盘 |
POST /api/config |
保存 resolvers（需带版本号做乐观并发 + 备份 + 热替换） |
OpenWrt：包内 init.d 让守护进程直接以 /etc/dns-switchy/config.yaml（持久分区）为唯一配置，因此 web 编辑持久保存、重启不丢；监听端口仍由 UCI http_port（LuCI 可改）掌控，启动 / UCI 变更时会幂等同步进该文件。LuCI 页面以 iframe 内嵌此 portal，同源访问不受 CSRF 限制。
addr: ":1053"
ttl: 5m
http: ":8080" # 可选，HTTP API + Web Portal
nftset_table: "inet fw4" # 可选，nftset 写入的目标表/族，默认 inet fw4
resolvers:
- type: forward
name: corp-dns
ttl: 600s
url: 114.114.114.114
rule:
- corp.example
nftset: corp4 # 可选，把该 resolver 的 A 答案写进 corp4 集合
nftset_ttl: 1h # 集合元素 timeout，须 ≥ 该 resolver 缓存 TTL
- type: forward
name: cf-dns
url: https://cloudflare-dns.com/dns-query完整的配置参考和所有 resolver 类型详见 USAGE.md。