v2rayN 常见问题

Windows、macOS 与 Linux 桌面系统选择 v2rayN；Android 设备优先了解采用 Xray 内核的 v2rayNG，采用 V2Fly 内核的 v2flyNG 可作为备选。客户端负责管理配置、调用内核并提供代理入口，不会自动生成可用的订阅。选择前先确认设备平台，再核对订阅使用的协议与传输方式是否受当前客户端支持。三款软件的配置目录和界面不同，迁移时宜重新导入订阅，不要直接覆盖彼此的数据文件。

还需要来源可信且仍有效的订阅地址，或一份完整的服务器配置。订阅通常包含服务器地址、端口、协议与认证参数，客户端只负责读取和使用这些信息。安装完成后，先导入配置，再选择一个服务器，最后设置系统代理或安卓 VPN 接入并验证访问。软件安装成功不代表服务器已经可用；如果尚未取得配置，应向配置提供方确认获取方式。不要把来历不明的配置当作测试材料，也不要在公开截图中保留订阅地址。

订阅地址是用于获取一组配置的入口，更新后可能新增、删除或修改服务器；单个节点分享链接通常只携带一份服务器配置，不会随订阅自动变化。导入前先辨认拿到的是网页地址、订阅地址还是协议分享链接。订阅应放入订阅分组的地址栏，分享链接则使用客户端对应的剪贴板导入入口。账户管理页面不能代替订阅地址，复制时还要避开前后空格与换行。订阅地址中的认证参数属于敏感信息，应按账户凭据保管。

系统代理会把代理入口写入操作系统设置，通常供遵循该设置的浏览器和应用使用；自行建立连接或使用独立代理配置的软件可能不受影响。TUN 模式通过虚拟网络接口接入流量，可覆盖更多应用，但同时涉及路由、DNS 和系统权限。两种方式都不等于所有请求必定通过代理，最终出口仍受分流规则影响。刚开始配置时建议先用系统代理确认连接，再按实际需求启用 TUN，避免同时改变多项网络设置而难以定位问题。

先确认复制的是完整订阅地址，而不是账户登录页或付款页面，并删除首尾空格。打开订阅分组，添加地址并保存后，还要执行更新全部订阅，单纯保存不会立即生成服务器列表。若提示格式无法识别，检查返回内容是否为登录页、错误页，或当前客户端不支持的配置格式；不要只反复粘贴同一地址。若部分配置未出现，查看日志中的解析提示，再向提供方确认兼容格式。排查时只描述错误类型，不公开包含认证参数的完整地址。

2015 年后的主流 Android 手机通常可优先选择 arm64，但仍应以设备实际支持的应用架构为准。universal 包含多种架构，体积通常更大，适合无法确认架构或需要兼容不同设备的情况。若 arm64 安装时提示不兼容，可先查看系统和处理器信息，再尝试通用版；部分设备的处理器支持 64 位，但系统环境仍可能有限制。出现解析安装包失败时，还需检查系统版本是否满足要求，不能把所有安装失败都归因于架构选择。

桌面版采用跨平台界面，经典 WPF 版用于 Windows，两者的界面布局、依赖和部分设置入口可能不同。切换前先使用客户端可用的导出或备份功能保存配置，并记录订阅分组、路由与本地端口。随后关闭旧客户端，再启动另一版本，避免争用同一代理端口。不要把新旧版本文件随意混合覆盖，也不要在未确认迁移结果前删除原数据。首次启动后重新检查系统代理入口和当前服务器，确认连接正常再清理旧目录。

在 Windows 上先退出客户端，再以管理员权限运行并重新启用 TUN。macOS 与 Linux 的权限授予方式取决于客户端版本和系统环境，应按当前界面提示完成授权，不要随意放宽整个配置目录的权限。若授权后仍失败，查看日志是否提到虚拟接口创建失败、驱动问题或端口占用，并检查是否存在其他 VPN 或 TUN 程序。每次只保留一个接管网络的工具进行测试；失败后先关闭 TUN、恢复普通网络，再继续定位具体原因。

订阅中的服务器信息由提供方维护，更新时可能被重新生成，因此不要依赖订阅条目长期保存手动修改。需要测试某个参数时，先把相关配置复制为独立的手动条目，使用清楚的备注区分订阅原项与测试项。订阅更新前也可备份当前配置，防止误操作后无法恢复。若经常需要修改同一字段，应先向提供方确认原始配置是否有误，而不是每次更新后重复修补。分组级设置与服务器字段的保留行为可能不同，应以当前版本实际结果为准。

希望浏览器等应用使用客户端入口时，选择自动配置系统代理；暂时停止使用或准备退出客户端时，可选择清除系统代理；已有其他工具负责管理系统代理时，才考虑不改变系统代理。不改变并不表示直连，而是保留系统当时已有的设置，旧代理地址也可能继续生效。切换后应到操作系统代理设置中核对实际入口。若关闭客户端后浏览器仍无法访问，先检查是否遗留指向本地端口的代理，再清除不再使用的入口。

浏览器和终端工具可能读取不同的代理配置，浏览器正常只能说明其自身路径可用。先查看终端工具是否支持系统代理；若不支持，再按该工具的文档设置代理参数或 http_proxy、https_proxy 等环境变量。地址应填写客户端实际监听的本地地址与端口，并匹配 HTTP 或 SOCKS 类型，不要照抄其他设备的数值。环境变量常只对当前会话或新启动的进程生效。测试结束后清理临时设置，避免客户端关闭后终端仍尝试连接旧端口。

先检查路由规则是否包含 geoip:private 指向 direct 的条目，并确认该规则位于可能提前匹配的宽泛规则之前。它主要针对私有地址，不代表所有内部域名都一定被覆盖；使用内部域名访问时，还需确认 DNS 返回的是正确的内网地址。保存规则后重新测试路由器管理页、打印机或内部服务。如果仍无法访问，暂时关闭代理确认基础网络是否正常，再检查应用是否自行指定了代理。不要为了一个局域网服务直接删除整套分流规则。

先区分请求超时、认证失败与内容解析失败三类情况。超时时检查本地网络和订阅域名能否解析，并确认更新操作使用直连还是现有代理；若现有节点已经失效，依赖该节点更新就可能失败。认证失败应检查订阅是否到期、地址是否被重置；解析失败则检查提供方是否更换格式。不要连续高频重试，服务端可能限制请求。若需要重新获取订阅地址，保存后再更新，并只向提供方提交去掉认证参数的错误信息。

单次测试超时只表示该测试请求未在规定时间内完成，不能据此判断整组配置全部失效。先检查设备时间是否准确，再换同一分组内另一个服务器进行真实访问测试。若仅一个条目失败，核对地址、端口和传输参数；若全部失败，优先检查本地网络、订阅有效期、内核启动日志与防火墙提示。部分测试目标不可达也会造成超时，可换用客户端支持的其他测试方式交叉确认。不要为排查连接而长期关闭系统防护。

已连接通常只说明本地服务或安卓 VPN 接口已经启动，并不保证远端服务器可访问。先关闭 TUN，仅保留一种接入方式，确认当前服务器与本地监听端口，再检查系统代理是否指向该端口。浏览器有独立代理扩展时，暂时停用扩展并重新打开页面。若域名打不开但网络连接仍在，继续检查 DNS；若所有请求都失败，查看内核日志中的认证、握手或连接错误。Android 还应检查按应用代理列表，确认浏览器没有被排除。

先观察断开是否只发生在锁屏或切换应用之后。如果前台访问正常、后台经常停止，检查系统是否限制了客户端的后台活动或电池使用，并按设备设置允许必要的后台运行。确认 VPN 授权仍有效，且没有另一个 VPN 应用替换当前连接。若只在无线网络与移动数据之间切换时失败，回到客户端重新连接并查看日志，再测试其他服务器。后台限制与节点故障可能同时存在，宜分别测试，不要一次更改电池、DNS、路由和服务器全部设置。