修改 Xray-core 的 tcpFastOpen 后建连异常,先检查当前值属于启用、强制关闭还是使用系统默认,再确认运行平台与作用位置。TCP Fast Open 是底层建连选项,不能修复节点凭据、WebSocket 路径或 TLS 证书错误,也不能仅凭开关状态宣称连接更快。
三类取值含义不同
Project X 官方文档将 tcpFastOpen 定义为布尔值或数值:true、正整数表示启用;false、负数表示强制关闭;字段缺失或 0 表示使用系统默认。把 false 改成删掉字段,结果未必相同。
该选项可以用于 inbound 和 outbound。对出站,true 或正整数都只表示启用;对入站,正整数在支持的系统上还可能表示待处理 TFO 请求数量上限。不能把一个出站数字当作测速次数或并发上限。
先用明确的布尔值对照
下面仅是目标出站的传输设置片段,应合并到现有 outbound,保留原协议、节点和 TLS 参数:
{
"streamSettings": {
"sockopt": {"tcpFastOpen": false}
}
}
false 用于建立关闭 TFO 的对照组,不是永久推荐。运行 xray run -test -config config-test.json,确认配置副本可解析,再按原方式加载。只有确定字段属于实际使用的出站,比较结果才有意义。
系统边界也要核对
官方对 Linux 要求相应内核支持,并说明 net.ipv4.tcp_fastopen 是位图:客户端允许位与服务器允许位不同。可先用 sysctl net.ipv4.tcp_fastopen 只读查看值;不要为客户端故障直接把服务器位和系统参数全部改开。
文档对 Windows、macOS/iOS、FreeBSD 列有实现或待测试备注,所以字段被解析不等于运行平台可靠支持。本教程没有在这些系统逐项实测,不能把 Linux 的步骤当作所有平台的承诺。
使用相同目标建立新连接
- 保留原值、操作系统信息和一次失败日志,确认错误出现在 TCP 建连而非认证阶段。
- 只将目标出站设为 false,重载后建立新连接,记录是否仍出现同一错误。
- 需要继续比较时,再单独使用 true 或系统默认状态;不要同时改 MTU、拥塞算法和传输协议。
- 无改善时恢复原配置,按 Xray 日志 分离 TCP、TLS 和协议错误。
配置检查与新连接成功,只能说明这个测试条件可用,不代表 TFO 带来性能提升。传输对象的位置可结合 VLESS 出站配置 核对。
官方来源
来源核验日期:2026-11-05。