/mos-chinadns

ChinaDNS改进版。3分钟配置。按域名与IP分流,支持DoH,IPv6,EDNS Client Subnet(ECS),高性能。

Primary LanguageGoGNU General Public License v3.0GPL-3.0

mos-chinadns

支持DoH,IPv6,EDNS Client Subnet,根据域名和IP的分流。内置APNIC**大陆IP表和dnsmasq-china-list域名表。


命令帮助

-c string   [路径]json配置文件路径
-dir string [路径]变更程序的工作目录
-dir2exe    变更程序的工作目录至可执行文件的目录

-gen string [路径]生成一个json配置文件模板至该路径
-v          调试模式,更多的log输出
-q          安静模式,无log
-no-tcp     不监听tcp,只监听udp
-no-udp     不监听udp,只监听tcp

配置文件说明

{
    // [IP:端口][必需] 监听地址
    "bind_addr": "127.0.0.1:53", 

    // [IP:端口] `local_server`地址 建议:一个低延时但会被污染大陆服务器,用于解析大陆域名。
    "local_server": "223.5.5.5:53",     

    // [bool] `local_server`是否屏蔽非A或AAAA请求。
    "local_server_block_unusual_type": false,

    // [IP:端口] `remote_server`地址 建议:一个无污染的服务器。用于解析非大陆域名。   
    "remote_server": "8.8.8.8:443", 

    // [URL] 远程DoH服务器的url,如果填入,`remote_server`将使用DoH协议
    "remote_server_url": "https://dns.google/dns-query",  

    // [bool] 是否跳过验证DoH服务器身份 高危选项,会破坏DoH的安全性
    "remote_server_skip_verify": false, 

    // [int] 单位毫秒 `remote_server`延时启动时间
    // 如果在设定时间(单位毫秒)后local_server无响应或失败,则开始请求remote_server。
    // 如果local_server延时较低,将该值设定为120%的local_server的延时可显著降低请求remote_server的次数。
    // 0表示禁用延时,请求将同时发送。
    "remote_server_delay_start": 0, 

    // [路径] `local_server`IP白名单 建议:**大陆IP列表,用于区别大陆与非大陆结果。
    "local_allowed_ip_list": "/path/to/your/chn/ip/list", 

    // [路径] `local_server`IP黑名单 建议:希望被屏蔽的IP列表,比如运营商的广告服务器IP。
    "local_blocked_ip_list": "/path/to/your/black/ip/list",
    
    // [路径] 强制使用`local_server`解析的域名名单 建议:**的域名。
    "local_forced_domain_list": "/path/to/your/domain/list",

    // [路径] `local_server`域名黑名单 建议:希望强制打开国外版而非**版的域名。
    "local_blocked_domain_list": "/path/to/your/domain/list",

    // [CIDR] EDNS Client Subnet 
    "remote_ecs_subnet": "1.2.3.0/24"
}

三分钟快速上手 & 预设配置

在这里下载最新版本:release

APNIC**大陆IP表chn.listdnsmasq-china-list域名表chn_domain.list已包含在release的zip包中。

将预设配置复制并保存至config.json,确保chn.listchn_domain.listconfig.jsonmos-chinadns在同一目录。

用以下命令启动

mos-chinadns -c config.json -dir2exe
预设配置1 通用 按大陆IP与域名分流 `remote_server`使用DoH

使用**大陆IP表chn.list和域名表chn_domain.list分流。国内域名使用阿里云DNS解析,国际域名使用Google DoH解析。

{
    "bind_addr": "127.0.0.1:53",
    "local_server": "223.5.5.5:53",
    "remote_server": "8.8.8.8:443",
    "remote_server_url": "https://dns.google/dns-query",
    "local_allowed_ip_list": "./chn.list",
    "local_forced_domain_list": "./chn_domain.list"
}
预设配置2 通用 按大陆IP与域名分流

使用**大陆IP表chn.list和域名表chn_domain.list分流。国内域名使用阿里云DNS解析,国际域名使用OpenDNS解析。

{
    "bind_addr": "127.0.0.1:53",
    "local_server": "223.5.5.5:53",
    "remote_server": "208.67.222.222:443",
    "local_allowed_ip_list": "./chn.list",
    "local_forced_domain_list": "./chn_domain.list"
}
预设配置3 DoH转发模式

使用Google DoH作为上游服务器。无分流。建议启用ECS使解析更精确。如何启用?

{
    "bind_addr": "127.0.0.1:53",
    "remote_server": "8.8.8.8:443",
    "remote_server_url": "https://dns.google/dns-query",
}

如果你正在找一个最简单的DoH转发器,建议使用mos-doh-client。无需配置,命令行启动。

更新**大陆IP与域名列表

如果你想自己更新**大陆IP与域名列表。release_chn_ip_domain_updater.py能自动下载数据并生成chn.listchn_domain.list到当前目录。

分流效果

国内域名交由local_server解析,无格外延时。国外域名将会由remote_server解析,确保无污染。

dig www.baidu.com 演示
ubuntu@ubuntu:~$ dig www.baidu.com @192.168.1.1 -p5455

; <<>> DiG 9.11.3-1ubuntu1.11-Ubuntu <<>> www.baidu.com @192.168.1.1 -p5455
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 57335
;; flags: qr rd ra; QUERY: 1, ANSWER: 3, AUTHORITY: 0, ADDITIONAL: 1

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 4096
;; QUESTION SECTION:
;www.baidu.com.			IN	A

;; ANSWER SECTION:
www.baidu.com.		561	IN	CNAME	www.a.shifen.com.
www.a.shifen.com.	250	IN	A	36.152.44.96
www.a.shifen.com.	250	IN	A	36.152.44.95

;; Query time: 4 msec
;; SERVER: 192.168.1.1#5455(192.168.1.1)
;; WHEN: Sun Mar 15 18:17:55 PDT 2020
;; MSG SIZE  rcvd: 149
dig www.google.com 演示
ubuntu@ubuntu:~$ dig www.google.com @192.168.1.1 -p5455

; <<>> DiG 9.11.3-1ubuntu1.11-Ubuntu <<>> www.google.com @192.168.1.1 -p5455
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 2719
;; flags: qr rd ra; QUERY: 1, ANSWER: 6, AUTHORITY: 0, ADDITIONAL: 1

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 512
;; QUESTION SECTION:
;www.google.com.			IN	A

;; ANSWER SECTION:
www.google.com.		280	IN	A	74.125.68.99
www.google.com.		280	IN	A	74.125.68.105
www.google.com.		280	IN	A	74.125.68.104
www.google.com.		280	IN	A	74.125.68.103
www.google.com.		280	IN	A	74.125.68.106
www.google.com.		280	IN	A	74.125.68.147

;; Query time: 72 msec
;; SERVER: 192.168.1.1#5455(192.168.1.1)
;; WHEN: Sun Mar 15 18:19:20 PDT 2020
;; MSG SIZE  rcvd: 223

其他细节

如何使用EDNS Client Subnet (ECS)

remote_ecs_subnet 填入自己的IP段即可启用ECS。如不详请务必留空。

启用ECS最简单的方法:

  • 百度搜索IP,得到自己的IP地址,如1.2.3.4
  • 将最后一位变0,并加上/24。如1.2.3.41.2.3.0/24
  • 1.2.3.0/24填入remote_ecs_subnet

如何使用DNS-over-HTTPS (DoH)

填入同时填入remote_serverremote_server_url``remote_server将会使用DoH模式。请求方式为RFC 8484 GET。

关于文件路径

建议使用-dir2exe选项将工作目录设置为程序所在目录,这样的话配置文件-c路径和配置文件中的路径可以是相对于程序的相对路径。

如果附加-dir2exe后程序启动报错那就只能启动程序前手动cd或者使用绝对路径。

local_server黑白名单处理流程

  1. 如果指定了域名白名单->匹配域名->白名单中的域名将被local_server解析
  2. 如果指定了域名黑名单->匹配域名->黑名单中的域名将被remote_server解析
  3. 如果指定了IP黑名单->匹配local_server返回的IP->丢弃黑名单中的结果。
  4. 如果指定了IP白名单->匹配local_server返回的IP->丢弃不在白名单的结果。
  5. 接受结果

remote_server的结果一定会被接受

域名黑/白名单格式

采用按域向前匹配的方式,与dnsmasq匹配方式类似。每个表达式一行。

规则示例:

  • cn相当于*.cn。会匹配所有以cn结尾的域名,example.cnwww.google.cn
  • google.com相当于*.google.com。会匹配www.google.com, www.l.google.com,但不会匹配www.google.cn

比如:

cn
google.com
google.com.hk
www.google.com.sg

IP黑/白名单格式

由单个IP或CIDR构成,每个表达式一行,支持IPv6,比如:

1.0.1.0/24
2001:dd8:1a::/48

2.2.2.2
2001:ccd:1a

Open Source Components / Libraries

部分设计参考

依赖