v2rayN 常见问题

v2rayN 是用于 Windows、macOS 和 Linux 的图形客户端，v2rayNG 用于 Android。客户端负责订阅管理、配置编辑与代理入口，实际连接由内核处理。Xray 与 V2Fly 属于相关的开源内核生态，支持能力会随版本变化。排查时先记录客户端名称、内核名称和报错，不要只写“V2Ray 不能用”。Android 上的 v2flyNG 是采用 V2Fly 内核的另一种客户端选择，配置是否可用仍需核对具体协议与参数。

订阅地址通常是一个网页请求地址，客户端访问它后获取一组配置，并可在之后继续更新。单条分享链接通常以 vmess://、vless:// 或 trojan:// 等协议前缀开头，用来导入单个配置。把订阅地址粘贴到单条配置导入入口，可能只得到格式错误；把分享链接填入订阅地址栏，也无法正常更新。先辨认内容，再选择订阅分组或剪贴板导入入口。订阅地址可能包含访问凭据，不要公开截图或完整链接。

安装客户端只完成了本机工具准备，还需要合法取得且有效的服务端配置或订阅。导入后应核对协议、服务器地址、端口和认证参数，再设为活动配置。客户端显示已启动，通常只说明本地内核或代理入口已运行，并不代表远端连接和所有应用都已正常。首次配置建议先使用支持系统代理的浏览器验证，再处理终端、游戏或其他应用。本站提供使用说明，不提供订阅地址或连接账号。

REALITY 不是“全局”或“绕过局域网”这样的代理模式，而是连接配置中的安全相关技术，常见于 VLESS 配置。是否使用 REALITY 由服务端方案决定，不能为了排查问题随意改成 TLS。导入后需要核对服务端要求的服务器名称、公钥、短标识及其他参数；字段名称可能随客户端版本变化。系统代理决定应用怎样进入客户端，路由决定流量走哪条出口，这两项与 REALITY 参数属于不同层次，应分别检查。

优先根据设备支持的应用架构选择。近年的主流 Android 手机通常适用 arm64 包，包体一般比通用包更小；universal 包包含多种架构，适合暂时无法确定架构时尝试。不要仅凭手机购买年份判断，部分设备的系统环境与芯片能力并不一致。如果提示不兼容，可先查看系统或设备说明中的架构信息；通用包仍无法安装时，再核对 Android 版本、存储空间及签名冲突，而不是反复换同一架构的包。

在订阅分组设置中新增分组，填写便于辨认的备注，把完整订阅地址粘贴到地址栏，保存后执行更新当前订阅。先排除复制时混入空格、换行、引号或说明文字，再确认地址仍然有效。如果复制的是单条分享链接，应改用剪贴板导入服务器的入口。Base64 是部分订阅内容使用的编码方式，不代表任意一段编码文本都能放进订阅地址栏。菜单文字可能变化，以当前版本中对应的订阅管理入口为准。

先确认下载的是适合当前系统的客户端构建，并将压缩包完整解压到可写目录，不要直接在压缩包预览中运行。只有当前构建明确依赖外部运行库，或错误提示缺少运行环境时，才按其要求补装对应架构的 .NET 桌面运行库；不要把所有闪退都归因于运行库。接着检查安全软件拦截记录、目录权限和启动日志。若怀疑配置损坏，先备份，再用独立的新目录测试，避免直接删除原有订阅和路由设置。

TUN 需要创建或配置虚拟网络接口，桌面端可能要求管理员授权、服务组件或系统网络权限，具体取决于平台和客户端版本。先关闭其他接管网络的工具，再按客户端提示完成授权，不要给整个安装目录设置过宽权限。Android 上应确认系统的 VPN 连接授权；已有其他 VPN 连接时可能无法同时启用。授权后仍失败，查看日志中的接口或路由错误。排查期间先关闭 TUN，用普通本地代理确认远端配置可用，再单独处理 TUN。

需要让支持系统代理的应用使用客户端时，选择“自动配置系统代理”。“清除系统代理”用于移除客户端设置的系统代理入口，常用于停用或排查残留；“不改变系统代理”表示不主动修改现有系统设置，并不等于所有流量都直连。系统代理只是应用接入方式，不等于全局路由，也不会自动覆盖所有程序。切换之前记下原有设置，尤其是设备已有单位网络代理时。验证完成后，退出客户端也应检查系统代理是否按预期恢复。

不少命令行程序不会读取桌面系统代理，而是读取自身代理配置或 http_proxy、https_proxy、all_proxy 等环境变量。先查看程序文档，确认它支持 HTTP 代理还是 SOCKS 代理，再填入客户端实际启用的本地监听地址与对应端口。不要把 SOCKS 端口当作 HTTP 端口使用，也不要默认不同版本的端口相同。测试变量可先限定在当前终端会话，成功后再决定是否持久化。若以前配过代理，还要检查旧变量和 no_proxy 是否影响本次请求。

绕过局域网通常让私有地址范围走直连，以便访问路由器、打印机和本地服务；其他流量怎样处理，还要看当前规则集。全局路由通常将进入客户端的流量统一送往代理出口，但没有进入客户端的应用并不会因此自动被接管。访问本地设备异常时，先核对目标地址命中的规则和规则顺序，再判断是否由 TUN 或 DNS 设置改变了路径。不要同时修改代理模式、路由和 DNS，逐项调整并复测同一个目标，更容易找到影响来源。

把个人手动添加的配置放到独立分组，避免直接修改订阅生成的配置，因为再次更新时这些字段可能被覆盖。更新前备份客户端配置及自定义路由，并记下当前使用的分组与配置；备份文件同样可能含有凭据，需要妥善保管。更新后确认活动配置仍然存在，再检查传输与安全参数是否变化。自动更新只是重新获取订阅内容，不会替服务端修复过期账号。若更新结果明显异常，先查看返回内容和日志，不要连续覆盖唯一一份备份。

先确认本机网络可正常访问日常直连站点，并开启系统自动校时；时间偏差可能导致安全握手失败。再检查客户端内核是否启动、本地监听端口是否被其他程序占用，随后核对服务器地址、远端端口、传输方式和 TLS 或 REALITY 参数。观察日志区分域名解析失败、连接超时、拒绝连接与握手失败，不要把它们当成同一种问题。若只在某个网络环境失败，可换一个获准使用的网络复测。不要通过关闭证书验证来掩盖配置错误。

先确认“已连接”代表的是本地服务启动还是远端请求成功，再用同一浏览器分别访问一个平时可直连的站点和需要代理的目标。检查活动配置是否选对、系统代理是否指向客户端当前监听端口，以及浏览器是否启用了独立代理设置。随后查看访问时有没有对应日志：没有记录，优先排查应用未进入客户端；有记录但解析失败，检查 DNS；有握手错误，则核对远端参数。还应确认订阅服务状态，连接入口启动并不代表账号仍然有效。

打开操作系统的代理设置，确认地址与端口和客户端当前监听入口一致，再查看浏览器扩展是否覆盖了系统设置。某些浏览器或工作配置会使用独立代理、自动配置脚本或受管理策略，切换客户端菜单不会覆盖这些来源。可在符合设备管理要求的前提下，暂时停用代理扩展，并关闭浏览器后重新打开测试；隐私窗口不一定会绕过代理扩展或管理策略。若客户端日志没有请求，先解决入口问题，不要立即更换订阅或改动远端协议。

先读更新错误：超时通常需要检查请求路径与网络，未授权或禁止访问则应核对订阅权限，返回格式错误可能是登录页面或错误页面被当成配置读取。客户端支持选择更新路径时，可先尝试不通过代理更新；若订阅服务确实要求代理访问，再使用已经可用的配置更新，避免依赖尚未导入的配置形成循环。若地址过期或被重置，需要从原服务方重新取得。分享报错时只保留错误类型与必要状态信息，遮住完整地址、认证字段和返回内容中的凭据。