NekoBox 导入 VLESS Reality 失败怎么查参数 | vless 链接先拆成哪 3 段？

Q: NekoBox 导入后有名称但连不上是什么原因？

节点名称来自 #name，连接参数在问号后。Android 分享时可能保留名称，却截断 pbk、sid、sni 或 fp，所以要回到完整 vless 链接核对。

Q: NekoBox 要不要手动换核心？

先看日志。NekoBox 1.4.2 release 已升级到 sing-box 1.12.19-neko-1；只有日志提示协议或字段不支持时，才优先考虑版本。

vless 链接先拆成哪 3 段？

vless://[email protected]:443?security=reality&sni=example.com&fp=chrome&pbk=xxxxx&sid=abcd&flow=xtls-rprx-vision#name

位置	作用	常见问题
`vless://uuid@host:port`	用户 ID、地址、端口	host 换行、端口丢失
`?security=reality...`	Reality 和传输参数	`pbk`、`sid`、`sni` 被截断
`#name`	显示名称	名称乱码不一定影响连接

优先看第二段。只看第一段和 #name，通常只能确认节点被保存，不能确认 Reality 能握手。

Reality 参数到底要对哪几个？

XTLS REALITY 仓库里的客户端字段，能对应到常见分享链接参数：

分享链接参数	REALITY 客户端含义	备注
`security=reality`	启用 REALITY	少了就不是 Reality 链路
`sni`	`serverName`	要在服务端允许的 `serverNames` 里
`pbk`	`password` / 公钥	来自服务端私钥生成的 public key
`sid`	`shortId`	服务端 `shortIds` 里的一个值
`fp`	`fingerprint`	常见值是 chrome，按订阅保留
`flow`	VLESS `flow`	Vision 常见 `xtls-rprx-vision`

Xray VLESS 文档还强调，encryption 禁用时要显式写 none。如果订阅转换结果把 encryption 丢掉，某些客户端会直接拒绝导入或连接。

Android 分享为什么会把链接弄坏？

两个符号最容易出事：& 和 #。

& 是查询参数分隔符，pbk、sid、sni、fp 往往都排在它后面。有些聊天软件会把 & 后面的内容当成普通文本、预览参数或换行后的片段处理。

# 后面是名称片段。节点名称能显示，只能说明最后一段还在；前面的 Reality 参数可能已经断了。

排查时按这个顺序做：

从原始来源重新复制整条 vless:// 链接。
先贴到纯文本编辑器，不要直接二次分享。
确认整条链接只有一行。
搜 security=reality、pbk=、sid=、sni=、fp=。
再粘到 NekoBox 的导入入口。

NekoBox 日志该搜什么词？

NekoBox 使用 sing-box 作为核心。日志里重点搜这些词：

reality
tls
handshake
short_id
public key
unsupported

timeout 不一定是参数错，也可能是网络路径或服务端没有响应。invalid public key、unknown security、unsupported 更像字段缺失、字段不兼容或版本不支持。

什么时候才该怀疑版本问题？

NekoBox for Android release 页面显示，1.4.2 升级到 sing-box 1.12.19-neko-1，1.4.1 是 sing-box 1.12.12-neko-1。如果你用很旧版本，Reality、Vision 或新字段可能解析不一致。

别一上来就换版本。更稳的判断顺序是：同一条链接在纯文本里参数完整、同一服务端在其它客户端可用、NekoBox 日志又提示字段不支持，再考虑更新。

怎么确认真的导入成功？

导入成功不等于连通。至少同时满足这 4 个信号：

节点保存后，Reality 参数没有被 NekoBox 清空。
测延迟有结果，或者日志能看到目标 outbound。
HTTPS 页面能打开。
切换到另一个节点再切回来，参数仍然完整。

如果每次给 Clash、sing-box、V2Ray、NekoBox 分别导出都要手工补 Reality 字段，问题可能不在手机端，而在订阅格式或转换链路。多客户端共用配置时，可以用兼容 Clash / Singbox / V2Ray 的订阅减少手工改字段；单个 NekoBox 节点连不上，仍然先查原始链接。

FAQ

NekoBox 导入后有名称但连不上是什么原因？

节点名称来自 #name，连接参数在问号后。Android 分享时可能保留名称，却截断 pbk、sid、sni 或 fp，所以要回到完整 vless:// 链接核对。

Reality 的 fp 可以随便填吗？

不建议随便改。REALITY 客户端 fingerprint 要和服务端预期匹配，常见值是 chrome，但最终以订阅下发的字段为准。

NekoBox 要不要手动换核心？

先看日志。NekoBox 1.4.2 release 已升级到 sing-box 1.12.19-neko-1；只有日志提示协议或字段不支持时，才优先考虑版本。

flow 为空一定错吗？

不一定。Xray VLESS 文档说明 flow 为空是普通 TLS 代理模式，xtls-rprx-vision 才是 Vision 模式。以服务端和订阅内容一致为准。

NekoBox 扫码和粘贴导入哪个更稳？

参数很长时优先粘贴原始文本。扫码可能受二维码生成工具、换行和分享软件影响；粘贴后还能先确认 security、pbk、sid、sni、fp 是否都在。