跳到主要内容

主机

主机是客户端看到的入口点。用户导入订阅链接，应用获取主机列表 并按其中指定的地址连接。主机把配置配置文件的 inbound、节点和连接 参数关联起来。

为什么需要主机​

同一个 inbound 可以由不同主机提供：例如「芬兰」和 「德国」指向不同的节点集合。客户端把主机视为独立的 连接，并在它们之间切换。

  • 没有节点或节点被关闭的主机对用户毫无用处；
  • 主机只下发给那些内部分组中包含该主机 inbound 的用户；
  • 被关闭（isDisabled）的主机不会进入订阅。

绑定 inbound​

在主机表单中首先选择 inbound——一个主机一个 inbound：

{
  "inbound": {
    "configProfileUuid": "00000000-0000-0000-0000-000000000000",
    "configProfileInboundUuid": "11111111-1111-1111-1111-111111111111"
  },
  "nodes": ["22222222-2222-2222-2222-222222222222"]
}

默认端口继承自 inbound，但可以覆盖。如果 inbound 已从配置文件中删除，主机将不再下发——这在主机列表中 可以看到。

地址、端口和 SNI​

字段用途
address客户端连接的 IP 或域名。域名更佳：更换 IP 时只需修正 DNS
port连接端口；默认与 inbound 的端口一致
sni用于 TLS/REALITY 的服务器名称。留空——则取 inbound 中的值
hostHost 请求头的值，或在需要处使用的 serverName
pathWebSocket、gRPC、XHTTP 的路径
securityLayerDEFAULT（与 inbound 相同）、TLS 或 NONE
alpnh3、h2、http/1.1 或它们的组合
fingerprintTLS 客户端指纹：chrome、firefox、safari、randomized 等
overrideSniFromAddress用 address 替换 SNI
keepSniBlank保持 SNI 为空
pinnedPeerCertSha256、verifyPeerCertByName服务器证书校验

xhttpExtraParams、muxParams、sockoptParams 和 finalMask 字段是 传输层的精细设置；只有在明白自己在做什么时才填写它们。

在订阅中的使用​

字段对订阅的影响
remark用户看到的连接名称
isDisabled主机被排除在下发之外
isHidden主机不在订阅的浏览器视图中显示，但仍保留在客户端配置中
shuffleHost随机排列主机顺序
excludeFromSubscriptionTypes将主机从特定格式中排除，例如仅从 MIHOMO 中排除
xrayJsonTemplateUuid为该主机使用单独的 Xray JSON 模板
serverDescription「扩展」客户端的服务器说明
mihomoX25519、mihomoIpVersionMihomo 的参数
internalSquads.mode按分组限制主机：EXCLUDE 或 ALLOW_ONLY
mapper将 inbound 中的值映射到客户端配置
提示

ALLOW_ONLY 至少需要选择一个内部分组——否则表单无法 保存。工作原理请阅读分组一节。

注意

修改 address 或 sni 时，请在客户端中检查结果：部分应用 会缓存订阅，不会立即更新。

接下来​

  • 分组 —— 谁可以访问哪些主机。
  • 模板 —— 主机以什么形式到达客户端。
  • 节点 —— 主机背后的服务器。
  • 客户端 —— 支持的应用。