来源: https://github.com/MetaCubeX/mihomo/pull/3280
概述
新增仅支持 TCP 的 x365 出站,并在订阅转换中支持 x365:// 分享链接。
没有加入供应商自己的登录和订阅获取,用户自己或下游项目提取订阅之后形成配置文件使用,保持本项目内核的纯粹。
协议来源
- 协议的开源参考实现:SakurakaiCat/x365(MIT),协议核心在 x365-core。本 PR 的线上格式与其保持一致。
- X365 是部分代理服务商官方客户端使用的私有协议。
x365://链接是服务商下发给官方客户端的节点格式,并非本 PR 自定义。目前已知的使用方:- 饿饭云(efanccyun):本 PR 已在其节点上实测通过(见下方「测试」)。
- 365VPN加速器:未经测试验证。
- 老猫云:未经测试验证。
协议结构
X365 的传输层与 mihomo 现有的 VLESS 完全相同:REALITY + xhttp stream-one(默认 h2,设置 alpn: [http/1.1] 时走 HTTP/1.1)。区别只在协议头:
- 请求头:
"X365"| 版本0x01| 命令0x01(TCP) | UUID(16 字节) | 端口(2 字节,大端) | 地址类型(1IPv4 /2域名 /3IPv6) | 地址 - 响应头:
"X365"| 状态(0x00表示成功)
实现
transport/x365:协议头编解码。请求头随首包一起发送,响应头在首次读取时校验,写法与transport/vless一致。adapter/outbound/x365.go:内部包装Vless以复用其传输栈(REALITY、xhttp 及其 reuse-settings、dialer-proxy 等),只替换协议层。协议没有 UDP,因此udp始终关闭,也不提供 UoT。common/convert:支持x365://链接转换。adapter/parser.go、constant/adapters.go、docs/config.yaml:注册新类型并补充配置示例。
需要注意的服务端行为
- User-Agent 精确匹配:服务端只接受官方客户端那一个 Chrome 120 的 UA 字符串,其他值一律返回
403,包括其他 Chrome 版本、同版本换平台、完整版本号,以及 xhttp 的chrome伪装。因此出站默认发送这个 UA,用户仍可通过xhttp-opts.headers.User-Agent覆盖。 - 只支持 xhttp
stream-one(每条隧道是一个双向请求):实测stream-up被服务端 GOAWAY,packet-up返回405。因此mode为空或auto时归一为stream-one,其他取值在加载配置时直接报错,也就不能使用download-settings。 - mihomo 默认的 REALITY 客户端版本号可以被服务端接受,REALITY 部分无需改动。
- 目标端关闭连接后,服务端不会结束响应流,参考实现也是如此。客户端一侧关闭时,隧道会正常释放。
配置示例
- name: "x365"
type: x365
server: server
port: 443
uuid: uuid
servername: xxx.com # REALITY servername
client-fingerprint: chrome
reality-opts:
public-key: xxx
short-id: xxx
xhttp-opts: # 字段同 vless 的 xhttp-opts,但 mode 只支持 stream-one(默认)
path: "/"
host: xxx.com
分享链接
x365://<uuid>@<server>:<port>?path=..&host=..&sni=..&pbk=..&sid=..#<名称>
path/host/sni/pbk/sid是服务商实际下发的参数。type/network(h1/http映射为alpn: [http/1.1])、token(映射为Authorization: Bearer请求头)和fp按参考实现的ParseURI处理。sni缺省时取host;fp缺省为chrome,chrome120也映射为chrome。- 不认识的传输类型会跳过该行并打印警告。警告只包含传输类型和 server:port,不打印链接本身,避免把 uuid / token 写进日志。
- 每行一条(或 base64 编码)的链接列表可以直接作为
file/http类型的 proxy-provider 使用。
测试
- 单元测试覆盖:
- 请求头编码(IPv4 / 域名 / IPv6)
- 响应处理(正常 / magic 错误 / 非零状态)
- 出站默认值与限制(默认 UA 及覆盖、mode 归一与拒绝、UDP 关闭)
- 首次
WriteBuffer正确释放传入的 buffer x365://转换(转换结果再经adapter.ParseProxy校验)
- 在饿饭云上实测通过。使用饿饭云账号官方下发的 X365 节点,在独立的 mihomo 实例中:
- 香港、日本、美国、台湾、新加坡 5 个地区的节点经 h2 全部连通,出口 IP 与节点地区一致
- HTTP/1.1 传输同样连通
- HTTPS 访问正常,50 MB 下载约 200–355 Mbps,20 MB 上传正常
- 以
x365://链接列表作为fileproxy-provider 加载并连通