完整手册 · 从安装到维护

V2Ray 配置完整手册

第一次连接,先按快速上手教程完成导入和验证;需要弄清每个开关管哪一段流量,或想在现有配置上添加分流规则,再回到本手册。首次阅读建议按目录顺序操作,排查时可直接跳到出问题的阶段。

入口应用的请求怎样交给客户端
规则进入内核后怎样选择出站
验证用同一个请求确认改动结果
01 认识流量路径

核心概念:客户端、内核与节点

图形界面负责设置,内核负责连接

v2rayN、v2rayNG 和 v2flyNG 都是图形客户端。导入列表、选择节点、切换代理模式时,操作的是图形界面。实际监听本机端口、匹配路由规则、建立连接的,是客户端调用的代理内核。Project V 是这一类工具的项目背景;V2Fly 延续了 V2Ray 的开发,Xray 是从同源代码发展出的内核项目。共享一部分配置写法,不代表两者支持的功能完全相同。给同一个节点换内核后能否使用,要看节点需要的协议、传输方式和安全层是否都受支持。

因此,界面已经打开,只能证明图形程序启动了。点选节点后,继续看内核日志是否完成初始化、是否开始监听;安卓端则看启动后是否出现系统 VPN 状态。若日志在绑定端口时就报错,连接尚未走到远端,检查远端地址没有帮助。反过来,若日志已有入站请求并报告远端握手失败,此时再重装图形客户端,通常也解决不了节点参数或网络路径的问题。

用三个问题串起入口、规则和出口

第一,应用的请求怎么进来?桌面应用可能读取系统代理,也可能只认自己的代理设置;TUN 则在系统路由层把选定的连接送入客户端。第二,请求进来后怎么选出口?内核按规则检查目的地址、端口或网络类型,找到第一条匹配项。第三,选了出口之后发生什么?直连出站直接访问目标,代理出站先连接节点,阻断出站按配置丢弃或拒绝请求。这三步分别对应入口、决策和出站,不宜用一个“连接成功”概括。

例如,浏览器打开一个页面,聊天程序同时发消息。浏览器遵循系统代理时,内核可能记录页面的请求;聊天程序若忽略系统代理,它的连接可能根本没有进入内核。此时即使把客户端里的路由切到全局,聊天程序也不会因此开始使用代理。相反,同一个浏览器页面也可能请求多个不同域名,页面能打开并不代表其中的图片和接口都走了相同的出口。排查时要定位到具体请求,而不是只记录哪个窗口能打开。

节点、订阅与协议各自保存什么

节点保存一组连接参数,常见字段有远端地址、端口、身份信息、传输方式和安全层。节点名称只方便识别,名称里带地区或协议简称,不能替代字段核对。订阅是用于获取一组节点的地址;更新订阅会重新取回列表,不会自动为所有应用接管流量。即便订阅地址能访问,列表也能解析,当前选中的节点仍可能因认证失败或网络不可达而无法建立连接。这三个结果应当分开记录。

VMess 和 VLESS 都涉及用户身份参数,但二者对安全层和传输搭配的要求不同。VLESS 本身不提供加密,常与兼容的 TLS 或 REALITY 设置配合;REALITY 在这里是安全层选项,不是一个可以脱离出站协议单独使用的节点类型。Trojan 则使用自己的认证字段,不能把另一类节点的参数直接搬过去。遇到握手错误时,应先按提供方的配置核对,而不是仅凭名称修改协议或关闭证书验证。更多区别可查阅VMess 与 VLESS 基础对照。

02 按设备选型

客户端选型:桌面首推 v2rayN

先核对系统,再核对处理器架构

桌面设备先选 v2rayN,安卓设备先选 v2rayNG。v2flyNG 也是安卓客户端,适用于明确需要 V2Fly 内核,且已有节点配置与其兼容的情况。不要因为节点名称里写着 V2Ray 就据此认定只能安装某一款客户端。先确定设备能安装哪款软件,再检查该软件当前使用的内核能否处理所需的协议与传输,最后才比较界面习惯和管理方式。这样既能减少安装试错,也能避免把连接问题误判成平台问题。

平台客户端选包依据
Windowsv2rayN下载页提供 x64 桌面版与经典 WPF 版。
macOSv2rayNApple Silicon 选 arm64,Intel 选 x64。
Androidv2rayNG;v2flyNG 备选确认支持 arm64 时选对应包,也可按机型和系统条件选通用版。
Linuxv2rayN同时核对发行版的包格式和设备架构。

在 Windows 中,从「设置 → 系统 → 关于」查看系统类型,再与下载页包的架构对照。v2rayN 桌面版采用跨平台界面,经典 WPF 版保留传统 Windows 界面;用惯旧版菜单的人可以优先选 WPF。两版的菜单位置和某些设置项可能不同,不能据此推断同一个节点在其中一版会更快。在 macOS 中,从苹果菜单打开「关于本机」,看显示的是 Apple 芯片还是 Intel 处理器,再从两个磁盘映像入口选一个。

在 Linux 上,系统名称和机器架构是两个独立条件。使用 deb 软件包体系的发行版通常选 deb,使用 rpm 软件包体系的发行版通常选 rpm。再查看系统信息:x86_64 对应下载页的 x64,aarch64 对应 arm64。两个标记都对得上才开始安装。包格式正确但架构不符,通常会在安装阶段被拒绝;架构正确但软件源缺少依赖,也要回到发行版的包管理器处理,不能靠换节点解决。

安卓端比较内核,不只比较外观

v2rayNG 使用 Xray 内核,作为安卓端的起点;v2flyNG 使用 V2Fly 内核,适合已有明确兼容要求的用户。两款的下载入口各有 arm64 和通用包。多数近年的设备可选 arm64,但处理器具备某种能力不等于系统提供了对应的应用运行环境;系统信息不能确认时,可优先核对设备说明或选通用包。通用包在架构覆盖范围上更宽,不代表对节点协议的支持更多,也不替代系统版本要求。

若希望在两个客户端间做对比,不要同时开启它们的 VPN 服务。先在第一款中选定一个可复测的节点,记录网络和失败阶段,再断开它,用第二款在同一网络和同一目标上测试。若一款能导入分享链接,另一款能导入却无法握手,最有价值的记录是两边使用的内核与安全层设置,而不是两次分开测出的单个速度数字。部署前可在客户端对比页核对适用场景。

把客户端选择变成可复现的决定

建议为每台设备记下系统、架构、客户端和所用内核。多台设备接收同一个订阅时,不必要求各端菜单与规则完全相同;只要分别确认能导入、能选择兼容节点、能验证流量路径即可。给另一台设备迁移时,优先使用对应客户端的导入入口,不直接复制桌面程序目录到手机。若订阅含有多类节点,先挑一个明确兼容的节点建立连接基线,再逐个确认其余节点,不要用整个列表的表现判断某个客户端是否合适。

03 建立启动基线

安装与初次启动

桌面端先完成安装,再改网络设置

从下载中心选定平台和安装包。在 Windows 中,下载的是归档文件时,先完整解压到当前用户可写的目录,不在压缩包预览窗口里直接运行。若下载的是安装程序,按界面完成安装后,从开始菜单或安装位置打开 v2rayN。不要把新文件逐个覆盖到仍在运行的旧目录。旧版的托盘进程可能仍占用监听端口,或者仍在改写系统代理;同时打开两份程序会把安装问题和运行冲突叠在一起。

macOS 上打开磁盘映像,按映像窗口提示把应用放入「应用程序」,再从该目录启动,而不是长期从映像里运行。系统若显示限制,先读清提示,区分芯片架构不符、管理员策略与应用打开权限;受单位管理的设备应由管理员确认。Linux 上用系统的软件安装界面或包管理器打开对应软件包。若提示缺少依赖,记下具体包名和软件源状态,先解决依赖再重新启动;如果安装后没有出现窗口,则先查看系统应用菜单和运行提示。

桌面端打开后,先确认窗口能正常显示、设置能保存,菜单中的系统代理和 TUN 暂时都不要打开。旧环境迁移过来的设备,最好先查看系统代理是否仍指向已经退出的本地端口。若客户端报告端口占用,先退出旧客户端或停止已确认冲突的服务;确需更换本地端口时,应用内手动填过代理地址的地方也要一并更新。随手扩大监听范围并不能解决端口占用,还可能让局域网设备接触这个端口。

安卓端区分安装授权与连接授权

安卓安装时,系统可能要求为这一次打开安装包的来源授权。例如用文件管理器打开软件包,提示对应的就是该文件管理器,而不是客户端本身。根据系统界面完成安装后,可回到原设置关闭这项来源授权。若提示不能安装,先区分架构不符、设备策略限制和已安装同名应用的更新冲突。涉及旧应用数据时,先确认手头有可重新导入的配置;不要把卸载当成第一步,因为节点分组和手工规则可能随应用数据一起清除。

首次启动连接时,系统弹出的 VPN 请求属于建立连接的授权,与安装时的来源授权是两回事。建议等节点导入并选好以后再授权,便于把启动结果和具体节点对应起来。如果设备已有其他 VPN,先查看哪个应用占用系统入口,确认是否可以断开,再切换。设备存在始终开启的 VPN 或组织管理策略时,不应反复点连接碰运气;先查看系统设置,再确认当前客户端是否按策略允许启动。

初次启动应留下哪些记录

把安装完成、界面启动、内核启动分开记录。没有导入节点时,客户端不一定需要启动用于远端连接的内核;这一阶段只需确认界面和设置可用。导入后再观察内核日志,记下配置解析、本地监听、远端连接这三类信息中最先报错的一项。错误出现的顺序通常比错误条数更重要:启动配置解析失败以后,下面跟着的退出消息只是结果,不必逐条单独处理。

如果是在旧设备上重新安装,先恢复一条已知节点,不急着恢复所有路由、DNS 和应用名单。恢复后分别测试窗口能打开、节点能选中、关闭代理后原有网络能照常访问。若其中一步失败,就停在当前步骤排查。特别是受管理的桌面环境,不要为了验证一次连接就上调全局权限;只有明确需要写入系统路由或启动相应服务时,再查看客户端提示和设备策略。

04 获取与选择节点

订阅与节点导入

先区分订阅地址和单节点分享链接

订阅地址通常以 https:// 开头,更新时由客户端访问并解析服务器返回的内容。复制到手的是一个地址,不是已下载的节点列表。vmess://、vless:// 等前缀通常表示单节点分享链接,应该用剪贴板导入或扫码入口。Base64 是常见的编码形式,不是节点协议,也不等于加密:有的订阅返回整批编码后的分享链接,有的单节点链接也会编码参数。判断往哪里粘贴,应先看提供方标注的用途,再看链接前缀。

从聊天窗口或邮件复制地址时,检查是否混入引号、全角标点或换行。尤其不要丢掉查询参数:同一个路径带不同参数,可能返回不同的订阅内容。订阅地址可能带访问凭据,即使不认识参数名,也应当把完整链接当成私密信息处理。不要交给不受信任的转换页面,不要贴进公开的日志、截图或故障反馈。确需请别人判断格式时,只提供链接类型、错误类别和已经遮蔽的字段。

桌面和安卓分别从哪里打开入口

在 v2rayN 主窗口打开「订阅分组」,进入分组设置并添加条目。给分组起一个便于识别的名称,把订阅地址填入地址栏,保存。回到主窗口后,从订阅菜单选更新当前分组;若菜单提供“不通过代理”和“通过代理”两类更新方式,初次设置时通常从当前可用的网络直接更新。更新结束后,切回刚添加的分组,确认列表中有记录,再选定一个节点作为活动配置。新增分组和更新分组是两个动作,只做前一个不会自动得到列表。

在 v2rayNG 主界面打开菜单,进入「订阅分组设置」,用新增按钮填写分组名和订阅地址,保存后回主界面执行「更新订阅」。再切换到对应分组、点选节点,然后用主界面的连接按钮启动。v2flyNG 也应把订阅填进分组设置,而不是填进单节点的地址或端口栏。导入单节点时,则在添加菜单选择从剪贴板或扫码导入。界面文字会随版本和语言配置变化;若找不到完全相同的菜单名,可用订阅导入入口对照核对操作所在的区域。

列表为空时,按结果分三层排查

第一层是获取失败。日志若提示超时、名称解析失败或访问被拒绝,先确认地址是否复制完整、订阅权限是否有效,以及当前网络能否访问该地址。已有可用代理时,可以对照经代理更新的结果;从未建立过可用连接时,不应让更新依赖尚未工作的节点。第二层是取到了响应但没解析出节点。订阅链接可能返回登录页、错误说明或客户端不识别的格式。能打开一个地址,不代表返回内容一定是节点列表,必要时向提供方确认订阅格式。

第三层是解析成功但当前视图为空。先退出搜索,检查正在查看的分组,再核对更新的是当前组还是另一个同名组。若更新后活动节点消失,重新选择仍在列表中的节点,不要凭原有名称猜测参数没有变化。自己调好的单节点可保存在独立分组,避免订阅重建时混在更新范围内。只要列表出现记录,就可以结束订阅获取层的排查;节点能否成功连通,应在下一轮测试里单独确认。

05 明确流量入口

代理模式:接管范围与实际验证

桌面端先用系统代理做小范围测试

在 v2rayN 选中活动节点后,打开托盘菜单中的系统代理选项;若当前桌面没有托盘入口,则从主窗口查找对应控制项。选择设置系统代理后,系统提供的代理地址会指向客户端本地监听。浏览器等遵循系统代理的应用通常会使用它;自带代理配置、绕过系统网络设置或使用其他网络机制的应用则未必会跟随。先用一个明确读取系统代理的浏览器发请求,再根据需要为单个应用设置代理,不必一开始就接管整台机器。

应用手动配置时,从客户端设置或日志确认本地监听是 HTTP、SOCKS 还是混合端口,并按应用支持的类型填写。地址通常用本机回环地址,端口以实际监听为准,不能照抄某个截图里的数字。把 SOCKS 类型填进只接收 HTTP 代理的输入框,会在本地环节失败,即使远端节点正常也无济于事。若应用提供“通过代理解析主机名”一类选项,还应记录其状态;连接交给了代理,不代表名称解析也一定由代理处理。

退出前需要清除的是此次设置的系统代理,不是别的程序或管理员原本配置的网络策略。切换前可记下旧设置;恢复后再打开同一个应用看是否重新使用原来路径。关闭 v2rayN 后浏览器仍提示无法连接代理时,检查系统中是否遗留指向本地端口的条目,也检查浏览器是否单独保存了一套代理设置。仅修改其中一处,有时不会影响应用实际采用的配置。

不要把“系统代理”和“全局路由”当成同一个开关

系统代理决定哪些应用会把请求交给本地监听;全局、分流或直连等路由选择,决定已经进入内核的请求走哪个出站。两个设置可以同时存在,也可以各自改变。比如系统代理已打开、分流规则把某个站点送去直连,这个请求依然经过了内核,只是没有经过远端节点。反过来,客户端选择全局代理,也不能让一个完全不理会系统代理的应用突然改走本地监听。记录设置时,分别写下入口方式与路由策略,比只写“开了全局”更清楚。

在安卓端,v2rayNG 和 v2flyNG 的常规连接依赖系统 VPN 来接收流量,应先在主界面选择节点,再点连接,按需确认系统授权。是否让某个应用参与连接,要看客户端的应用名单和名单模式。允许名单与排除名单正好相反:前者只接管选中的应用,后者把选中的应用留在原路径。若浏览器能用而另一个应用没有反应,检查名单与重连后的实际状态,比直接换协议更有效。

用一个请求对照三种结果

选一个有权访问、响应稳定的测试目标。先在未接管时打开一次,记下目标是否本来就可访问;打开系统代理或安卓连接后,再对同一目标发起新的请求。不要只看浏览器中仍显示的旧页面,缓存和已建立的连接会妨碍判断。查看新日志是否出现相应的目标、是否命中了预期出口。没有入站记录时查应用设置和监听;有记录但出口不符时查分流;出口符合却返回超时或握手错误时,再看远端连接环节。

单次测试只改变一个开关。测试不同代理模式时,节点、目标和当前网络保持不变;测试节点时,则保持代理模式和目标不变。做完一次对照后记录先后的结果,再决定是否保留这项设置。这样即使后来切到新的网络,也可以快速复查是入口行为变了,还是节点在新网络中的连通性发生变化。

06 编写与验证规则

路由分流:规则顺序与出站标签

先安排匹配顺序,再填条件

V2Ray 系内核通常从上到下检查 routing.rules,命中第一条可用规则后就选择其出站,不再用下一条修正。因此,单个服务的例外应放在覆盖它的宽泛规则之前。客户端界面中的“直连”“代理”“阻断”是便于操作的名称;配置里的 direct、proxy、block 则是出口标签,标签必须指向实际存在的出站条目。尤其不要假定“没有匹配”就会直连:在这类内核的常见配置中,未匹配流量由第一个出站处理。

在 v2rayN 可从设置里的路由设置进入规则管理,先复制当前策略或备份,再新增一条域名规则。若界面提供上下移动,调整规则顺序后还要确认编辑的是当前启用的策略。安卓客户端若提供自定义路由或分流设置,应先看界面接受的是域名列表、规则项还是整段配置;这些输入不能混用。客户端生成的配置可能在重启或切换节点时重写,日常修改应尽量落在图形界面保存的规则上,而不是只改临时的内核文件。

规则片段:只用示例域名测试匹配

以下是核心配置中 routing 的完整片段,可用于支持该语法的自定义配置。它不是完整节点配置。合并时保留已有入站和节点出站,并确认 outbounds 里分别有标签为 block 的阻断出站和标签为 direct 的直连出站;在支持下列写法的内核里,它们通常分别由 blackhole 和 freedom 实现。不具备相应出站时,先在图形界面设置等价规则,不要直接粘贴。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:blocked.example.com"],
        "outboundTag": "block"
      },
      {
        "type": "field",
        "domain": ["domain:example.com"],
        "outboundTag": "direct"
      }
    ]
  }
}

第一条只匹配一个完整主机名;第二条覆盖示例主域名及其子域名。在第一条先命中的前提下,该子域名走阻断,主域名和其余匹配的子域名走直连。如果调换顺序,先出现的后缀范围就会盖住精确例外。测试第一条时,不应把该示例子域名本来就无法解析,误判为阻断成功;应看日志中的匹配结果,或在自己管理且确定可解析的测试域名上做同样的前后对照。其他非匹配流量仍取决于保留下来的规则和默认出站。

判断请求交给内核的是域名还是地址

AsIs 不会为了让域名目标匹配地址规则而主动解析域名。若应用在交给代理之前已自行解析,只把数字地址传给内核,普通域名规则就可能匹配不到。启用协议嗅探时,内核在支持的流量上有机会取得域名,但并不是每种加密连接都能提供主机名,也不应该把它视为补全所有请求信息的办法。先用能传递域名的应用验证规则语法,再决定是否需要为实际应用增加地址规则或调整解析路径。

如果要加入地址段或地区数据集,先确定内核会在什么条件下触发 DNS 解析,再核对该数据集是否存在以及实际包含哪些地址。一个网站可能同时使用主站和静态资源域名,也可能随网络环境解析出不同地址。遇到“主页直连、图片失败”的情况,先比较各个请求的目标与命中项,再决定是否增加针对性规则。不要为了修一个资源,直接把所有地址或整个共享后缀划进同一出口。

07 按需扩大接管范围

TUN 模式:虚拟接口、DNS 与回退

什么时候值得启用 TUN

TUN 使用虚拟网络接口与系统路由来接收流量,不要求每个应用都提供代理设置。它适合处理明确不遵循系统代理、却需要按指定路径访问的应用。TUN 也并非自动接管所有流量:匹配哪些接口、地址族和目的网段,仍取决于路由和客户端选项。对于浏览器和少数支持代理的应用,系统代理或应用内代理通常更容易验证。先确认需求来自应用入口,不要为了修复节点认证错误或订阅格式问题去开 TUN。

在 v2rayN 先保持一个已通过系统代理测试的活动节点,再查看主窗口或托盘的 TUN 选项。允许客户端按需创建虚拟接口或写入路由前,先记录当前代理和网络状态。若系统要求提升权限,按客户端提示与本机管理策略操作;不要用其他提权方式绕过限制。首次启用时建议关闭这次测试单独设置的系统代理,以免浏览器继续走原有端口而掩盖 TUN 的结果。随后先测试此前正常的目标,再专门测试不跟随系统代理的目标应用。

安卓客户端常规连接已通过系统 VPN 接收流量,不需要寻找一个和桌面启动方式完全同名的开关。应检查系统 VPN 状态、应用名单、是否允许相应应用参与连接,以及是否开启始终连接或断开时阻止网络的选项。若系统同时有别的应用占用 VPN,先确认连接是否被替换。应用名单改动后按界面提示重连,再用实际应用验证,不能只凭名单上的勾选推断当前连接已经应用了改动。

把 DNS 和路由冲突分开处理

如果 TUN 打开后同一目的地址可访问但域名访问失败,优先检查名称解析:查询送给了系统、客户端还是应用自带的解析器,返回的是哪类地址,之后走哪个出口。浏览器启用独立解析时,结果可能与系统工具不同。若域名能得到响应而连接仍超时,则再看返回目标使用的是 IPv4 还是 IPv6、该地址是否走进虚拟接口、出口是否可达。不要一次把系统 DNS、客户端 DNS 和应用解析方式都换掉,那会失去对照基线。

启用后原本可用的打印机或本地服务失联,先查看是否接管了局域网目的地址,以及是否有“绕过局域网”或等价的排除选项。网络上若还有企业 VPN、其他虚拟网卡或容器网络,检查它们是否使用重叠网段。代理节点的连接本身也必须经可用的底层网络发出,不能循环进入自己创建的接口。遇到一开启就重复连接远端的现象,先停用 TUN,看同一个节点直连底层网络是否恢复,再核对既有路由设置。

从基础连接开始逐项确认

第一次开启后,用一项普通网页请求验证入口,再分别测试局域网访问与确有需要的应用。若只有语音、视频或其他可能使用 UDP 的功能异常,不能因为普通网页正常就判定整个路径无误。检查是否允许相应流量进入接口、出站是否支持它,以及远端是否能处理;必要时分别在启用和停用状态下做同样的测试。若网络切换后才失效,从当前默认网络、接口状态和客户端日志着手,不急着重写分流策略。

回退时先断开 TUN 或停止安卓连接,再通过系统网络设置查看原有网络是否恢复。此前保留的系统代理若仍然指向关闭的监听端口,应按记录恢复;设备若仍有别的 VPN,也要确认它的状态。回退成功后再试一次普通请求,并记录是关闭 TUN 就恢复,还是还需恢复代理或接口设置。留下这个区别,下次才能有针对性地修改一项设置。

08 保留可复测基线

日常维护:更新、备份与分层排查

订阅、客户端与内核分开更新

订阅更新改变的是节点列表,客户端更新可能改变界面与配置生成方式,内核更新则可能改变支持的字段或连接行为。不要把三类更新安排在同一次排查里,否则更新后即使能复现故障,也很难指出是哪一层变化。更新订阅后,先确认当前分组和活动节点;更新客户端后,先确认原配置能读取;更新内核后,用现有节点验证最常用的协议和出站。每次只完成一项,再做一次同目标测试。

备份优先使用当前客户端提供的导出方式;若需复制桌面端的数据目录,先退出程序,确认要复制的是配置位置而不是随手找到的安装目录。至少确认备份是否包含订阅分组、本地节点、自定义路由、监听端口与应用名单;某些设备级授权和系统代理设置并不在应用备份里,应另外记下。不要把未经筛查的配置放到共享目录:其中可能包含节点身份参数和订阅地址。恢复前先看备份与客户端的兼容性,再用一条已知节点验证。

按错误发生的阶段缩小范围

先分辨“所有应用不通”和“一个应用不通”。如果只有一个应用异常,检查它是否实际进入客户端,有没有自己的代理、解析方式或安卓应用名单。若所有测试应用都异常,确认客户端进程在运行、本机监听或系统 VPN 已建立。下一步看日志里有没有入站记录;若没有,回到代理入口设置;若有,先检查命中出站,再看远端连接是超时、认证失败还是握手失败。

现象先查看下一步
配置不能启动首条解析或绑定错误回到上一份可启动配置,再单独恢复改动。
应用没有入站记录本地监听、应用代理设置、VPN 名单用明确走代理的应用重新发起请求。
访问出现部分异常失败请求的主机名和出站标签对照成功请求,找出不同的规则或解析结果。
新旧节点都慢当前网络、目标服务和接管方式固定一个目标,用同一应用分时段复测。

远端握手失败时,优先核对当前节点所需的地址、端口、传输类型、安全层和身份参数;某些协议或认证还依赖设备时间,日期明显不准时先恢复正确时间。不应通过关闭证书验证把报错变成表面成功。若表现只是速度慢,区分首次打开的等待与持续传输缓慢:前者可能集中在 DNS 和握手阶段,后者常需对照网络质量和目标服务。一次延迟探测也不能代表实际吞吐,可按速度慢排查清单做分层比较。

常见问题:有图标、有列表,为什么仍失败

VPN 图标出现,为什么某个应用没有走预期出口?

图标表示系统 VPN 已建立,不代表每个应用都在接管范围内。先核对名单模式和目标应用是否在正确范围,再重新发起请求。若内核已有该请求的入站记录,查询路由命中项;此时问题不再是 VPN 开关。

更新订阅后节点还在,为什么连不上?

更新成功只证明列表被取回并识别。先确认活动节点是否重新选定,再看失败出现在名称解析、远端连接还是认证阶段。若只有一个节点失败,优先对照同网络下另一个同类节点的结果,不必重置整套设置。

排查结束后,关闭临时开启的详细日志,并保存能说明问题的一小段记录。反馈时只需给出客户端、系统、入口方式、首条错误和可重复的触发步骤。把订阅地址、各节点的认证字段及不必要的目标地址遮蔽后再分享。这样别人能复查路径上的问题,也不会把无关的连接记录带进讨论。

09 从单机扩展配置

进阶路线:规则维护、局域网与部署边界

先把个人规则写成可维护的策略

当单台设备已经稳定运行,再为常用场景拆分策略。例如把工作环境与个人环境分成两套,由各自的确切业务需要决定直连、代理或阻断。每套保留一份简短记录:默认出口是什么、哪几条属于例外、为何按现有顺序排列、用哪个目标验证。对一条规则变更,先做单条试验,再合入日常策略。遇到问题先撤掉刚加入的规则,不用在很多相互覆盖的匹配项里同时猜测。

规则和节点分开管理。来源不同的节点在字段支持上可能有差异,但同一套直连例外通常不必为每个节点重复填写;同样,一处应用入口异常也不应靠调整全局规则补救。若要比较不同内核的行为,使用同一测试目标和兼容节点,保留同一套可对照的条件时再切换。发现某个参数只在一边可用,应记录这个依赖,不把它装进给所有设备共用的模板。

给复杂配置留一份小型回归清单。至少包含一个应直连的服务、一个应经代理的目标、一个自己管理的阻断样例和一个局域网服务。改动后按这一顺序检查,并把浏览器缓存和应用名单考虑进去。某个测试项失败,就先查该项进入了哪个入口、匹配了哪条规则,而不是把整个策略改回全局。规则较多时,给列表写简短说明比记忆顺序可靠;过期的业务规则应删除,避免后来掩盖真正要匹配的新规则。

共享本地代理前,先限定可访问的设备

只有同一受信任局域网中确有设备需要共用桌面客户端时,才考虑 v2rayN 的「允许局域网连接」。它改变的是本地监听能否从其他设备访问,不是让整个局域网自动获得代理。使用端仍需要支持相应代理类型,且应填写桌面设备的局域网地址和实际端口;回环地址指向的是使用端自己,填过去不会找到桌面设备。先确认双方处在允许互访的网络,再按v2rayN 局域网代理共享说明配置一台受控设备做验证。

共享时要把监听范围、防火墙范围和使用对象分别考虑。只允许需要的设备和网络配置访问端口,不做公网端口转发,也不在来宾网络或公共网络上保留共享监听。先确认客户端是否要求认证,不要把“连得上”理解成“只有预定设备能连”。测试结束后关闭共享监听;如果保留为长期服务,应定期复查桌面地址变动和防火墙规则,确认未扩大访问范围。

网关部署先验证回退,不直接改全网

把能力扩展到软路由或 Linux 小主机后,问题不再只是客户端按钮,而是网关、名称解析和流量转发的责任划分。先画出一台测试设备的请求路径:谁提供默认网关,谁回答 DNS,代理节点的连接经谁发出。如果仅调整 DNS,未变更设备的流量入口,就不能据此期待全部连接进入代理。反之,只改变网关而遗漏名称解析或地址族,也可能造成部分设备上网正常、另一部分服务异常。可先阅读旁路由部署思路概览,判断是否需要这样的拓扑。

从一台自有测试设备开始,不直接改整个网络的自动分配设置。事先记下如何恢复原网关与解析器,并验证恢复后局域网服务和常用请求都能工作。测试稳定后再考虑其他设备,而且要为需要保留原网络路径的设备单独留出方案。若需求只是让一台应用经指定出口访问,继续使用应用内代理或现有桌面配置往往更便于维护。判断进阶方案是否合适,关键在于能否解释每段路径、限制影响范围,并在失败时回到上一套已验证的设置。

下载v2rayN