QUICK CONFIGURATION

V2Ray 配置教程:订阅导入到连接验证

围绕一次完整配置展开:先把订阅写入客户端,再确定代理模式、连接活动节点,最后从浏览器与运行日志两侧确认结果。正常情况下,四个步骤可在约 10 分钟内完成。

01
订阅 写入配置来源
02
模式 确定流量范围
03
连接 启用活动节点
04
验证 检查网页与日志
闭环检查

BEFORE START / 00

开始前检查:客户端、订阅链接与当前网络

先确认客户端已经完成安装并能正常打开。桌面设备使用 v2rayN,安卓设备使用 v2rayNG;若还没有安装,可以先到安装包页面按平台选择。首次启动时若出现系统网络访问提示,应根据系统界面允许客户端建立本地网络连接,否则后续即使节点配置正确,系统流量也可能没有进入客户端。

本教程假设已经取得一条可用的订阅链接。订阅链接不是普通网页地址,它用于向客户端提供节点配置与分组信息。复制时应从开头到结尾完整选中,不要附带聊天软件中的引号、句号、换行或说明文字。如果服务方同时给出二维码、单节点链接和订阅链接,本页优先采用订阅链接,因为后续更新节点时仍可沿用同一个订阅分组。

配置前保持当前网络可正常打开常用网页,并暂时关闭其他会修改系统代理的同类客户端。这样做是为了建立清晰的判断基线:导入之前网络正常,连接之后若出现变化,就能把范围收敛到当前客户端、节点或代理模式,而不是在多个网络工具之间反复猜测。

CLIENT 客户端可启动

主窗口、设置页与节点列表可以正常打开。

SUBSCRIPTION 链接复制完整

保留完整地址,不混入说明文字与多余空格。

NETWORK 基础网络正常

连接前先确认普通网页访问状态可判断。

SUBSCRIPTION LAYER

导入订阅:先建立分组,再更新节点列表

打开 v2rayN 后,找到“订阅分组”“订阅设置”或名称相近的入口。常见位置在主窗口顶部的订阅菜单,也可能位于左侧导航。进入管理页面后选择新增分组,在备注栏填写一个便于识别的名称,例如“日常配置”,再把完整订阅链接粘贴到地址栏。备注只用于本地辨认,不会改变订阅内容;真正决定节点来源的是链接字段。

保存后回到主窗口,再次打开订阅菜单,执行“更新订阅”或“更新全部订阅”。更新过程结束时,主列表应出现若干节点行,每行通常包含别名、协议类型或服务器信息。此时不要急着连接,先观察列表是否确实发生变化。如果列表仍为空,重新进入订阅分组检查地址开头、末尾和中间是否多出空格,并确认新增分组处于启用状态。

在 v2rayNG 中,从侧边菜单进入订阅分组设置,点击新增按钮,填写分组名称与订阅地址后保存。返回节点列表,通过右上角菜单执行更新订阅。更新完成后,页面会从空列表切换为可选节点列表;如果存在多个订阅分组,可在分组选择区域确认当前显示的是刚添加的那一组。部分版本会在更新后自动刷新,部分版本需要返回列表或手动下拉刷新一次。

订阅导入只负责把远端配置转换为客户端可以读取的节点条目,并不代表连接已经启动。看到节点列表,说明第一层已经完成;下一步才是决定哪些流量交给客户端处理。协议名称、传输方式、TLS、VMess、VLESS 等字段如果暂时看不懂,可以先查阅术语手册,本次基础配置不需要逐项修改这些字段。

操作路径 订阅设置 → 新增分组 → 粘贴链接 → 保存 → 更新订阅

看到什么才算完成

完成标志不是弹出“保存成功”,而是主列表已经出现可选择的节点,并且订阅分组名称与刚才填写的备注一致。若更新提示失败、列表为空或只有一条无法识别的文本,不要进入连接步骤;先重新复制链接并再更新一次。持续失败时,可转到排查手册的订阅章节,按链接响应、更新路径和版本兼容性继续定位。

ROUTING LAYER

选择代理模式:明确哪些流量进入客户端

节点已经出现在列表后,先处理代理模式。客户端通常会把“节点连接”和“系统流量是否交给节点”拆成两个开关:前者启动本地代理端口,后者决定浏览器及其他程序是否使用这个端口。只选中节点但没有开启相应的系统代理,客户端可能显示正在运行,浏览器流量却仍沿用原来的网络路径。

对于第一次配置,建议从规则模式开始。规则模式会依据客户端内置或订阅提供的路由规则决定流量去向,适合先验证基础配置。全局模式会让更多流量统一经过当前节点,便于排除规则匹配造成的影响,但不适合作为每次排查的第一反应。直连模式则主要用于恢复普通网络或确认问题是否来自代理链路。三种模式解决的是“如何分配流量”,并不会修复失效节点或错误订阅。

在 v2rayN 桌面端,先找到系统代理设置,将其切换到“自动配置系统代理”或当前版本中语义相近的选项,再查看路由模式并选择规则模式。系统托盘图标的右键菜单通常也能完成这两项操作。切换后留意菜单当前项是否带有选中标记,不要只根据按钮被点击来判断结果。企业设备或受策略管理的系统可能限制代理设置写入,此类情况会在验证阶段表现为客户端有日志、浏览器却没有变化。

在 v2rayNG 中,路由模式通常位于设置页面或侧边菜单的路由设置中。选择规则模式后返回节点列表即可。安卓端的连接按钮会创建系统级网络连接,启动时系统可能出现确认对话框;确认后,状态栏会出现对应的连接标识。此处不需要手动填写本地端口,也不建议在首次配置时同时改动 DNS、分应用代理和自定义路由,以免多个变量叠加后难以判断。

模式 主要用途 本次教程中的位置
规则模式 按路由规则分配流量 首次配置的起点
全局模式 让更多流量使用当前节点 用于对照规则影响
直连模式 恢复原有网络路径 用于基线比较

CONNECTION LAYER

连接节点:设为活动配置并观察运行状态

回到节点列表,先选中一个名称清晰、配置完整的节点。首次验证不需要连续切换多个节点,因为每次切换都可能触发新的连接过程,过快操作会让日志混在一起。选定后将其设为活动服务器:v2rayN 常见操作是双击节点、按回车,或通过右键菜单选择“设为活动服务器”。成功后,当前行通常会出现颜色、图标或选中状态变化,窗口底部也会显示当前服务器名称。

确认活动节点后启动客户端服务,并检查系统代理仍保持上一步选择的状态。v2rayN 的主窗口状态栏或日志区域应开始出现启动记录,本地监听端口随之建立。如果客户端已经在运行,切换活动节点通常会触发配置重载;等待几秒再进行网页测试,让旧连接有时间结束、新连接完成建立。此时先不要关闭主窗口,可最小化到系统托盘,便于验证失败时立即查看日志。

在 v2rayNG 节点列表中,轻触目标节点使其成为当前项,然后点击页面底部的连接按钮。系统首次询问连接权限时,阅读提示后确认。按钮状态会从待机切换为运行,顶部或状态区域显示当前节点名称。若按钮很快恢复到待机状态,说明启动过程没有维持,应立即打开日志查看最靠后的错误记录,而不是反复点击连接按钮。

连接后的日志不需要逐行理解,先看结构即可。正常启动通常会先加载配置,再建立本地入口,随后在浏览器产生请求时出现新的连接记录。如果日志在加载配置阶段就停止,问题多半位于节点字段或客户端版本;如果启动正常但每个请求都超时,问题更可能位于节点可达性或当前网络。日志术语较多时,可结合术语手册理解入站、出站、路由与传输层的关系。

ACTIVE NODE

活动节点已明确

列表中只有一个当前配置,状态区域能看到对应名称,避免测试时不知道实际使用了哪一条配置。

LOCAL SERVICE

本地服务已启动

运行状态保持开启,日志完成配置加载,并在浏览器发出请求后继续产生连接记录。

这一步的完成标志是“节点已设为活动项、客户端保持运行、系统流量入口已经开启”,而不是单纯看到节点名称。三项同时满足后再进入验证,可以把“没有启动”和“启动后不能访问”区分开,后面的判断会清楚很多。

VERIFICATION LAYER

验证是否生效:网页、流量状态与日志交叉确认

保持客户端运行,完全关闭刚才用于测试的浏览器页面,再新建一个窗口访问平时可以稳定打开的网页。重新打开页面是为了减少旧连接、缓存和已建立会话对结果的干扰。页面能正常加载只是第一层判断,还需要同时查看客户端:如果流量计数发生变化,日志中出现与访问时间对应的新记录,说明浏览器请求已经进入客户端。

接着访问订阅服务方建议用于测试的目标页面,观察加载结果。不要只凭单个网页得出结论,因为网站自身故障、浏览器扩展或缓存都可能影响显示。更稳妥的做法是连续测试两个不同页面,并把客户端日志时间与点击时间对应起来。两个页面都能打开、客户端产生对应连接记录、运行状态保持稳定,可以认为基础配置已经生效。

如果普通网页可以打开,但目标页面不能加载,先保持当前节点不变,把路由模式从规则模式临时切换到全局模式后再测试。全局模式下恢复,说明节点本身可以工作,问题范围更接近路由规则;全局模式下仍失败,则应回到节点、订阅或当前网络继续检查。测试结束后,根据日常需要切回规则模式,避免把临时诊断状态误当成最终配置。

如果切换前后浏览器表现完全相同,同时客户端日志没有新增连接记录,重点检查系统代理或系统连接权限。桌面端重新打开系统代理菜单,确认当前状态确实为自动配置;安卓端确认连接按钮仍处于运行状态。若日志持续产生请求但全部超时,可以只更换一次同订阅中的其他节点进行对照。更换后恢复,通常说明前一个节点当前不可用;全部节点表现一致,再考虑订阅更新、网络环境或客户端设置。

A
网页结果

新窗口中的多个测试页面可以稳定打开。

B
客户端状态

连接保持运行,流量状态随页面请求发生变化。

C
日志对应

访问页面的时间点与新增连接记录能够对应。

QUICK REVIEW

结果不一致时,按链路顺序回查

不要一次改动多个选项。沿着“订阅—模式—节点—系统流量—日志”的顺序检查,每次只改变一个条件。

CASE / 01

订阅更新后列表为空

重新进入订阅分组,检查链接是否完整、分组是否启用,并再次执行更新。若客户端提示解析失败,先重新复制原始链接,不要手动改写链接中的字符。确认链接有效但仍不能解析时,再检查客户端是否需要更新。

CASE / 02

客户端运行,浏览器没有变化

优先确认系统代理或系统连接权限,而不是频繁更换节点。日志没有浏览器请求,表示流量大概率还没有进入客户端;日志存在请求但持续超时,才进入节点与网络方向的排查。

CASE / 03

规则模式失败,全局模式可用

这组对照通常指向路由规则。先恢复规则模式,再确认当前使用的是客户端默认规则还是订阅下发规则。涉及域名匹配、出站标签与 DNS 策略的细化配置,可在排查手册中继续处理。

CASE / 04

连接启动后立即停止

打开日志并查看最后几行,区分配置加载错误、端口占用和节点连接失败。不要连续点击启动按钮覆盖原始记录。记录错误发生阶段后,再到对应章节处理,定位速度会比逐项试开关更快。

DEEPER DIAGNOSIS

基础连接之外的系统化排查

节点超时、订阅解析、DNS、系统代理与客户端崩溃等问题,已在排查手册中按症状分章整理。本页保持四步上手路径,不展开复杂规则与底层参数。