01 · 通用准备
安装前:核对设备、订阅与流量入口
先选客户端,再选安装包
桌面端优先选 v2rayN。Windows 要分清桌面版和经典 WPF 版,也要核对系统架构;macOS 看芯片是 Apple Silicon 还是 Intel;Linux 先看发行版支持的包格式,再看处理器架构。Android 首选使用 Xray 内核的 v2rayNG;已有配置明确要求 V2Fly 内核时,再考虑 v2flyNG。客户端负责界面和配置管理,内核负责实际连接,两者不是同一个东西。在桌面端看到可选内核,也不意味着切换后原来的传输和安全参数一定还能照用。
不要用压缩包名称猜系统架构,也不要用另一台设备的下载记录代替本机检查。比如同一套订阅可以分别导入电脑和手机,但电脑用的系统代理地址是本机地址,不能整套抄到手机里。给每台设备先记下客户端名称、系统架构和计划使用的接管方式。若设备受组织管理,还应事先问清是否允许安装软件、创建虚拟网络接口或修改代理,不要用提权操作绕过策略限制。
| 平台 | 选包依据 | 接管测试起点 |
|---|---|---|
| Windows | 系统架构、桌面版或经典 WPF 版 | 先用遵循系统代理的浏览器验证 |
| macOS | Apple Silicon 或 Intel | 核对当前网络服务的代理设置 |
| Linux | 发行版、deb 或 rpm、处理器架构 | 先给单个应用指定本地代理 |
| Android | 应用支持的架构、内核需求 | 授权系统 VPN,再验证应用范围 |
区分订阅地址与单条分享链接
订阅地址让客户端去远端拉取一组条目,通常要做两次操作:先保存订阅项,再手动触发更新。能看到分组只说明地址已保存,不代表节点已拉取。以 vmess:// 或 vless:// 开头的通常是单条分享链接,走剪贴板或分享链接导入,不应填进订阅地址栏。反过来,把订阅地址当作服务器主机名填入手工配置,也不会变成可连接的节点。扫码导入前同样要先确认二维码承载的是哪一种内容。
确认来源给的是 V2Ray 客户端可读取的配置,而不是账户管理页面、支付页面或需要浏览器会话才能打开的地址。订阅更新和节点连接是两条请求链路:更新成功只说明客户端能取到清单;节点连通则还要看服务端、传输与安全参数。命名时给订阅组加上用途和来源备注,第一次只选一个条目测试,留一条已知能工作的配置作对照。排查时别先删除旧分组,更新可能覆盖当前条目,临时手改的参数也未必会保留。
记录基线,再决定是否启用 TUN
先在客户端尚未接管流量时确认网络能访问一个平时能直连的站点,记录正在使用的网络、其他代理应用、组织 VPN 和自定义 DNS 设置。公共网络有登录页时,先走完原本的网络认证。后续如果开启代理后连原先正常的站点都打不开,就有一份可比较的起点。桌面端还要记下客户端实际显示的监听地址、端口和协议;同为本地端口,HTTP 和 SOCKS 的用途也不能互换。
初次配置只开一种接管方式。系统代理是给愿意读取该设置的应用提供入口;TUN 借助虚拟接口和路由处理更多流量,权限要求、DNS 行为以及与其他网络工具的相互影响也更复杂。只验证浏览器时先用系统代理或应用自己的代理设置。等一个节点、一个应用已经跑通,再处理不读取系统代理的程序。这样即使后续遇到问题,也能区分是节点从未连通,还是接管范围改变后出现了新问题。
02 · 桌面客户端
Windows:安装 v2rayN,配置系统代理与 TUN
在桌面版与经典 WPF 版之间选择
在 Windows 的「设置 → 系统 → 关于」查看系统类型,再到Windows 下载入口核对安装包。本页下载中心列出的两个入口为 x64:桌面版采用跨平台界面,首次使用可优先选它;正在沿用经典界面、旧截图教程或已有操作习惯时,可以选 WPF 版。两者不是要一起装的配套组件,也不建议首次配置就同时运行两份;否则很容易出现端口被占用,或一份客户端退出时清掉另一份刚写入的系统代理。
如果拿到的是压缩包,先完整解压到当前用户可写、容易找到的目录,再从解压后的目录启动;不要在压缩工具的预览里双击可执行文件,也不要只把主程序拖出来运行。若下载项是安装程序,则按安装程序提示走,不要套用解压版的目录迁移方法。启动时如提示缺运行环境,先核对弹窗指向的组件类型、架构和当前版本说明,再从组件发布方获取对应运行环境。遇到安全软件拦截或组织策略限制,先查看提示详情,不要全局关闭防护。选包细节可对照Windows 桌面版与 WPF 版安装笔记。
导入订阅并确认核心实际启动
从订阅分组设置新增一项,填入订阅地址和备注,保存后选择更新该分组。若界面同时提供直连更新和通过代理更新,首次没有可用代理时先尝试直连;只有订阅来源明确需要已有代理、且本地已有一条可用配置时,才测试经代理更新。条目出现后选中一条设为活动服务器,然后看核心状态和日志:列表高亮不等于核心监听成功,尤其是机器上还有旧客户端或开发工具占着同一个端口时。
如果只有单条链接,可用剪贴板导入。导入后检查协议、地址、端口、传输和安全设置是否符合来源说明,别把客户端中的本地监听端口填成远端服务器端口。桌面版与 WPF 版的菜单位置可能不同,找不到对应菜单时按「订阅分组」「活动服务器」「系统代理」这些功能名称找,不要按旧教程图上的坐标盲点。看到核心配置生成失败时,应先处理日志中第一条具体错误,而不是反复切换节点。
先验证系统代理,再处理必须接管的应用
启用 v2rayN 的系统代理设置后,到 Windows 的「设置 → 网络和 Internet → 代理」核对实际状态,再用一个愿意读取系统代理、没有代理扩展接管的浏览器做测试。若系统代理指向当前客户端而核心没在监听,浏览器通常会先遇到本机连接失败。若浏览器正常但终端不通,不能据此断定线路不稳:终端工具可能使用自己的配置或环境变量,有些服务还以其他账户运行。按浏览器与终端分开排查的笔记先确认各自的入口。
确实需要覆盖不读系统代理的应用时,先退出其他代理或虚拟网卡工具,再单独尝试 TUN。按客户端提示确认权限或驱动状态,启用前后都测试日常站点、目标应用和本地网络资源。若开启后公司内网或共享设备失联,回到原来的模式,查看 TUN 是否接管了原有内网网段、域名解析或默认路由。不要把 GUI 提升权限当作解决所有网络错误的通用做法;节点握手失败和端口占用不会因为提权自动修好。
03 · 桌面客户端
macOS:按芯片安装 v2rayN,核对网络服务
通过系统信息选对磁盘映像
打开苹果菜单里的「关于本机」:显示 Apple 芯片的设备在macOS 下载入口选 Apple Silicon 包,显示 Intel 处理器的设备选 Intel 包。不要单靠终端进程报告的架构判断;如果终端本身运行在转译环境,得到的结果可能不是你想确认的机器架构。打开磁盘映像后按映像内提示安装,常见做法是将应用拖入「应用程序」,再从那里启动,而不是每次打开挂载卷里的副本。
首次启动如有权限或系统安全提示,先核对应用名称、获取来源与系统信息;若提示的是损坏、恶意软件或组织限制,按具体提示排查,不要为了启动而全局关闭系统防护。更新后注意启动的是刚安装的应用,不是下载目录或磁盘映像里保留的旧副本。若应用闪退,先看能否稳定打开界面,再讨论订阅和节点;界面都没启动时,改路由规则不会帮忙。可参考桌面端首次安装设置清单分辨启动阶段的问题。
导入一组订阅,保留最小测试范围
在订阅管理中新建分组并更新,选一条服务器作为当前项,再查看内核是否启动。剪贴板导入前确认粘贴的是原始地址,而不是聊天应用把多行介绍和链接一起复制下来的内容;只清除两端多余的空白,不要自行删改地址里的路径、查询参数或转义字符。若网页端能登录而客户端更新失败,先核对取得的是否是客户端订阅地址;浏览器能够打开管理页面并不证明订阅接口接受同一条链接。
首轮只测试这一组配置,暂时别迁移另一台电脑的整套应用数据。旧配置可能带着已经不存在的内核路径、监听端口或分流文件。迁移订阅与迁移应用设置要分开:先在新设备上导入原订阅,确认节点可用后,再逐项恢复确实需要的规则。修改前记下旧值,当新规则导致特定域名异常时,就能直接回到能用的配置而不是从头安装。
区分当前网络服务、应用代理与 TUN
启用系统代理后,在「系统设置 → 网络」中选当前使用的网络服务,打开其详细信息里的代理页面。不同系统界面的入口文字可能略有变化。重点看当前走的是无线网络还是有线服务,以及启用的代理类型、地址和端口是否与客户端一致。切换网络服务之后重新核对;此前在有线连接上生效的配置,不代表切换到无线后仍按预期接管。也要留意自动配置脚本或其他管理工具是否会改回设置。
可在终端查看系统当前报告的代理设置。下面的命令只读取信息,不会写入状态;输出里的启用标记、代理主机和端口要与界面联系起来看。即使系统报告已启用,也只能证明系统设置存在,不能证明某个命令行工具读取了它。浏览器与终端表现不一致时,先确认终端工具自身的网络选项;已经给应用指定过代理时,不宜把结果直接拿来判断系统代理是否起作用。
scutil --proxy
如需启用 TUN,先确认当前版本提供该选项,并按客户端实际提示处理权限。不要在尚未验证内核和节点的情况下同时改系统代理、路由规则和 DNS。若在切换无线网络、从睡眠唤醒或从底座拔下网线后掉线,先确认系统重新联网,再按「关闭额外接管、复测核心、重新启用 TUN」的顺序检查。若只有企业站点或本地设备受影响,回退到已知可用的接管方式,再检查内网访问所需的路由和解析条件。
04 · 桌面客户端
Linux:安装 v2rayN,处理桌面代理与虚拟接口
先核对发行版和处理器架构
到Linux 下载入口选择 v2rayN。通常 Debian、Ubuntu 及相应衍生发行版选择 deb;Fedora 等使用 RPM 的发行版选择 rpm。包格式对了还要核对架构:命令输出 x86_64 对应 x64,aarch64 对应 arm64;有的系统工具会以 amd64 表示同一类 x64 架构。若发行版不是这些包的目标环境,不要通过重命名扩展名或强制安装来解决依赖差异,先确认发行版的兼容性。
uname -m
cat /etc/os-release
桌面环境可用软件安装器打开相应包;习惯命令行的话,使用发行版自带且能解析依赖的包管理器,从下载目录选中实际文件。安装失败时,读清提示是架构不受支持、依赖找不到,还是软件源不可用。不要随便给系统库建立同名链接,也别让 GUI 一直以管理员账户运行:那样可能让应用把配置和缓存写到另一个账户,回普通用户启动时就像是全新安装,还容易把权限问题和客户端问题混在一起。
导入订阅后,从单个应用验证
用当前桌面会话的普通用户启动 v2rayN,添加订阅分组、更新并选择活动服务器,确认内核启动后抄下实际监听端口。浏览器如果使用自己的代理设置,可以先只给这个浏览器指定代理。这样即使桌面环境没有应用系统代理,仍有独立的对照测试。如果同一个端口曾由旧实例、容器或开发程序使用,先核对监听者,再选择关闭旧实例或改用空闲端口,并同步更新测试应用里的端口。
在常见 Linux 桌面环境里,桌面代理设置和命令行程序并不共享可靠的接管机制。桌面应用可能跟随 GNOME 或 KDE 的网络代理,也可能自己管理代理;终端里启动的程序会按自身配置或环境变量行事。需要临时验证时优先用单次命令参数或单个应用设置,不要马上向全局环境文件写入代理变量。长时间保留全局代理,会让后来开的包管理器、构建进程和后台任务在客户端退出后继续尝试连接已关闭的端口。
检查 TUN、路由与解析的差异
需要让不读应用代理的流量也进入客户端时,确认安装版本的 TUN 支持和当前环境是否允许创建虚拟接口。常见限制包括设备不可用、会话权限不足、虚拟机或容器未获相应网络权限。此类提示说明接口还没有创建成功,不是更换订阅就能解决的。先复测普通应用代理是否可用,再按报错和发行版文档确认原因;若环境由他人管理,向管理员确认权限范围,不要给所有用户开放设备权限。
启用前后可以对照当前会话里看到的接口和 IPv4 路由。下面的命令只读;默认路由不变并不足以否定 TUN 生效,因为客户端也可能使用策略路由。排查时把输出和客户端日志、具体请求是否进入内核一起看。若远程会话是唯一的管理入口,不要在没有恢复路径时试改接管设置,以免修改路由后失去连接。
ip -brief address
ip -4 route show
ip -4 rule show
若某个域名失败而其他请求正常,先看是否仅在 TUN 下出现,再观察应用与系统解析行为有无差异。比如浏览器使用自己的加密 DNS 时,系统查询的结果可能无法代表该浏览器。先恢复到可工作的应用代理做对照,不要一口气改解析器、路由表和防火墙。确认应用请求根本没进内核,就先查入口;确认进来了但是出站选错,再去查分流规则和域名解析。
05 · 移动端客户端
Android:安装 v2rayNG,导入订阅并授权 VPN
选安装架构,确认用哪个内核
从Android 下载入口优先选 v2rayNG,它使用 Xray 内核。大多数较新的手机可选 arm64,但能否安装还与设备系统支持的架构有关,不能只看处理器宣传。架构不确定时选通用版;通用版可以覆盖更多架构,却不能解决系统版本不满足要求、存储不足、组织策略限制等问题。需要与现有 V2Fly 配置保持一致时可选 v2flyNG,安装和导入思路相近,具体协议与传输支持按内核实际能力确认。
安装时系统可能要求授权当前打开安装包的来源应用。先确认文件来自下载入口,按系统界面只为这次使用的来源操作,装完可以收回来源授权。如果安装提示与已存在的应用冲突,不要在没备份时直接卸载;先记录订阅和自定义条目,并确认是否在尝试覆盖不同来源的构建。清空应用数据也会删除现有配置,不能当作首选故障处理步骤。
更新订阅,再检查当前条目
在客户端的订阅分组设置中添加地址和备注,回到列表触发更新。看到条目以后进入对应分组,选中一条作为当前配置,再用界面上的连接按钮启动。只有一条分享链接时,使用剪贴板导入;订阅地址仍应在订阅设置中使用。手机上复制经常连同引导文字一起选中,遇到格式错误先确认剪贴板里是不是只有那一条地址或链接,不要反复点击更新期待它自动识别文本类型。
第一次只用一个应用验证,优先选没有单独代理设置、也没有特殊网络权限限制的浏览器。先用同一网络访问一个此前能打开的站点,再测需要走配置的目标。如果只有一个条目连不通,可在当前分组用一个已知可用的条目做对照,避免把单条配置过期误判成手机安装失败。如果更新后选中的条目消失,检查分组是否仍选对、订阅是否替换了内容,以及新的活动条目是否已选中。
处理系统 VPN 授权、分应用代理和后台断开
Android 上通常通过系统 VPN 接口把流量交给客户端,桌面端「写入系统代理」的步骤不能照搬。第一次启动时,系统会弹出 VPN 连接请求,确认是刚打开的客户端再允许。状态栏出现 VPN 标识只说明系统通道建立,不代表远端握手成功。若已有另一个 VPN 应用处于活动状态,或系统指定了始终开启的 VPN,先确认是哪个应用在接管;对工作资料或管理设备,不要擅自改掉组织配置。
开了分应用代理后,要分清当前列表是「仅让选中的应用进入」还是「把选中的应用排除」。两种配置即使勾选了同一个浏览器,结果也正好相反。遇到一个应用始终不通,先检查它是否在当前接管范围,再看路由选择。测试期间若要改变范围,保留原有配置记录,每次只变一项,并按客户端要求重连后复测,避免把旧连接的表现误认为新规则不生效。
能连却在熄屏后断开时,先用同一无线网络比较亮屏、熄屏后的表现,再看系统是否暂停了后台进程或限制后台联网;只在需要时为该客户端调整电池策略。若切换到移动数据才失败,检查应用是否被系统限制使用移动数据、流量节省模式是否启用,以及订阅和节点能否在该网络分别访问。不要同时改变电池策略、分应用范围和 DNS,否则恢复连接后也说不清究竟哪项才是原因。
06 · 跨平台验证
路由规则与连接验证:从入口查到出站
分别测试入口、核心和目标连接
把一次访问拆成三个问题:应用有没有把请求交给客户端,内核有没有把它送到预期出站,目标连接有没有成功。系统代理、手动应用代理和 TUN 解决第一件事;路由规则解决第二件事;节点传输、认证、目标响应等决定第三件事。开了某个接管开关,不等于路由一定选代理;选了较宽泛的代理路由模式,也不意味着每个应用都进入客户端。概念容易混时,可读系统代理与路由模式对照。
桌面端若客户端提供 HTTP 代理监听,可以直接用命令行工具指定代理测试。下面以 127.0.0.1:10809 为示例,运行前替换成界面实际显示的 HTTP 监听地址和端口。在 Windows PowerShell 中如 curl 被映射成别的命令,使用 curl.exe。示例显式指定入口,有别于「测试系统代理有没有写入」;它更适合确认本地监听是否能接请求,以及请求进入后出现的是何种错误。正常响应也不证明该请求一定走远端节点,仍要看路由日志。
curl -v --max-time 15 --noproxy "" --proxy http://127.0.0.1:10809 https://example.com/
若得到本机拒绝连接,优先查监听地址、端口和核心状态。若本地代理已应答而之后出现连接超时,去看该请求匹配的出站和远端连接记录。若已收到目标站点的应用层响应,即使对方返回错误页,也与「完全没有连到目标」不同。Android 没有必要为了做同样的测试去装终端工具,选一个确定在 VPN 接管范围内的应用,清楚记录请求时间,再对照客户端日志即可。
理解规则先后顺序与标签
常见的 Xray 与 V2Fly 路由配置按列表顺序检查规则,先匹配的规则决定出站。比如要让指定的私有地址走直连,规则应放在更宽泛、同样可能匹配这些地址的规则之前。下方是可放进兼容内核 routing.rules 数组的一项,不是独立配置文件;前提是现有出站确有 direct 标签并且指向直连。在客户端使用图形化规则时,界面显示的出站名称也要与实际生成的标签对应。
{
"type": "field",
"ip": ["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"],
"outboundTag": "direct"
}
这条只匹配列出的私有 IPv4 网段,不是通用的局域网发现方案,也不包含 IPv6。应用如果交来的是域名,不一定会在路由阶段得到可供规则匹配的 IP;这取决于内核的域名处理策略和当时的解析条件。要处理明确的内网域名,可以按现有规则体系设置相应域名匹配,并核对使用哪个解析器。不建议仅为照顾一个新规则就全局改变 DNS 行为,否则其他原本依赖内部解析的应用也可能受影响。
用一份小记录确认变更结果
修改前后分别测日常直连站点、一个确实应该经过所选出站的目标和一个依赖原有局域网访问的资源。一次只改一个变量,例如先只调整规则顺序,再单独考虑 DNS。记录应用名称、接管模式、目标用域名还是 IP、请求时间和日志中的出站结果,比只记录「通」或「不通」更容易复现。测速工具各自检查的层级可能不同,看到较低延迟不能代替实际应用测试;一次超时也不能单独证明节点不可用。
若切换了节点或规则但同一应用表现没变化,先退掉正在复用的连接或重启测试应用,再用新的请求确认。网页从本地缓存打开,也不等于网络已恢复。涉及长连接的应用尤其需要确认重连时间。实测符合预期后,把能用的规则保存为单独配置或保留一份改动记录;日后订阅更新或内核切换,可以从同一组目标复测,而不必重新猜测以前为什么这样设置。
07 · 故障排查
配置常见问题:更新失败、握手错误与退出恢复
订阅更新失败,还是更新成功但没有可用条目?
先看界面报的是请求失败、解析失败,还是更新完成但分组为空。请求失败时,检查基础网络、设备时间和更新走直连还是走代理。如果订阅更新设置成经本机代理,而本机当前还没有可用配置,就可能卡在前置条件。解析失败时,确认拿到的内容确实是订阅接口返回的配置,而不是登录页面、过期提示或需要重新授权的响应。不要凭网页能打开就断定接口能访问,也不要为排除证书错误而长期关闭安全检查。
更新完成但列表为空时,进入正确分组并清除名称搜索,检查是不是设置了只显示符合某类条件的服务器。若已有多组订阅,先只更新出问题的那一组,把错误留在能观察的范围内。老条目在更新后消失,可能是来源已移除该条目,也可能是分组筛选条件变化;两者的处理方向不同。长期管理多个来源时,可按订阅分组与服务器过滤笔记给来源单独分组,避免更新时把同名条目认错。
看到超时或握手失败时,怎样缩小范围?
如果日志明确指向本地端口占用,优先解决重复客户端或冲突端口;此时内核甚至还没准备好接应用请求。若已经有远端握手记录,再对照原始配置看协议、传输方式和安全类型。遇到域名证书类报错,先检查设备日期、时区和服务端名称设置是否符合配置来源的说明,不要把忽略证书错误当成修复。使用了客户端内核切换功能,也要确认新内核认识该条目中的字段和传输方式。
连接超时的信息本身很宽:可能是远端不可达、解析出错,也可能只是目标站不响应。用同一网络测两个已知目标,再用同一条配置换一个允许测试的网络。若无论选哪条配置都只有某个应用失败,优先检查应用走的入口和自身的网络设置;若同一应用只有一个条目失败,再回查条目的远端参数。向他人求助时附上最早出现的具体错误、发生阶段和已做的对照,不要用最后一条通用报错盖过前面的原因。
关闭客户端后断网,如何恢复到原状态?
桌面端先检查系统是否仍指向本机代理端口。如果已经停止核心,残留的手动代理会让遵循系统设置的应用找不到监听者。按安装前的记录恢复系统设置;有自动代理脚本或管理策略的设备,不要随意删除原来的值。若只有一个浏览器或终端受影响,检查它自己的代理选项,以及当前终端会话是否曾设置代理变量。新终端正常、旧终端不通,就是值得记录的线索,不必立即重装软件。
如果故障来自 TUN 或 Android 的 VPN 配置,先用客户端或系统界面正常断开,观察接口和连接状态是否恢复。仍有问题时,回看启用前存在的 VPN、内部 DNS 和分应用限制,逐项恢复。网络切换、旧进程和缓存都可能干扰判断,但不要一开始就重置全部网络设置;那可能连原本正常的 Wi-Fi、组织代理和访问规则也一道清掉。恢复之后先以原有网络访问普通目标,再决定是否重新启用客户端。