v2rayN Xray 26.10.21 无法启动:Windows 目录联接路径排查
简答:如果 v2rayN 更新 Xray 26.10.21 后出现“运行 Core 失败”以及“The system cannot find the path specified”,先检查程序是否从 Scoop 的 current 或其他 Windows 目录联接路径启动。确认后优先从实体版本目录启动,或启用 V2RAYN_LOCAL_APPLICATION_DATA_V2=1;暂时不能调整路径时,再把 Xray 核心回退到可用的旧版本。
定义:这里的“Xray 26.10.21 无法启动”特指 Windows 下工作目录包含目录联接或符号链接时,Xray 读取相对路径 config.json 失败,并非所有 v2rayN、节点或配置错误。
先看报错:符合这组特征才按本文处理
本文编译整理自 2026 年 10 月 23 日公开的 v2rayN 与 Xray-core issue。核对日期为 2026 年 10 月 25 日。本站是第三方使用指南站,不是 v2rayN 或 Xray-core 官方站。
如果日志同时出现下面几项,优先检查路径,而不是立即删除订阅或重建节点:
Xray 26.10.21。Failed to start: main: failed to load config files: [config.json]。The system cannot find the path specified.。运行 Core 失败,请查看提示信息。- 节点延迟测试显示
-1 ms,核心没有真正启动。
v2rayN issue #10446 记录了这一组现象,并指出程序安装在 Scoop 的 current 目录联接下时,Xray 26.10.21 无法启动;Xray-core issue #7239 也记录了同样的 Windows 目录联接复现结果。可查看 v2rayN issue #10446 与 Xray-core issue #7239。
| 现象 | 更可能的层级 | 先做什么 |
|---|---|---|
| v2rayN 主窗口无法打开 | 主程序、权限或安装文件 | 先确认 exe 是否能运行,不要先改节点 |
| 主程序能开,但出现 Core 失败与找不到路径 | Xray 核心启动或工作目录 | 检查 current、junction、symlink |
| 核心能启动,但某节点失败 | 配置、协议或网络链路 | 单独测试其他节点与配置 |
| 只有 TUN、xhttp h3 或 hysteria 失败 | 另一类传输或 TUN 问题 | 不要套用本文的目录联接结论 |
第一步:确认 v2rayN 是否从 current 或目录联接启动
在文件资源管理器中打开 v2rayN 的安装目录,查看路径中是否有 current,或使用了由 Windows mklink /J 创建的目录联接。issue #10446 给出的示例路径为 C:\Users\<user>\scoop\apps\v2rayn\current\,该目录指向某个带版本号的实体文件夹。
- 完全退出 v2rayN,包括托盘区图标。
- 在任务管理器中确认没有残留的 v2rayN 或 Xray 进程。
- 打开安装目录,记录
current上一级目录和带版本号的实体目录。 - 在实体版本目录中找到
v2rayN.exe,直接双击启动,而不是从current路径启动。 - 回到 v2rayN,选择原来的配置,启动服务并查看日志。
issue 中的复现结果显示:从 junction 路径运行会报找不到路径,而从实体目录运行可以启动。因此,这一步是最少改动的优先方案。具体文件夹名称以你电脑上的安装目录为准,不要照抄用户名或版本目录。
第二步:启用 LocalAppData 模式,避开安装目录联接
如果你仍需要通过 current 路径打开 v2rayN,可以尝试使用 issue 中列出的环境变量 V2RAYN_LOCAL_APPLICATION_DATA_V2=1。该模式会把 bin 与 binConfigs 移到 Windows 用户的 %LOCALAPPDATA%\v2rayN,从而避开工作目录中的目录联接。
- 退出 v2rayN,并先备份现有配置目录。
- 打开 Windows 的“环境变量”设置。
- 新建用户变量,变量名填写
V2RAYN_LOCAL_APPLICATION_DATA_V2,变量值填写1。 - 重新启动 v2rayN,再启动 Xray 核心。
- 确认日志不再出现
The system cannot find the path specified.,然后再测试节点。
如果设置环境变量后行为没有变化,先彻底退出并重新打开 v2rayN;仍无效时,回到实体版本目录方案。不要因为启用该变量就删除原配置,先保留备份,避免把路径问题误处理成数据丢失。
第三步:暂时回退 Xray 核心,并完成版本核验
v2rayN issue #10446 记录的环境中,Xray 26.10.21 无法工作,而 Xray 26.10.10 可以工作;Xray-core issue #7239 还记录了 Xray 26.9.30 在该复现路径下可以工作。这里的结论只适用于本文所述的 Windows 目录联接回归,不能推断所有旧版本都适合你的配置。
- 在 v2rayN 的核心管理或内核更新入口查看当前 Xray 版本,字段名称以你安装的 v2rayN 界面为准。
- 记录当前配置和日志,确认问题确实发生在 Xray 26.10.21。
- 选择一个已知可用的旧核心版本,例如 issue 中记录可工作的 26.10.10;若界面没有该版本,不要手动下载来源不明的文件。
- 完成核心切换后重启 v2rayN,再查看启动日志中的 Xray 版本行。
- 先用普通节点测试核心能否启动,再测试 TUN 或特殊传输。
回退只是临时处理。Xray-core issue #7239 页面说明,该问题与 v26.10.21 新增的路径解析逻辑有关,错误发生在路径解析阶段,配置文件本身可能已经被打开;因此,盲目重建节点通常不能解决这类路径回归。
修复后的验证顺序:不要只看图标是否变绿
修复后按下面顺序核验,能把“核心启动成功”和“节点可用”区分开:
- 查看日志,确认没有
Failed to start、failed to load config files或The system cannot find the path specified。 - 确认 v2rayN 显示的 Xray 核心版本与刚才选择的版本一致。
- 执行节点延迟测试。这里测到的是客户端的连通性或 HTTP 测试结果,不等同于 ICMP ping,也不等同于实际下载速度。
- 选择一个节点启动服务,再访问一个你平时用于确认代理出口的连接页面。
- 如果普通代理已经恢复,再单独打开 TUN;若只有 TUN、xhttp h3 或 hysteria 失败,转入对应传输问题排查。
v2rayN 的另一条公开 issue 记录了 Xray 26.10.21 下 TUN 与 xhttp h3、hysteria 的连接问题,报错包含 failed to set interface 和 http3: parsing frame failed。这与本文的“核心完全无法启动”不是同一故障,详情见 v2rayN issue #10451。
哪些情况不要套用这套修复
- 配置兼容性错误:如果日志明确写着
The feature "allowInsecure" has been removed and migrated to "pinnedPeerCertSha256",这是配置字段迁移问题,不是目录联接导致的找不到路径。v2rayN 讨论 #8737 展示了这类错误,见 v2rayN Discussion #8737。 - 节点连接失败:如果核心已经启动,只是某个节点超时、握手失败或无法访问目标地址,应检查节点配置、系统代理、DNS 或网络链路。
- 主程序打不开:如果 v2rayN 本身无法启动,先检查文件权限、杀毒软件隔离和安装文件完整性,不能直接认定为 Xray 26.10.21 回归。
- 普通物理目录安装:如果安装目录没有
current、junction 或 symlink,且日志也没有逐字出现上述路径错误,应先按一般的核心启动失败流程排查。
如果你还要排查普通连接超时,可继续阅读站内的 v2rayN 连接失败排查步骤;如果表现为代理整体超时,可参考 代理连接超时的分层排查方法。
结论与最低核验清单
最短路径是:先看日志是否逐字匹配,再确认 v2rayN 是否从 current 或其他目录联接启动;匹配后先从实体版本目录运行,不能调整路径时启用 V2RAYN_LOCAL_APPLICATION_DATA_V2=1,最后才考虑回退 Xray 核心。整个过程中应先备份配置,不要因为一次核心启动失败就删除节点和订阅。
- □ 日期与版本:问题发生在 2026 年 10 月 23 日公开记录的 Xray 26.10.21 场景。
- □ 日志:出现
The system cannot find the path specified.。 - □ 路径:确认是否存在 Scoop
current或 Windows 目录联接。 - □ 修复:实体版本目录、LocalAppData 模式、旧核心三选一。
- □ 验证:日志无启动错误、核心版本正确、普通节点先恢复,再测试 TUN。
需要准备代理客户端配置并进行实际连接核验时,可在完成上述基础排查后了解云小狐官网提供的相关服务,具体内容以官网为准。
常见问题
v2rayN Xray 26.10.21 无法启动,最先检查什么?
先看日志是否同时出现 Xray 26.10.21、config.json、The system cannot find the path specified 和运行 Core 失败,再检查程序是否从 Scoop 的 current 或其他 Windows 目录联接路径启动。
不使用 Scoop,也可能遇到这个问题吗?
可能。Xray-core issue #7239 说明,只要 Windows 工作目录包含目录 junction、symlink 或类似目录联接,就可能触发同类路径解析失败;手动使用 mklink /J 的安装布局也属于需要检查的范围。
回退 Xray 核心后,是否需要删除订阅或节点?
通常不应先删除。本文所述问题发生在核心读取相对路径时,优先备份配置并调整启动路径或核心版本;只有日志明确指向配置字段兼容性时,才按对应字段迁移处理。
allowInsecure 报错和本文问题一样吗?
不一样。如果日志明确出现 allowInsecure 已移除并迁移到 pinnedPeerCertSha256,这是配置兼容性问题;如果出现 The system cannot find the path specified,则优先检查 Windows 目录联接和工作目录。
修复后节点延迟测试仍显示 -1 ms 怎么办?
先确认核心日志已经没有启动失败,再确认当前选择的核心版本和节点配置。若核心已经启动但只有某个节点失败,转向节点、协议或网络链路排查;若仍是路径错误,重新检查是否实际从实体目录启动。