适用范围与准备

适用于原 V2Ray WebSocket 节点可用,迁移到 Mihomo 后路径和 Host 已核对,却仍无法建立预期连接的情况。先保留原配置,检查旧配置是否启用了 WebSocket 前置数据;本篇只处理这一项兼容性,不把它当作所有 WebSocket 故障的原因。

先区分原因

V2Fly 的 wsSettings 可通过 maxEarlyData 与 earlyDataHeaderName 控制前置数据。Mihomo 的相应选项位于 ws-opts,使用连字符拼写。迁移只保留 path 与 headers,可能遗漏原连接所依赖的选项;但看到两端有相似字段,也不能据此保证所有版本和中间转发规则都兼容。

按顺序操作

  1. 确认旧配置实际使用 WebSocket,并定位 wsSettings。记录 maxEarlyData 是否配置、earlyDataHeaderName 是否为空,以及是否启用了 useBrowserForwarding;记录字段和值即可,不公开 UUID 或整份订阅。
  2. 对照目标节点的 ws-opts,检查 max-early-data 与 early-data-header-name 是否被转换器遗漏或错误拼写。把原值与目标值放在同一张本地清单里,不将文档示例中的数值当成需要统一采用的性能参数。
  3. 区分前置数据放在哪里。V2Fly 文档说明,未指定头名称时可附在路径后;指定 earlyDataHeaderName 时放入相应 HTTP 头。服务端反向代理若依赖路径前缀匹配,这种差异也需要维护者核对,不只比较基础 path 字符串。
  4. 若旧配置启用了 useBrowserForwarding,单独记录这个条件。V2Fly 对浏览器转发与前置数据组合有明确限制;不能把该开关直接改名塞入 Mihomo,也不能用普通节点字段映射宣称已复制浏览器转发行为。
  5. 只在独立副本中恢复由服务方确认的字段组合,保持其他参数不变并发起少量新连接。需要调整反向代理时由其维护者操作;无法获得服务端配合,就保留未验证结论,不在唯一可用节点上轮流试数。
V2Fly WebSocket 项Mihomo 核对位置处理边界
wsSettings.maxEarlyDataws-opts.max-early-data核对原值,不照抄示例阈值
wsSettings.earlyDataHeaderNamews-opts.early-data-header-name检查是否遗漏及放置方式
wsSettings.useBrowserForwarding单独核对实现能力不假定存在同名可替换字段

怎样确认有效

要同时看到目标内核接受配置、WebSocket 建连通过,以及新请求取得预期内容。端口可连、导入后有节点名或握手出现响应,只说明其中一层;旧配置与新副本应在同一获准网络和目标下比较,才便于归因。

无效时恢复与下一步

未改善就恢复旧客户端和原配置,保留版本、字段差异及脱敏错误,交给服务方核对兼容性。V2Fly 文档也提示跨实现客户端可能无法连接;本篇未运行前置数据或浏览器转发实验,不承诺开启它就能提速。