安装大全 · 系统查阅手册

V2Ray 全平台安装配置

按系统查安装,按现象查设置。桌面端首推 v2rayN;Android 先选 v2rayNG,已有 V2Fly 配置时再评估 v2flyNG。

首次使用可先走完使用文档的快速上手主线。本页补充安装包选择、权限边界、配置迁移和故障分支,适合遇到具体问题时查阅。安装文件统一从客户端下载页按平台选择。

准备系统与连接资料

确认系统、架构与客户端职责

先记录操作系统、处理器架构和当前账户权限,再下载安装包。桌面平台使用 v2rayN,Android 使用 v2rayNG 或 v2flyNG。客户端负责显示服务器列表、保存订阅、生成配置和管理代理入口;内核负责协议连接与流量转发。装好客户端并不代表已经取得可用服务器,服务器资料需要单独准备。也不要把另一个系统上的程序目录直接复制过来,界面文件、内核可执行文件和授权方式可能不同。

在系统信息中区分处理器架构,不按设备外观判断。搭载 Apple 芯片的 Mac 选 Apple Silicon,Intel Mac 选 Intel;Windows 本页下载入口对应 x64;Linux 同时核对架构与软件包格式。Android 主流设备通常使用 arm64,但较旧设备仍应查清系统支持的架构。位数与架构不匹配时,安装失败属于软件包选择问题,不应先修改网络、订阅或服务器参数。

整理订阅与服务器参数

准备服务提供方给出的订阅地址,或一条完整的服务器分享链接。订阅地址用于获取服务器清单,不是普通网页地址,也不等于账号后台登录页。手动配置则需要服务器地址、端口、协议、认证信息和传输参数;使用加密传输时,还可能需要服务器名称、路径、公钥或指纹等字段。缺少其中一项时先回到原始说明,不用相似字段替代,更不要通过反复切换内核猜测参数。

将订阅视为访问凭据。复制时避免选入首尾空格、换行、聊天软件附带的标点和说明文字。不要把完整地址发到公开讨论区,也不要上传含地址栏的截图。设备迁移前保留配置备份,并区分“客户端设置备份”和“服务器分享链接”:前者可能包含分组、路由和界面选项,后者往往只有单个连接。分享故障日志前,同样检查服务器域名、账户标识和订阅参数。

检查项记录内容影响范围
系统与架构系统版本、x64 或 arm64安装包能否运行
管理员权限能否批准网络与提权请求TUN、驱动及部分代理设置
连接资料订阅地址或完整分享链接服务器导入与认证
已有网络工具代理、虚拟网卡、工作网络连接端口、路由与 DNS 冲突

建立可恢复的首次配置

安装前先确认系统在未启用代理时能够正常访问常用网站,并记录当前网络接口的代理状态。暂时退出其他会修改系统代理或虚拟网卡的程序,不必删除它们。工作或校园设备可能由管理策略控制网络设置;遇到无法修改的选项,应确认管理权限,不能把所有受限状态都归因于客户端。保持系统日期、时间和时区正确,证书验证及部分协议认证都依赖准确时间。

首次验证只保留一个客户端、一个服务器和一种流量接管方式。先用系统代理检查浏览器,再考虑 TUN。每次只改一项,记下修改前后的现象;同时改端口、路由和 DNS,会失去定位依据。退出测试前恢复代理设置,避免留下指向已关闭程序的本地端口。如果后续安装失败,保留错误原文和操作路径,比只记录“不能用”更容易区分下载、权限与连接问题。

安装 Windows 版 v2rayN

选择桌面版或经典 WPF 版

进入Windows 下载区,先看系统架构,再选择桌面版或经典 WPF 版。桌面版采用新一代跨平台界面,经典 WPF 版保留熟悉的 Windows 界面,两者都用于管理代理连接。不要把界面差异理解为服务器质量差异。首次安装先选定一版完成配置,确实遇到界面兼容问题再更换;并排运行两个实例容易争用本地端口,也会让系统代理的最后写入来源难以判断。

运行安装程序时,按提示选择可写入的位置。若系统显示来源或权限提示,先确认文件来源与发布者信息,再决定是否继续,不要关闭整个系统的安全防护。启动时若出现运行环境缺失的明确提示,按照该安装包的要求补齐对应运行环境。程序完全打不开时先排查安装和环境,能打开但内核启动失败时再检查日志,两种情况不能用同一套网络设置解决。

导入订阅并选定服务器

打开主窗口,在“订阅分组”中进入“订阅分组设置”,添加分组,填写备注与地址后保存。首次保持过滤关键字为空,避免把全部服务器筛掉。回到主界面,执行“更新订阅(不通过代理)”;若订阅服务明确需要代理访问,并且已有可工作的连接,再执行“更新订阅(通过代理)”。通过代理更新需要现成通路,不能依赖尚未成功导入的服务器来建立自身连接。

更新后确认分组内出现服务器,再将目标项设为活动服务器。具体菜单位置随界面版本有所调整,以实际显示的“设为活动服务器”操作为准。测试结果只反映当时的探测条件,不等于网页、视频和下载都已通过。先打开一个常用加密网页,再观察客户端日志是否有对应连接。遇到认证失败应检查原始资料;遇到超时再区分服务器不可达、本地防火墙和路由选择问题。

配置系统代理,再评估 TUN

在托盘菜单中选择“自动配置系统代理”,让遵循 Windows 系统代理的应用使用客户端的本地入口。选择“清除系统代理”会撤销该入口;选择“不改变系统代理”则保留现有状态,并不负责清理旧地址。修改后可到“设置 → 网络和 Internet → 代理”核对,重点看是否仍指向已经关闭的程序。浏览器扩展、应用自带代理和单位管理策略可能覆盖系统设置,需要分别检查。

需要覆盖不读取系统代理的应用时,再开启“TUN 模式”。根据客户端提示完成提权或相关组件安装,不要仅因出现权限窗口就认定失败。开启前关闭其他虚拟网络接管工具,保留管理员授权提示的错误原文。若开启后所有网络都中断,先关闭 TUN,确认系统恢复,再检查虚拟网卡、路由及 DNS。不要一边保持故障 TUN,一边不断改浏览器代理,这会叠加两条不同的故障路径。

处理端口占用与退出残留

出现“地址已被使用”一类启动错误时,先退出重复实例,再查看本地监听端口。以下命令仅用于查找进程号,端口要替换为客户端设置中的实际值。找到进程后,在任务管理器核对程序名称;不要直接结束不认识的系统进程。也可以在客户端选择另一个未占用端口,但要同时更新依赖旧端口的应用设置。

netstat -ano | findstr :10808

正常退出前先关闭 TUN,再清除本次设置的系统代理。若程序异常关闭后浏览器无法联网,优先检查系统代理是否仍指向回环地址,而不是立即重装客户端。升级前保存订阅与必要设置;升级后先测试旧配置能否加载,再逐项恢复自定义路由。安全软件拦截时查看具体事件和文件路径,不把整个磁盘加入排除范围,也不通过反复移动安装目录来掩盖原因。

安装 macOS 版 v2rayN

按芯片选择安装文件

打开苹果菜单中的“关于本机”,查看“芯片”或“处理器”。显示 Apple 芯片时选择 Apple Silicon,显示 Intel 时选择 Intel。进入macOS 下载区获取对应磁盘映像,打开后按安装界面的提示将应用放入“应用程序”。完成复制后弹出磁盘映像,再从“应用程序”启动。始终从映像内运行会让应用位置不稳定,也容易混淆后续授权所对应的程序副本。

首次启动若受到系统安全机制阻止,先读清提示内容。确认来源后,可在“系统设置 → 隐私与安全性”查看是否提供针对本次应用的打开选项,再按系统流程批准。只有系统明确允许继续时才执行,不要批量移除其他文件的安全属性。出现“应用已损坏”也不能直接推断为代理配置错误,应先重新获取匹配架构的安装文件,确认复制完整并检查系统兼容要求。

添加订阅并核对托盘菜单

启动 v2rayN,打开主窗口,在“订阅分组设置”中添加备注和订阅地址。保存后执行“更新订阅(不通过代理)”,确认列表中出现服务器,再设为活动服务器。已有可用连接且直连更新失败时,才尝试“更新订阅(通过代理)”。Mac 菜单栏图标用于显示主窗口和切换代理选项,图标存在只说明程序在运行,不代表服务器认证或系统代理已经完成。

在菜单栏托盘菜单中选择“自动配置系统代理”。系统可能要求授权修改网络设置,按提示输入本机有相应权限的账户信息;不要输入订阅服务的账号密码。随后进入“系统设置 → 网络”,选择当前使用的网络服务,在“详细信息 → 代理”中核对设置。无线网络和有线网络属于不同服务,从一种连接切到另一种连接后,应重新确认当前接口的代理状态。

区分系统代理授权与 TUN 授权

系统代理主要影响愿意读取系统设置的应用。某个终端程序或独立应用没有走代理,并不说明浏览器的系统代理失效。先检查该应用是否有单独的代理选项,再决定是否使用 TUN。开启“TUN 模式”时,客户端可能需要额外的管理员权限来创建网络接口或修改路由。系统代理授权成功,不等于 TUN 所需的权限也已经准备完毕,两项应分别验证。

批准请求前核对申请者确实是刚安装的客户端,并按提示完成必要步骤。若管理员密码正确但仍失败,检查当前账户是否受设备管理策略限制,以及其他网络软件是否正在接管流量。关闭 TUN 后若网络恢复,说明问题集中在流量接管路径;此时保留普通系统代理用于对照,不要同时修改服务器认证字段。工作网络已有专用连接时,应先了解两者的路由优先级再叠加使用。

处理睡眠唤醒与切换网络

Mac 从睡眠恢复、切换热点或重新连接无线网络后,原有连接可能需要重建。先确认系统网络已取得地址,再尝试重新选择服务器或重启客户端的连接功能。若只有某个应用失败,完全退出该应用后重开,避免沿用旧连接。若全部应用失败,关闭 TUN 与系统代理进行直连对照。不要只凭托盘图标仍存在,就跳过底层网络是否恢复这一项。

退出客户端时,先关闭 TUN,再选择“清除系统代理”,最后退出程序。“不改变系统代理”只保持当前状态,不会自动撤销遗留入口。若异常退出后不能浏览网页,回到当前网络服务的代理页面检查回环地址和端口。更换应用副本或升级后若再次出现授权提示,应核对正在运行的路径,避免“下载”目录和“应用程序”中各有一份,导致授权给旧副本、实际启动新副本。

安装 Linux 版 v2rayN

核对架构和软件包格式

进入Linux 下载区前,先确认处理器架构与发行版的软件包体系。x64 和 arm64 对应不同程序文件;deb 与 rpm 对应不同包管理方式,不能仅凭文件名中都有 Linux 就混用。常见 Debian 系发行版选择 deb,使用 RPM 软件包体系的发行版选择 rpm。若不确定,先打开系统信息与软件管理器查看发行版名称,再使用下方命令确认机器架构。

uname -m
cat /etc/os-release

输出中的 x86_64 通常对应 x64,aarch64 通常对应 arm64。其他架构不能直接套用本页的安装入口。桌面客户端需要可用的图形会话,只有命令行的服务器环境不属于这里的图形安装流程。远程桌面、精简桌面或容器内的图形环境还可能缺少托盘及权限服务,安装包能被包管理器接受,并不能证明桌面集成条件全部具备。

通过软件管理器完成安装

下载匹配的软件包后,优先用发行版的软件管理器打开,查看依赖、安装位置和授权提示,再执行安装。出现依赖缺失时,保留包管理器的完整错误,按当前发行版的方式处理;不要从其他发行版复制共享库,也不要把不同架构的库软链接到一起。安装后从应用菜单启动客户端,以普通用户运行图形界面,只有明确需要的网络操作才按提示提权。

如果应用菜单已经出现入口,但点击没有窗口,先确认是否缩到了托盘,再检查当前桌面是否显示托盘图标。部分桌面环境默认不展示此类图标,应通过桌面自身的设置或兼容组件处理,不能因为看不到图标就重复启动多个进程。需要从终端观察启动错误时,使用实际安装的可执行路径,不凭其他发行版的目录猜测。日志中的图形库错误与订阅更新错误属于不同阶段。

导入订阅并确认桌面代理范围

在“订阅分组设置”添加地址,保存后更新订阅并设定活动服务器。先不增加服务器过滤条件,确保原始订阅能被解析。随后尝试“自动配置系统代理”,并在桌面网络设置中核对代理入口。Linux 不同桌面对代理设置的存储和读取方式不同,某些应用只读自身设置,某些命令行程序只读环境变量,因此“桌面代理已设置”不能直接等同于“所有程序已接管”。

遇到浏览器可用而软件管理器不可用时,先看软件管理器是否需要独立代理配置,以及后台服务是否继承用户会话设置。不要把本地监听地址改成对所有网络接口开放来解决本机应用问题;这可能扩大访问范围,却不改变应用是否使用代理。确需命令行代理时,按应用支持的协议设置,并在同一终端会话内测试。关闭终端或撤销变量后,影响范围也会随之变化。

配置 TUN 并处理权限分支

需要更广的流量接管范围时,再在客户端开启 TUN,按当前发行版与客户端提示完成权限设置。虚拟网络接口、路由和 DNS 操作通常需要额外权限,不能通过长期以管理员身份运行整个桌面会话来替代。若开启失败,先检查日志是否明确指向权限不足、接口创建失败或辅助组件不可用,再选择对应处理路径。只有错误信息需要时才检查内核提供的 TUN 设备。

成功开启后,用同一网站和同一应用进行前后对照。若出现局域网访问中断,检查路由是否误接管本地网段;若只有域名失败,检查系统解析服务与客户端 DNS 的配合。已有工作网络、容器网络或虚拟机网桥时,先保存现有路由信息。退出前关闭 TUN 并恢复桌面代理;升级时保留用户配置备份,避免把旧可执行文件与新安装目录中的组件混在一起运行。

安装 Android 客户端

选择 v2rayNG 或 v2flyNG

打开Android 下载区,优先选择采用 Xray 内核的 v2rayNG。已有面向 V2Fly 的配置或需要对照其行为时,再考虑 v2flyNG。两款应用的内核取向不同,不代表所有配置能够原样互换。尤其是 REALITY、XTLS Vision 等涉及特定内核特性的连接,应先核对客户端支持情况;不能仅看分享链接成功导入,就认定底层参数已被完整识别。

通常先选择 arm64 安装包;不确定设备架构或安装提示不兼容时,再核对设备信息并评估通用版。通过系统文件管理器打开安装文件,按提示允许当前来源执行本次安装。安装完成后可撤销该来源的安装权限,避免把临时操作长期保留。若系统提示签名冲突,先确认是否已有另一来源的同名应用,保存原配置后再处理,不要直接卸载导致订阅和路由全部丢失。

导入资料并更新订阅

打开客户端,使用“订阅分组设置”或当前界面的订阅管理入口,添加备注和完整订阅地址,再执行更新。若只有单条分享链接,可使用从剪贴板导入的操作;二维码导入需要相机权限,只在使用该功能时批准。订阅获取失败时先检查地址是否被输入法插入空格,是否复制成网页标题,以及链接是否过期。切换无线网络与移动网络可以帮助判断订阅地址的直连可达性。

列表更新后选中一项服务器,再启动连接。延迟测试与实际联网分开检查:部分测试会依赖当前活动连接,部分只测试服务器端口,结果不能互相替代。先打开常用网页,再测试日常应用。遇到一款客户端正常、另一款失败时,比较内核支持、传输参数和路由设置,而不是只比较服务器备注。备注相同也可能对应不同端口、不同协议或不同的订阅过滤结果。

批准网络接管并设置应用范围

Android 首次建立连接时通常显示 VPN 连接请求,这是系统授予应用接管网络流量的授权流程。核对请求的应用名称后确认,再观察系统连接标识与客户端日志。这里不是桌面系统中的“自动配置系统代理”菜单,也不需要把手机无线网络的手动代理另行指向桌面端口。已有其他使用系统 VPN 通道的应用时,通常不能同时保持两条此类连接,应先停止冲突应用。

需要应用分流时,先确认界面的名单语义:选中应用可能表示“这些应用走代理”,也可能在启用绕过选项后表示“这些应用不走代理”。设置完选一个明确在名单中的应用和一个不在名单中的应用分别测试。不要同时修改应用名单与域名路由,否则很难判断是哪一层决定了出口。浏览器内的加密 DNS、应用自带代理和系统网络配置也可能形成额外路径,需要单独记录。

处理后台限制与网络切换

连接刚建立时正常,锁屏后失效,应先查看系统是否限制后台活动。根据设备设置允许客户端维持必要的后台运行,并保留连接通知;不同厂商的电池管理入口名称不同,以当前系统说明为准。无需一次性放开所有应用的后台权限。若启用了始终开启的网络连接或断开时阻止连接的选项,应理解其效果:客户端停止后,系统可能主动阻断其他网络,而不是服务器突然失效。

从无线网络切到移动网络后,等待系统网络就绪,再重建客户端连接。若仅移动网络失败,比较当前网络的域名解析和服务器端口可达性;若全部网络都失败,优先检查订阅状态与认证信息。退出时使用客户端的停止按钮,确认系统连接标识消失。迁移到新设备时重新批准系统授权,不复制旧设备的权限状态;涉及内核差异的迁移,可结合Xray 与 V2Fly 内核区别逐项核对。

管理订阅分组与配置迁移

分清订阅更新和服务器连接

订阅更新负责下载和解析服务器清单,服务器连接负责把流量转发到选中的远端。两者可能访问完全不同的地址。更新成功只能证明清单可获取,不能证明每项服务器都可连接;某个服务器仍可用,也不能证明订阅地址尚未过期。排查时把“更新订阅的错误”和“连接服务器的错误”分别保存,避免把页面返回的错误文本当成协议认证失败,也避免靠不停刷新订阅解决本地端口占用。

在“订阅分组设置”中为不同来源建立独立分组,备注写用途或来源简称,地址保持原文。首次导入不设置过滤关键字,确认清单完整后再缩小范围。过滤规则的匹配方式随界面实现而异,使用前查看字段说明,不默认把普通文本当成正则表达式。更新后列表为空时,先撤销过滤并重新更新,再检查服务端是否确实返回空清单;不要立刻删除整个分组。

选择更新通路与更新时机

“更新订阅(不通过代理)”适合订阅服务可直接访问的情况。“更新订阅(通过代理)”需要已有可用的代理连接,适合直接获取失败但当前代理仍正常的情况。新安装设备若没有任何活动服务器,通过代理更新通常无法自行建立通路。此时应先确认服务方提供的直连获取方式,或按其说明导入一条有效连接,再尝试更新。不要从不明来源取得临时资料来绕过这一前置条件。

自动更新间隔应结合服务方的限制和实际变动频率设置,频繁请求不等于列表更可靠。遇到限流响应,先停止反复点击,等待服务允许的时间后重试。地址失效、账户停用或服务方更换订阅格式时,需要回到账户页面确认,不是改 DNS 就能解决。更新成功后检查当前活动服务器是否仍存在;原服务器被删除或改名时,应重新选择,不能仅看旧备注仍显示在状态区域。

保留手动服务器与必要备份

手动添加的连接与订阅生成的连接应分开管理。不要长期直接修改订阅条目的地址、端口或备注来保存自定义内容,因为下一次更新可能覆盖它们。确需临时调整时,复制到独立的手动分组,并记录修改理由。服务器名称不是稳定标识,同名条目也可能包含不同传输参数;迁移时以完整字段为准,不按名称批量合并。删除分组前先确认其中是否还包含唯一保留的手动资料。

升级或换机前,保存订阅地址、手动连接、路由规则和必要的客户端设置。备份中往往含认证资料,应保存在受保护的位置,不放进公开同步目录。不同系统之间先迁移可通用的服务器资料,再重建系统代理和 TUN 授权。不要覆盖新系统的可执行文件路径、网卡名称或提权配置。恢复后先只启用一条连接,确认正常,再恢复自动更新、应用分流和其他个性化选项。

内容迁移方式恢复后检查
订阅地址重新建立分组并更新地址有效性与过滤条件
手动服务器使用完整分享资料或受保护备份协议与传输字段
路由规则按新客户端格式导入规则顺序与出口标签
系统授权在新设备重新申请网络接口与管理员权限

限制敏感信息的传播范围

订阅截图尽量只保留错误类型、时间和操作名称。分享链接可能把认证内容编码在整段文本内,外观不像密码也应当保密。请求帮助前检查导出文件、日志和二维码,不要把完整配置直接贴进讨论区。若已经泄露,按服务方提供的方式更新订阅凭据;只删除公开消息不能撤销已经复制的地址。需要进一步整理多个来源时,可查阅多订阅分组与服务器过滤实践,再逐步增加筛选条件。

配置系统代理、路由与 TUN

先确认流量有没有进入客户端

系统代理决定应用把请求交给哪个本地入口,路由决定进入内核后的连接交给哪个出口。这是连续的两个阶段。应用没有使用系统代理时,修改路由规则通常不会改变其行为;流量已经进入内核但被规则分到直连时,重复开启系统代理也不会让它自动改走远端。先用日志确认请求是否到达客户端,再看目标域名、匹配规则和出口,能减少在无关选项之间来回试错。

“清除系统代理”用于撤销系统代理入口,“自动配置系统代理”用于写入当前客户端入口,“不改变系统代理”用于保留现有设置。后者不是自动恢复,也不是另一种全局模式。退出程序后若系统仍指向本地端口,遵循系统代理的应用就可能无法联网。需要长期与其他网络工具共存时,应明确由哪个程序负责写入和恢复,不要让两个程序轮流修改同一组系统设置。

理解预设与规则匹配顺序

托盘路由菜单中的“绕过大陆”“黑名单”“全局”用于切换预设策略。具体覆盖哪些目标取决于当前规则内容,不应只凭预设名称推断。全局策略通常指进入该代理路径的流量使用代理出口,并不强制所有应用接入客户端。需要保留局域网设备访问时,检查私有网段和本地域名的处理方式;在工作网络中,还要考虑内部域名解析和专用地址段,而不是简单照抄公共规则。

路由一般按规则顺序查找匹配项,较宽的条件放在前面可能遮住后面的精确条件。下面是路由对象片段,展示域名与私有地址的分流形式;它不是完整客户端配置,也不应直接粘贴进只接受规则数组的输入框。合并前确认当前内核语法、编辑入口要求,以及完整配置中已经定义同名出口。不存在的出口标签会使规则无效或导致配置启动失败。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["domain:example.com"],
        "outboundTag": "proxy"
      },
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

示例中的 domain 按域名匹配,ip 按地址或地址集合匹配,outboundTag 指向已定义出口。domain:example.com 是教学用域名条件;geoip:private 依赖内核可读取对应规则数据。AsIs 不会为了每次路由匹配主动解析所有域名,因此仅有地址规则时,不一定能匹配仍以域名形式传入的目标。不要为了命中某一条规则,直接替换全部 DNS 策略。

单独验证 DNS 与应用内设置

网页按域名访问失败而其他连接正常时,检查名称解析,但不要只换一个公共解析地址就结束排查。系统、浏览器、应用和内核都可能各自处理 DNS。浏览器启用加密 DNS 后,请求路径可能与系统不同;TUN 接管解析后,又可能改变域名与目标地址的对应关系。测试时保留一种清晰路径,记录请求是否进入客户端,再决定应修改系统解析、应用选项还是内核设置。

TUN 扩大的是流量接管范围,不会修复错误认证、过期订阅或不可达的远端。开启前确认管理员权限,关闭其他同类接管程序;开启后分别测试域名访问、局域网访问和不读取系统代理的应用。出现问题时先撤销最近增加的设置,恢复到系统代理下可工作的状态,再逐层添加。保留必要的局域网例外,避免打印机、网络存储和工作服务因出口变化而失联。

排查配置常见问题

按故障阶段缩小范围

先判断故障发生在安装、启动、更新订阅还是访问网页。安装失败看架构、系统兼容与权限;窗口打不开看运行环境和图形会话;内核启动失败看配置语法、组件路径和端口占用;订阅更新失败看地址及获取通路。只有程序和内核都正常启动后,才进入网页连接排查。把四个阶段混在一起反复重装,既不能解决服务端问题,还可能丢掉能用于对照的原始设置。

遇到“已连接但打不开网页”,先关闭 TUN 并清除系统代理,确认基础网络是否可用。直连也失败时,优先处理无线网络、网关、系统解析或登录认证页面。直连正常时,再打开客户端,只启用系统代理,选择一条已知资料完整的服务器。观察失败是立即发生还是等待超时,是否所有网站都失败,以及其他应用是否同样受影响。每项结果都对应不同的下一步,不能只凭一个连接图标下结论。

根据日志区分端口、认证与超时

本地监听失败通常出现在内核启动阶段,重点检查重复实例和端口冲突;认证被拒绝通常指向账户资料、协议参数或服务状态;连接超时则需要继续区分地址解析、网络可达性和远端响应。证书相关错误先检查系统时间、服务器名称和传输参数,不把关闭证书验证作为通用修复。保留完整错误句和发生时间,比只截取其中一个英文单词更有用,也方便比较修改前后的差异。

同一订阅只有部分服务器失败时,先对照其协议、传输、端口和出口地区,确认是否属于同一类配置。全部服务器都失败且内核没有连接记录时,更可能是应用入口或本地接管问题。只有某个网站失败时,检查路由、域名解析和目标服务状态,不要直接重置全部客户端。测试节点应使用一致的网络与方法;不同探测方式的结果不能直接比较,详细选择顺序可见节点延迟、倍率、地区与协议对照。

恢复可工作的基线

经过多轮修改后,先备份当前设置,再建立最小配置:保留一个订阅分组、一条服务器、默认路由和一种流量接管方式。暂时关闭自定义规则、应用名单和自动切换。基线可用后,每次只恢复一项,并复测同一网页与同一应用。若某项恢复后立即失败,保留前后设置差异,不需要再次重装整个程序。重置不是第一步,而是在已经保存资料、明确知道恢复范围后使用的定位方法。

准备求助资料时,写明操作系统、架构、客户端名称、实际操作路径、错误原文与已完成的对照测试。日志可以提供连接阶段信息,但上传前要移除订阅地址、认证字段和可识别的个人资料。不要公开整份备份文件。更完整的网页访问排查路径可查阅v2rayN 已连接但打不开网页清单;首次配置中遗漏步骤时,则回到使用文档按顺序重走主线。

更新订阅成功,为什么仍然不能浏览网页?

更新成功只说明服务器清单已取得。继续确认活动服务器、本地内核、系统代理或移动端网络授权,再查看连接日志。若没有请求记录,先查应用是否进入代理;已有请求但报错,再查服务器资料和远端连接。

关闭客户端后网络中断,应该先改什么?

先检查系统代理是否残留本地地址,以及 TUN 或移动端阻断选项是否仍生效。恢复正常网络设置后再启动客户端。此时不应先改订阅地址或服务器协议,因为客户端已经停止,入口残留更值得优先检查。

开启 TUN 后是否还需要检查路由?

需要。TUN 负责接入流量,路由仍决定出口。确认本地网段、工作网络与域名解析没有被错误接管,再测试目标应用。若普通系统代理正常而 TUN 失败,优先检查权限、虚拟接口、路由和 DNS,而不是更换全部服务器。