准备工作:平台、配置与接入方式
先区分客户端、内核与服务器配置
V2Ray 是 Project V 生态中的技术名称,实际安装与日常操作主要通过图形客户端完成。桌面平台首推 v2rayN;Android 优先选择使用 Xray 内核的 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。客户端负责保存配置、更新订阅和提供设置界面,内核负责协议处理、连接与路由。安装客户端不会自动获得服务器,也不会自动生成可用订阅。开始之前,应准备由配置提供方交付的订阅地址、分享链接或完整配置文件,并确认其适用客户端。
配置兼容性不能只看名称相似。VMess、VLESS、Trojan 等协议需要匹配各自字段,传输方式与 TLS 设置也必须一致。带有 REALITY 参数的配置,要确认目标内核及其具体实现支持相应功能;不能把原配置的安全选项随意改成另一种方式。客户端能显示一条记录,只说明导入程序识别了部分内容,不代表内核已经接受全部参数。遇到格式说明不清晰的订阅,先向提供方确认输出格式,不要通过反复切换内核猜测。
确认系统架构与安装位置
下载前先在系统设置中查看处理器架构,再选择安装包。Windows 下载区区分桌面版与经典 WPF 版;macOS 区分 Apple Silicon 与 Intel;Linux 同时区分 deb、rpm 和处理器架构;Android 区分 arm64 与通用包。架构不一致可能导致安装程序拒绝运行,或在启动内核时才暴露错误。桌面版建议放在当前用户可写的普通目录,避免从压缩包预览窗口直接启动,也不要把运行目录放进临时下载缓存、同步冲突频繁的目录或只读位置。
准备网络与配置资料
先确认未启动代理时,系统网络本身能够访问正常业务资源,系统日期与时区也正确。订阅地址应完整保存,尤其注意查询参数、大小写和末尾字符;地址中的访问令牌属于凭据,不应发送到公开讨论区。排错时记录客户端名称、系统架构、所选内核和报错时间,但不要记录完整订阅地址。若需要截图,先遮住服务器地址、用户标识和个人账户信息。对原有客户端做迁移前,先通过其导出功能保存配置,并把备份放到个人可控制的位置。
明确系统代理、TUN 与 VPN 的差别
桌面系统代理向遵循系统设置的应用告知本地代理地址,通常适合浏览器与常规桌面程序。TUN 通过虚拟网络接口接入更多流量,还会涉及路由、DNS 和额外权限。Android 客户端通常借助系统 VPN 接口接管应用流量,首次启动会显示系统授权提示。这些方式解决的是流量如何进入内核,不等同于内核如何选择出口。首次配置建议只启用一种接入方式,完成验证后再按实际需求增加其他选项,避免多个代理工具同时改写网络设置。
本手册中的菜单名称用于定位功能,不保证每个客户端界面逐字一致。发行版更新可能调整入口位置,查找时应围绕“订阅分组”“系统代理”“路由设置”等功能名称,而不是依赖按钮颜色或固定坐标。涉及运行库、权限和驱动的提示,要阅读客户端当前发行说明与系统弹窗;不要因为某份旧教程写了管理员启动,就把所有日常操作都改为高权限运行。安装准备完成后,再进入对应平台章节,避免交叉套用不同系统的操作路径。
Windows:v2rayN 安装与系统代理
选择桌面版或经典 WPF 版
进入Windows 下载区,先区分桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版延续经典 Windows 界面;两者的菜单布局、设置入口和依赖要求可能不同。选择时优先考虑系统兼容性与既有操作习惯,不要把两套程序覆盖到同一目录。下载区当前提供的是对应架构入口;如果设备架构与入口不一致,应先核对当前发行说明,不能仅凭 Windows 名称就认为任意安装包都能原生运行。
取得安装文件后,根据文件类型完成安装或完整解压。需要解压的包应展开全部目录,保持客户端与随附内核文件的相对位置,再从解压后的目录启动。首次运行若提示缺少运行环境,按当前程序给出的环境名称与架构安装对应组件,而不是随机补装多套运行库。若系统阻止启动,应先检查文件来源、系统提示的具体原因和本地防护记录,不要直接关闭整套防护功能。界面能打开但内核不能运行时,仍要检查内核文件是否完整保留在预期目录。
导入订阅并选中可用配置
在订阅分组设置中新增分组,填写便于辨认的名称,再粘贴完整订阅地址并保存。保存分组与拉取内容是两步操作:保存后执行更新订阅,等待列表出现配置记录。若使用单条分享链接,可通过客户端的剪贴板导入功能添加,不必为了单条配置创建远程订阅。导入后检查协议、传输与安全选项是否与来源说明一致,再将一条配置设为活动项。仅在列表里单击高亮不一定等于切换活动配置,应以客户端状态提示为准。
如果订阅列表为空,先查看更新提示是否包含连接失败、认证失败或解析失败。连接失败要检查订阅下载时使用的是直连还是已有代理;认证失败要确认地址是否过期;解析失败则检查返回内容是否真的是客户端支持的订阅格式。不要反复新增同名分组来尝试解决,这会增加重复记录,反而掩盖问题。已存在可用配置时,可保留它作为回退项,再单独检查新分组,避免一次清空所有配置后失去可用连接。
启用系统代理,再按需启用 TUN
先启动活动配置,再选择自动配置系统代理。随后打开系统代理设置,确认代理地址指向客户端实际监听的本机地址,端口也与客户端设置一致。HTTP、SOCKS 和混合入口不是可随意互换的名称,应用手动配置时必须匹配端口类型。浏览器如果安装了独立代理扩展,可能不读取系统设置;验证阶段先停用该扩展的接管功能。需要让不遵循系统代理的程序接入时,再研究 TUN;启用前先清除系统代理,减少两套接入路径叠加造成的干扰。
处理权限、退出恢复与迁移
TUN 可能要求权限提升或安装相关网络组件,应根据客户端当前提示完成,而不是长期把整个程序设为管理员运行。启用后如果内网打印、共享目录或企业网络受影响,先停用 TUN,确认是否为路由接管范围问题,再增加必要的直连规则。使用其他 VPN 或企业接入软件时,应逐个测试,不能假定多个虚拟网卡能够自动协调。休眠恢复后异常,可先停止服务再重新启动,观察虚拟接口与 DNS 是否正常恢复。
正常退出前使用客户端的清除系统代理功能,再关闭程序。若客户端意外结束,系统可能仍保留指向本机端口的代理设置,此时浏览器会连接到已经停止监听的地址。重新打开客户端清除设置,或在系统代理页核对后恢复原状态。迁移到另一目录时,先退出程序并备份配置,再移动完整目录;不要运行两个共享同一配置目录的实例。更多桌面界面差异可查阅v2rayN Windows 安装配置全流程,排错时仍以当前日志为依据。
macOS:芯片选择、权限与网络服务
按芯片类型选择 v2rayN
在系统的“关于本机”中查看芯片信息,再进入macOS 下载区选择 Apple Silicon 或 Intel 对应的 v2rayN 安装文件。不要通过设备购买年份推断芯片,也不要把文件名中的架构标记当成可忽略的装饰。下载完成后打开磁盘映像,按照包内提示把应用放到常规应用位置,再从安装后的应用启动。运行中的应用不应长期依赖仍挂载的下载映像,否则后续更新、路径引用和卸载操作容易混淆。
首次打开时,系统可能要求确认应用来源或阻止运行。先阅读系统给出的具体原因,在确认来源与安装步骤后,通过系统允许的单次打开流程处理。不要使用批量移除系统保护的命令,也不要把“来源限制”和“应用已损坏”两类提示视为同一个问题。若客户端界面正常而内核退出,应继续检查架构、执行权限与日志中的文件路径;重复拖动应用图标通常不能解决内核运行环境不匹配。
建立订阅分组与活动配置
打开订阅管理功能,建立单独分组,填写订阅地址并执行更新。分组名称只用于本地辨认,真正决定远程内容的是地址及其参数。导入分享链接时,先确认剪贴板里只有完整链接,没有来自聊天软件的说明、引号或换行。更新结束后选择一条活动配置,检查内核能否正常启动,再设置系统代理。桌面迁移来的配置可能包含另一个系统的本地文件路径,例如规则文件或证书路径,这些字段需要重新指定,不能原样沿用。
订阅更新走哪条网络路径,取决于客户端提供的更新选项和当时的连接状态。首次启动尚无可用配置时,如果更新依赖代理,会形成先有配置才能更新的循环。此时应按提供方说明取得可用的初始配置,或确认订阅端点能否通过当前网络直连访问。已经可以连接时,不要为了更新一组订阅删除全部旧配置。更新完成后核对活动项是否仍然存在,避免远程配置重命名后客户端没有自动选中替代记录。
核对当前网络服务的代理状态
macOS 的代理设置与网络服务相关。客户端启用系统代理后,应在当前实际使用的网络服务中检查设置,例如正在使用的无线网络或有线连接。切换网络、连接扩展坞或调整服务顺序后,原来的代理状态可能不再对应当前路径。浏览器能否读取系统代理还受自身配置影响,使用独立代理扩展的浏览器应单独检查。先用一个读取系统设置的应用验证,再处理其他应用,不要仅凭菜单栏图标判断整个系统的流量已经接入。
系统代理正常但特定应用仍直连,可能是该应用忽略系统设置,或使用自己的网络栈。需要扩大接入范围时再考虑 TUN,并按客户端提示处理权限。启用前先记录原有网络代理与 DNS 设置,停止其他同类网络接管工具。企业设备可能由管理策略限制修改网络设置,此时应遵循设备管理要求,不能通过反复授权解决策略限制。授权成功也不代表内核已接管流量,仍要通过日志与实际应用请求确认。
处理休眠、切网与退出残留
休眠唤醒后出现连接异常,先确认系统已经取得网络连接,再停止并重启客户端服务。若只有切换网络后失败,应重点检查当前服务的代理设置、DNS 与旧连接是否仍然存在,而不是立即更换协议。正常退出时先清除系统代理;应用意外关闭后,如果浏览器持续提示无法连接代理服务器,检查当前网络服务是否仍指向本机地址。恢复设置时只撤销本次客户端写入的内容,不要顺手删除企业网络所需的其他设置。
更新客户端前保存订阅分组与自定义路由,并记录所选内核。替换应用后先用原有简单配置验证,再恢复复杂规则。若新程序无法读取旧目录,检查配置存储位置与当前用户权限,避免直接复制整个缓存目录造成权限继承问题。平台排错要区分应用启动、内核启动和系统接入三个阶段:应用无法打开先查系统提示,内核退出查日志,只有业务应用失败才查代理路径。按阶段处理,比不断重装更容易保留可解释的结果。
Linux:包格式、桌面代理与 TUN 权限
按发行版与架构选择安装包
进入Linux 下载区,先依据发行版选择 deb 或 rpm,再确认使用 x64 还是 arm64。deb 常用于 Debian、Ubuntu 及其相关发行版,rpm 常用于 Fedora 等发行版,但包格式相同并不保证所有依赖都相同。安装前查看当前发行版的软件安装工具给出的依赖提示,不要忽略报错后直接尝试启动。图形客户端需要桌面会话,只有命令行环境的服务器不属于本页的操作范围,不能照搬桌面自启动与系统代理步骤。
优先使用系统图形软件安装工具打开安装包,让包管理器处理依赖与文件登记。若安装器提示依赖缺失,应记录具体组件名称与系统版本,再确认当前发行包是否适合该系统。不要从来源不明的位置复制动态库到系统目录,也不要把缺依赖与缺执行权限混为一谈。安装完成后从桌面应用菜单启动 v2rayN,确认图形界面、配置目录和日志功能可用。客户端与内核的执行文件应保持包内预期结构,不能只复制一个主程序到桌面。
以普通用户导入与运行
首次启动使用日常桌面用户,新增订阅分组并更新,或导入单条分享链接。配置目录需要由当前用户正常写入;如果曾用高权限启动,可能留下普通用户无法修改的文件。遇到保存失败时先查目录权限与剩余空间,不要继续提高整个程序的权限。活动配置选定后观察内核日志,确认不是端口占用、文件缺失或不支持字段。桌面版的配置入口与 Windows 可能接近,但本地路径、权限和网络接管机制不能按另一个平台直接套用。
自定义规则、证书或外部资源文件应放在稳定、可读的位置,再通过客户端设置选择。不要引用可移动存储器上的临时路径,也不要假定从其他电脑导出的绝对路径仍然存在。订阅里的远程服务器参数通常与系统无关,但附加文件和本机监听设置属于环境配置,迁移后需要逐项复查。如果配置导入成功却无法启动,先在日志中找第一条明确错误,而不是只看界面最后显示的“启动失败”汇总信息。
理解桌面系统代理的覆盖范围
Linux 的系统代理取决于桌面环境与应用实现,不能理解为一个所有程序必然遵循的总开关。客户端写入桌面代理后,浏览器可能采用该设置,某些应用却只读取自身配置或环境变量。验证时分别检查浏览器、目标业务程序和客户端日志,不要因为一个应用可用就宣布全部流量已接管。若目标程序提供手动代理入口,应选择正确的 HTTP 或 SOCKS 类型,并填写客户端实际监听端口;环境变量与图形桌面设置也可能彼此独立。
不建议在尚未确认监听类型时,把同一个地址复制到所有代理字段。HTTP 代理端口、SOCKS 端口和混合入口的行为不同,是否支持 UDP 也取决于接入方式和内核配置。涉及本机代理时通常保持回环地址,不要为了让单个程序识别代理就把监听地址改为所有接口。需要局域网访问属于另一类配置,应同时考虑认证、防火墙和访问范围,不应作为普通桌面安装的默认步骤。
按需启用 TUN,区分权限与策略
TUN 接入涉及虚拟网络设备、路由表与 DNS,所需授权方式随发行包和系统而异。按客户端提供的功能完成权限配置,不要对整个应用目录赋予宽泛权限。启用失败时,检查日志是否明确指向设备创建、路由操作或权限拒绝,再检查系统策略记录。防火墙与系统访问控制可能影响网络接入,但解决方式应是确认具体规则,不是关闭全部策略。存在容器网络、企业 VPN 或其他虚拟接口时,先停用其中一套,建立最小可用状态。
桌面登录自启动与系统服务不是同一个概念。图形客户端通常依赖用户会话,设置自启动后应退出并重新登录验证,不要把它误注册为长期高权限服务。系统升级后如果只有 TUN 失效,优先检查权限、虚拟接口与路由恢复,再考虑客户端兼容性。正常退出前撤销接入设置,重启后仍异常则检查系统中是否残留手动代理。排错记录应同时保留桌面环境、发行版、架构和所用接入模式,才能区分应用问题与系统环境差异。
Android:导入配置与 VPN 模式
优先 v2rayNG,按需求选择 v2flyNG
Android 下载区首先提供 v2rayNG,适用于采用 Xray 内核的配置;v2flyNG 是使用 V2Fly 内核的备选。选择依据是配置协议与内核能力,而不是名称相近就认为两款完全等价。大多数较新的主流设备可先考虑 arm64,无法确认架构或安装器明确提示不兼容时,再核对设备信息并考虑通用包。处理器具备相应能力不一定代表系统运行环境完全相同,最终应以设备系统与安装包要求为准。
下载后通过系统文件管理器打开安装包,按提示允许当前来源执行本次安装。授权对象可能是浏览器或文件管理器,应确认正在授权的应用,不要给不相关程序开启安装权限。安装完成后打开客户端,先检查设置与日志入口,再导入配置。若更新时提示签名冲突或无法覆盖,先备份现有分组和配置,确认旧应用来源与新包是否一致;不能直接卸载后才发现配置只保存在旧应用内部。
导入订阅、分享链接与二维码
使用订阅管理功能新增分组,填入完整地址并保存,再执行更新。复制地址时避免从聊天气泡中带入解释文字;如果提供方交付的是分享链接,应使用对应导入功能,而不是把链接粘到订阅地址字段。二维码适合导入单条配置,但扫描结果仍要检查协议与参数。粘贴后没有新增记录,先查看客户端提示及剪贴板内容,不要连续点按导入导致重复记录。订阅更新成功后选中活动配置,再启动连接。
v2rayNG 与 v2flyNG 之间迁移时,应使用双方支持的标准分享格式,或由提供方重新给出适配订阅。不要把一款客户端的全部内部数据直接覆盖到另一款客户端的数据目录。相同协议名称下,安全参数、传输选项与内核扩展也可能不同,尤其是带有特定内核功能的配置。若导入后只有部分记录出现,先核对缺失记录的协议及格式,不能仅凭列表长度判断远程订阅是否完整。
授权 VPN 接口并验证连接
首次启动通常会出现 Android 的 VPN 连接请求,确认由当前客户端发起后再授权。授权表示允许应用创建系统 VPN 接口,不代表远端连接已经成功。启动后应查看客户端是否报告内核运行正常,再用实际目标应用验证。状态栏出现 VPN 标识只说明接口处于接入状态,远程服务器、DNS 和路由仍可能失败。如果设备已有另一款 VPN 连接,应先断开再测试,避免系统在两者之间切换或拒绝建立新接口。
应用分流用于决定哪些应用进入 VPN 接口,其“仅允许所选应用”与“排除所选应用”两种逻辑可能相反。启用前先阅读当前界面的说明,再选择测试应用。应用进入接口之后,还要由内核路由决定直连或代理,所以选中应用并不保证所有请求走同一出口。初次验证建议关闭复杂应用筛选,用简单配置确认整体可用,再逐项加回;否则一个被排除的浏览器会让人误以为服务器失效。
处理后台限制、私有 DNS 与网络切换
连接在熄屏后中断,优先检查系统是否限制客户端后台活动、电池使用或自启动。不同设备的设置位置不同,应围绕应用的后台运行权限查找,而不是套用固定品牌路径。允许后台活动后重新连接,并观察前台状态通知是否持续存在。若客户端仍在运行却只有域名请求失败,再检查系统私有 DNS、客户端 DNS 与网络条件是否冲突。排错时一次只改变一项,记录原设置,验证后决定是否保留。
无线网络与移动网络切换可能使旧连接失效,通常需要客户端重新建立连接;不要把短暂重连直接判断为配置错误。持续失败时先停止连接,确认系统自身网络恢复,再重启服务。若同一配置只在一个网络环境失败,检查订阅端点和服务器在该网络下的可达性,并向提供方反馈具体错误。退出客户端前主动停止 VPN;需要长期保持连接的用户,还应检查系统的持续连接及阻断选项,避免客户端停止后设备仍因系统策略无法联网。
订阅管理:格式、更新与配置迁移
分清订阅地址、分享链接与完整配置
订阅地址是供客户端请求配置集合的远程入口,内容可能随提供方调整;分享链接通常描述单条配置,导入后不一定与远程更新保持联系;完整配置文件则可能包含入站、出站、DNS 和路由等多部分。三者不能只按文本外观互换。把网页地址填进订阅框,客户端可能取得的是网页正文而不是配置数据;把完整 JSON 当成分享链接导入,也可能无法识别。先确认交付物的类型,再使用对应入口,能避免多数导入错误。
订阅的编码与容器格式只是外层,真正的兼容性取决于内部协议和字段。能够解码并不意味着所有记录都能启动,订阅转换也不能补出原始数据缺失的公钥、服务名或路径。确需转换时,优先使用来源明确且受控的方式,理解转换过程会接触订阅凭据。不要把个人订阅地址提交到不清楚数据处理方式的工具;如果配置依赖某个内核特性,先确认目标客户端支持,再考虑格式转换,而不是反过来通过转换强行迁移。
把更新过程拆成四个阶段
更新订阅可分为地址读取、网络请求、内容解析和列表应用四个阶段。地址读取失败通常来自空白字符、截断或转义错误;网络请求失败可能与 DNS、连接路径、认证或服务端状态有关;内容解析失败说明返回格式不符合预期;列表应用异常则要检查筛选条件、重复规则和当前分组。日志若只显示总失败,应先找更早的具体提示。按阶段定位,比一遇到错误就更换内核更有效,因为订阅请求不一定经过正在使用的协议连接。
更新前注意客户端选择的下载路径:直连、通过当前代理或其他可用方式,具体选项以界面为准。当前配置失效而订阅更新又依赖它,会让故障相互叠加。保留一条已确认可用的配置作为回退项,必要时先恢复更新路径。认证失败时不要连续高频刷新,应确认订阅是否被重置、账户状态是否变化、地址参数是否完整。返回成功但列表为空,也可能是远程确实没有可用记录,应查看提示而不是不断创建新分组。
管理分组、活动项与本地改动
不同来源应建立独立分组,名称采用自己能识别的用途或来源说明,避免把所有记录堆进默认列表。订阅更新可能替换远程管理的记录,本地手工修改的名称和部分参数未必能够保留。需要长期保存的自定义配置,应使用客户端提供的复制或独立配置功能,并明确它不再自动跟随原订阅。远程配置重命名或删除后,原活动项可能失效,因此更新完成后要确认当前选中项仍然存在,并重新验证内核状态。
| 资料类型 | 主要内容 | 迁移时的检查点 |
|---|---|---|
| 订阅地址 | 远程配置入口 | 地址有效性与访问权限 |
| 分享链接 | 单条连接参数 | 目标内核及字段兼容性 |
| 客户端备份 | 分组与本地设置 | 平台路径、端口与接入模式 |
迁移时先恢复数据,再恢复系统接入
迁移到新设备时,先备份旧设备数据,再在新设备建立最小配置。优先恢复订阅或分享记录,验证内核能够启动后,再恢复路由、应用筛选和自动启动。系统代理端口、网卡名称、本地文件路径及权限属于设备环境,不应原样复制。完整客户端备份适合相近环境下恢复,但仍要检查内核选择与接入设置。新旧设备不要通过同步工具同时写入同一份活动数据库,以免发生覆盖和锁定问题。
订阅地址、导出文件和包含连接参数的截图都应按凭据处理。公开求助时保留错误类型、协议名称和必要的字段结构,删除用户标识、服务器信息及访问令牌。若地址已经泄露,删除帖子不等于撤回凭据,应通过提供方可用的管理方式重置,再更新各设备保存的地址。常见格式问题可继续查阅FAQ;需要理解订阅与配置字段的区别时,可结合术语表核对概念,避免把更新失败与连接失败混在一起。
代理与分流:接入、路由和 DNS
按流量路径理解设置
完整路径可理解为应用发起请求、流量进入本地入口、内核匹配规则、选择出站、连接目标。系统代理与 TUN 决定前半段怎样接入,路由规则决定后半段选择直连、代理或拒绝。客户端显示“全局”时,要先确认它指的是系统代理接入范围,还是内核把已接入流量统一送到代理出口;不同界面可能采用不同命名。没有进入本地入口的请求,不会因为切换内核路由模式就自动被接管,这也是某些程序始终直连的原因。
普通浏览器使用可以先选系统代理,只有确需接管更多程序或协议时再启用 TUN。系统代理下的应用若绕过本地地址,可能是应用自己的例外列表;TUN 下的直连则可能由内核规则或网段排除决定。排查时应先确认请求是否进入内核,再判断命中了哪条规则。不要在不知道问题发生在哪一段时,同时开启 TUN、修改 DNS、切换全局并更换服务器;即使恢复连接,也无法知道真正起作用的是哪一步。
路由规则先明确优先级
多数规则按顺序匹配,较早命中的规则会影响最终出口。局域网、特定业务域名和默认出口应各自有明确位置。过于宽泛的规则放在前面,会遮蔽后面的细分规则;反过来,缺少兜底行为也会让未匹配请求走到非预期出口。以下示例是 Xray 风格的路由片段,只演示私有地址直连与特定域名后缀匹配。它不是完整连接配置,已有出站必须定义对应标签,不能把片段直接当成完整服务器配置导入。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
},
{
"type": "field",
"domain": ["domain:example.com"],
"outboundTag": "proxy"
}
]
}
}
示例中的 domain:example.com 表示匹配该域名及其子域名,不是用于验证实际业务连接的地址。direct 与 proxy 是出站标签,必须与实际配置中的标签一致;私有地址分类也需要内核能够读取相应规则数据。图形客户端可能自动生成标签与规则,使用其路由编辑器时应遵循当前字段约定,不要混合粘贴来自不同内核的语法。修改前保存旧规则,修改后先验证配置能启动,再测试命中行为。
DNS 解析与域名匹配相互影响
DNS 负责把域名解析为地址,但请求经过应用、本地系统和内核时,域名信息不一定始终保留。应用先自行解析,再只提交 IP,内核可能无法直接按原域名匹配;是否能恢复域名信息,还取决于接入方式与相关功能。选择 DNS 服务器也要考虑它本身如何被访问,不能把无法通过当前路径到达的地址设为唯一解析来源。域名打不开而已知连接仍可建立时,应先检查解析链路,不要直接认定协议不兼容。
FakeDNS 使用虚拟地址映射保存域名关系,需要与流量接入和域名恢复机制配合。它不是换一个 DNS 地址就能单独工作的功能,开启后也可能影响局域网服务、应用缓存与网络切换。首次安装不建议为了“设置齐全”就开启。确有域名分流需求时,先记录普通 DNS 状态,再按客户端支持方式配置并测试;出现问题时能够完整撤回。原理与边界可查阅FakeDNS 工作原理详解。
用最少变量验证分流
每次只验证一个目标应用和一种接入方式,确认请求进入内核后,再检查出口及 DNS。局域网访问异常时先查私有网段与名称解析,远程业务异常时再查协议和服务器连接。规则数据需要更新时,区分规则资源更新与订阅更新,两者不是同一个按钮。Xray 与 V2Fly 的配置能力也不完全一致,切换内核后应重新检查自定义规则;有关生态和功能取舍,可阅读Xray 与 V2Fly 内核区别,不要靠改名尝试兼容。
配置常见问题:按故障阶段定位
安装失败与内核失败分开处理
安装程序无法运行,先核对系统架构、包格式和安装器提示;图形界面能打开但启动服务失败,则转向内核日志。端口占用、文件路径不存在、权限不足和未知字段都可能使内核退出,但处理方向完全不同。日志中第一条明确错误通常比最后的失败汇总更重要。端口占用时先确认是否有旧实例或其他程序使用同一端口,再选择停止冲突程序或修改监听端口;修改后还要同步应用及系统代理设置,否则会产生新的连接失败。
出现未知协议或字段错误,先核对配置所需内核,不要随意删除报错字段。删除某个安全字段也许能让解析通过,却可能让连接行为偏离提供方要求。文件缺失则检查安装目录、资源路径和防护记录;权限错误应检查具体文件或网络操作,而不是一律提高整个程序权限。完整配置文件还要注意 JSON 语法,例如多余逗号、引号配对与字段类型。有关错误分类,可阅读v2rayN 内核启动失败日志诊断。
显示已连接,但网页打不开
“已连接”可能仅表示内核或系统接入接口启动,并不代表每个目标请求成功。先查看实际应用是否进入本地入口:桌面检查系统代理及浏览器独立代理,Android 检查 VPN 是否仍在运行和应用是否被排除。接着核对监听端口,再检查 DNS 与路由,最后检查远程连接。若日志完全没有目标请求,应先解决接入;若日志已经显示请求但连接超时,再检查出口、网络与服务器。不要跳过前面几步,直接把全部问题归结为远端失效。
只有部分网站失败时,可能涉及域名规则、解析结果、目标服务本身或所用传输,而不一定是整个客户端失效。用同一应用比较不同目标,再用另一个应用比较相同目标,可以区分应用设置与目标路径问题。测试时避免连续切换多个配置,给每次连接留出完成或报错的时间。系统代理、DNS 和路由的详细检查顺序见已连接却打不开网页排查清单;记录结果后再继续修改,避免形成互相覆盖的临时设置。
订阅失败、握手失败与时间问题
订阅更新失败先看请求路径与返回类型,远程连接握手失败则核对服务器地址、端口、用户标识、传输路径与安全参数。TLS 相关错误还应检查系统日期、时区和服务器名称字段,不能通过关闭验证来掩盖。配置要求的服务名、主机名与服务器地址不一定相同,应按提供方资料逐项填写;看起来相近的值不能凭经验替换。修改分享链接中的编码参数也容易破坏语法,优先重新导入完整原始链接,再与本地记录比较。
同一配置在另一台设备正常,只能说明远端在那个测试条件下可用,不能直接证明本机客户端存在缺陷。比较两台设备的内核、系统时间、接入方式、DNS、网络环境与应用筛选,尽量让条件接近。若只在特定网络失败,记录是否能访问订阅端点、具体报错及发生阶段。重装应该放在确认配置目录损坏或安装文件异常之后,不能替代对网络路径和内核报错的分析,否则重装后往往会再次导入同一个问题。
升级回退、恢复联网与有效求助
升级前导出配置,记录当前内核、接入模式和自定义路由。升级后先验证简单配置,再恢复额外功能。需要回退时,保留备份并核对旧程序能否读取新的配置格式,避免让不同程序交替写入同一目录。若客户端停止后全系统仍无法联网,先检查桌面系统代理是否残留,再检查 TUN、VPN 和手动 DNS 是否已撤销。Android 还要检查系统是否启用了在 VPN 不可用时阻断连接的策略;恢复时只调整与本次客户端相关的项目。
求助材料应包含平台、架构、客户端名称、所选内核、故障发生阶段、最后一次改动和去除敏感信息后的错误片段。说明是否只有一个应用失败、是否切换网络后发生、停止客户端后能否恢复,比只说“连不上”更容易定位。不要公开完整订阅、连接二维码或未经处理的配置文件。完成修正后,用同一套测试条件再次验证,再撤销已经无用的临时设置。需要重做最小连接流程时返回快速上手教程;需要查具体概念或常见表现时,再查FAQ,让安装、验证与排错形成闭环。