跳到主内容

hosts 自定义映射:域名对到哪个地址,由你自己指定

不想走外部解析的域名,可以在配置里直接写死。几种写法各有限制,先看清再用。

01hosts 是什么

hosts 段落让域名按配置里写好的对应关系解析,不再去问外部的 DNS 服务器。mihomo 文档给出的示例包含四种写法:

hosts:
  '*.clash.dev': 127.0.0.1
  'alpha.clash.dev': '::1'
  test.com: [1.1.1.1, 2.2.2.2]
  baidu.com: google.com

四行分别对应:通配符映射到 IPv4、单个域名映射到 IPv6、一个域名对应多个 IP、一个域名重定向到另一个域名。示例中的地址和域名属于文档示例,自己写时按需要替换。

02键与值怎么写

键是域名,支持通配符,例如 '*.clash.dev'。含星号的键要加引号,避免被当成别的语法。值可以是字符串,也可以是数组:

- 字符串:一个 IP 或一个域名。
- 数组:多个 IP,如 test.com 的示例。

IPv6 地址同样加引号,如 '::1'。

03域名重定向的限制

当值是另一个域名时,等于把当前域名的解析交给它。文档特别说明:域名重定向不支持数组。想为一个域名写多个目标,只能用多个 IP 的形式,不能写成多个域名。

04谁优先

同一个域名可能同时被通配符和精确条目命中。文档给出的优先级是 foo.example.com 高于 *.example.com,再高于 .example.com。也就是写得越具体越优先。需要对子域做例外时,直接写一条完整域名即可。

05use-hosts 与 use-system-hosts

dns 段落里有两个相关开关。use-hosts 控制是否使用上面配置的 hosts 条目,文档说明默认是 true。use-system-hosts 控制是否查询系统的 hosts 文件,页面示例也写作 true。

如果写了映射却不生效,先确认 use-hosts 没有被关掉,再看是否有更具体的条目抢先命中。文档的 hosts 页面没有讨论 +. 这类写法,需要时以通用配置章节中的域名通配规则为准。

06与 fake-ip 及软件接管的关系

hosts 和 fake-ip 同时使用时,域名映射的结果要和虚拟地址机制一起考虑。fake-ip 的基本概念见fake-ip 与域名例外。映射的目的若是让局域网设备按固定地址访问,还需要核对软件没有走代理时的接管方式。

07修改后怎么验证

保存配置后重新加载,再用系统自带的解析工具查询相关域名,对比返回值是否与 hosts 一致。若返回不一致,排查顺序是:配置是否已加载、域名拼写、通配符层级、use-hosts 开关。

常见问题

hosts 里可以用通配符吗?

+

可以。文档示例使用了 '*.clash.dev'。含星号的键要加引号,具体匹配遵循配置手册中的域名通配规则。

一个域名能同时映射多个域名吗?

+

不能。文档写明域名重定向不支持数组。只有映射到 IP 时才可以用数组,比如 test.com 对应两个 IP。

写了 hosts 却没生效,先查什么?

+

先看 use-hosts 是否为 true,再看是否有更具体的条目抢先命中,之后检查域名拼写和配置是否已重新加载。

还没确定从哪一步开始,可把 从安装开始的操作教程 与 设备对应的软件档案 配合阅读。已有配置但访问失败时,转到 连接异常的分类检查 找对应表现。