新协议 x365

来源: 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 字节,大端) | 地址类型(1 IPv4 / 2 域名 / 3 IPv6) | 地址
  • 响应头:"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:// 链接列表作为 file proxy-provider 加载并连通