fake-ip-filter-mode:blacklist、whitelist 与 rule 的区别
同一份 fake-ip-filter 列表,在不同模式下意思相反。默认的 blacklist 表示列表里的域名不分配虚拟地址,whitelist 则只给列表里的分配。
01先复习 fake-ip
fake-ip 模式下,内核对域名查询先回一个虚拟地址,真正的解析留到建立连接时再处理。字段 fake-ip-range 决定虚拟地址的范围,文档示例是 198.18.0.1/16。这个机制的整体介绍见 Clash DNS fake-ip 字段。
有些域名不适合拿到虚拟地址,比如局域网服务依赖真实 IP。fake-ip-filter 就是用来挑出这些域名的,而 fake-ip-filter-mode 决定这份列表怎么被使用。
02三种取值
文档给出三个取值,默认是 blacklist:
| 取值 | 含义 |
|---|---|
| blacklist | 列表里的域名不返回 fake-ip,其余都返回 |
| whitelist | 只有匹配成功的域名才返回 fake-ip |
| rule | fake-ip-filter 按路由规则语法书写,自上而下判断 |
whitelist 的文档原意是“只有匹配成功才返回 fake-ip”,与 blacklist 刚好相反。同一个 '*.lan' 条目,在 blacklist 里表示局域网域名不用虚拟地址,在 whitelist 里表示只有局域网域名用虚拟地址,这几乎一定不是你想要的。所以改模式时要同步检查列表。
03blacklist:默认的用法
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter-mode: blacklist
fake-ip-filter:
- '*.lan'
文档说明 fake-ip-filter 里的条目支持域名通配符,也可以导入域名集。列出的地址不会得到虚拟地址的映射。没有特殊需求时保持 blacklist 就是默认行为。文档没有写 fake-ip-filter 的默认内容。
04whitelist:只给列表里的分配
选 whitelist,意味着大部分域名拿到的是真实解析结果,只有你列出来的才走 fake-ip。这样可以把虚拟地址的影响范围控制得很小,代价是列表要自己维护,漏掉的域名不会享受 fake-ip 的行为。
05rule:用规则语法写
rule 模式下,fake-ip-filter 里写的是路由规则,从上往下判断。文档说明支持的类型包括 RULE-SET、GEOSITE、DOMAIN 一类以及 MATCH。条目形式类似:
fake-ip-filter-mode: rule
fake-ip-filter:
- RULE-SET,reject-domain,fake-ip
示例中 reject-domain 是一个规则集的名字,需要你自己在配置里定义。这种写法的好处是可以复用分流里已有的规则集,也方便用 MATCH 做兜底。顺序影响结果,所以排列时要像写分流规则一样考虑先后,规则顺序的思路见 Clash 分流规则入门。
06什么时候改这个模式
文档没有给出“什么情况必须改”。从用途出发,可以这样判断:
1. 默认的 blacklist 能解决问题,就不要动,只往列表里加例外。
2. 想让虚拟地址只作用于少数域名,再考虑 whitelist。
3. 想复用现有规则集来决定哪些域名排除,再考虑 rule。
改动后观察解析异常是否出现、局域网服务是否仍可访问。解析异常的整体排查可以看 DNS 泄露是什么意思。
07是哪些客户端和版本在用
fake-ip-filter-mode 是 mihomo 内核的 DNS 字段,使用该内核的客户端都能通过配置写入。各客户端是否提供图形界面开关、从哪一版开始,没有查到统一的官方说明,需要看客户端自己的发布页。
常见问题
blacklist 和 whitelist 到底差在哪?
+
blacklist 是默认值,列表里的域名不返回 fake-ip;whitelist 相反,只有匹配列表的域名才返回 fake-ip。同一个条目在两种模式下含义相反,换模式必须重新检查列表。
rule 模式的条目能写哪些类型?
+
文档说明支持 RULE-SET、GEOSITE、DOMAIN 一类以及 MATCH,自上而下判断。条目形式与分流规则相似,所以顺序会影响结果。
fake-ip-filter 可以用通配符吗?
+
可以。文档说明它支持域名通配符,也支持导入域名集,示例里的 '*.lan' 就是通配写法。列出的地址在 blacklist 模式下不会得到虚拟地址的映射。
还没确定从哪一步开始,可把 从安装开始的操作教程 与 设备对应的软件档案 配合阅读。已有配置但访问失败时,转到 连接异常的分类检查 找对应表现。
站内速查 · 长尾导航
按平台选客户端
内核与进阶