SSH 私钥文件导致 Clash Verge Rev 服务模式无法启动内核
核对 SSH private-key 的文件路径、安全路径与认证错误，说明 2.5.10 的正式修复及旧符号链接方案的验证边界。
本页目录
Clash Verge Rev 配置 SSH 节点后，如果 private-key 指向本地私钥文件，普通模式能够使用，服务模式却无法启动内核，应先检查日志中的路径解析和安全路径错误。SSH 私钥文件不是网站证书，不能通过关闭 TLS 校验解决。
涉及版本与修复进展
原始反馈来自 Windows 11、Rev 2.5.8，SSH 节点使用相对私钥路径。服务内核尝试从自己的运行目录读取文件后，出现找不到路径的错误；改成应用目录内的绝对路径，又出现不属于允许路径的错误。
2.5.10 官方发行说明已明确修复服务模式下，SSH 节点的 private-key 使用私钥文件时内核无法启动的问题。11 月 5 日，原反馈者也表示该版本解决了其私钥文件问题，但提到旧的符号链接处理方式不再适用。
先确认报错是不是同一类
在日志导出入口 取得内核启动记录，定位与 SSH 节点有关的第一条配置错误，而不是只截取最后的「内核启动失败」。
| 错误表现 | 需要核对 |
|---|---|
| 私钥文件找不到 | 配置中路径、文件是否存在、服务实际解析的路径 |
path is not subpath of home directory or SAFE_PATHS | 当前版本如何处理服务私有目录与允许路径 |
| 私钥解密或 SSH 认证失败 | 私钥格式、口令及服务器授权，不是同一种路径问题 |
日志中的个人路径、SSH 用户名、主机信息都应脱敏，不要上传私钥正文。
升级后保留原配置验证
- 先备份配置 ，并在自己可控的位置保留私钥备份。
- 正常退出旧客户端，从下载页 安装匹配架构的 2.5.10 稳定版。
- 核对服务与主程序是否匹配，再加载原有 SSH 节点配置。
- 检查内核是否通过校验并启动，然后选择该节点，发起一次新连接。
- 若仍然失败，保留升级后的首条路径或认证错误，不能仅凭版本已更新就认定恢复。
不要为排查将私钥放到公开目录，也不要把整个应用目录或服务目录改成所有人可写。
不要直接沿用旧版符号链接方案
旧讨论中存在手动复制文件到服务运行目录的临时方式，后续又提到符号链接会受到路径规范化影响。它们不应直接当作新版本的默认安装步骤。
已经采用旧方案时，先记录符号链接与实际文件分别指向哪里，保留原配置和私钥备份。优先测试正式版支持的普通文件方式；不要在尚未确认链路恢复前删除唯一的私钥文件。需要回退时恢复本次修改前的配置与文件，不要依赖受服务管理的临时副本。
私钥字段与口令
Mihomo 的 SSH 节点中，private-key 用于私钥，受密码保护的私钥另有对应口令字段。字段语义应以Mihomo SSH 文档
为准；文件路径正确并不代表服务器端认证一定成功。
当前进展
该 Issue 仍开放，但私钥文件启动问题已有 2.5.10 正式修复及原反馈者的恢复记录。符号链接或不同路径布局的剩余问题，应按各自新错误继续核对，不能据此反向否定所有普通私钥文件场景。
参考：Issue #8445 、2.5.10 版本更新 。