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,再看是否有更具体的条目抢先命中,之后检查域名拼写和配置是否已重新加载。
还没确定从哪一步开始,可把 从安装开始的操作教程 与 设备对应的软件档案 配合阅读。已有配置但访问失败时,转到 连接异常的分类检查 找对应表现。
站内速查 · 长尾导航
按平台选客户端
内核与进阶