使用文档 · 首次连接

v2rayN 使用教程

订阅导入 → 选择代理模式 → 启动连接 → 验证请求路径。按四步完成首次配置,再处理进阶设置。

准备好客户端与有效订阅后,可按约十分钟的操作顺序推进;订阅下载和网络排查所需时间取决于实际环境。

开始前,先确认客户端能够打开,并准备一条有权使用、仍在有效期内的订阅地址。客户端负责读取配置、运行内核并提供本地代理入口,本身不提供可直接连接的服务器。订阅地址通常来自服务提供方的管理页面,它与登录页面、购买页面不是同一个地址。若尚未安装客户端,先到下载页按系统选择安装包;安装权限、运行环境和平台差异见安装大全。

第一次配置时,先关闭其他正在接管网络的代理工具,保留一份当前网络设置记录。不要同时启用多套系统代理或多个 VPN 连接,否则后续很难判断请求交给了哪个程序。本教程先完成浏览器连接,不要求一开始就配置 TUN、自定义路由或终端环境变量。遇到术语可查术语表,已有明确报错时可转到帮助中心。

第一步:导入订阅并更新服务器

在 v2rayN 中新增订阅分组

打开 v2rayN,在顶部菜单找到“订阅分组”,进入“订阅分组设置”,再选择“添加”。在备注栏填写便于辨认的名称,例如“日常订阅”;在地址栏粘贴完整订阅 URL。备注只用于本地识别,不改变订阅内容。粘贴后检查地址开头和结尾,避免把换行、空格或聊天软件附带的文字一起放进去。下面的地址仅用于说明填写位置,不能用于实际获取服务器。

https://example.com/sub?token=xxxx

保存分组设置,返回主窗口,再从“订阅分组”菜单执行更新订阅。首次使用、尚未建立可用连接时,通常先尝试“不通过代理”的更新方式;如果该地址只能经已有的代理连接访问,才考虑“通过代理”更新。具体菜单名称可能带有“当前订阅”或“全部订阅”,只更新刚创建的分组更便于确认结果。添加地址不等于已经获取配置,必须完成这次更新。

更新结束后,切换到对应分组,主区域应出现服务器记录。检查记录是否属于刚添加的分组,并留意客户端底部日志是否提示下载失败、解析失败或未获取到内容。若显示成功但列表仍为空,先取消列表筛选,再确认订阅是否过期或返回了登录页面。不要反复点击更新,也不要为了让空列表出现内容而随意改变内核设置;这些操作不能修复错误地址。

在 v2rayNG 中完成对应操作

打开 v2rayNG 的右上角菜单,进入“订阅分组设置”,点击添加入口,填写备注与订阅地址后保存。回到主界面,打开菜单执行“更新订阅”;若版本提供不同的更新方式,首次同样先使用直接访问订阅地址的方式。看到服务器记录后,核对当前分组。若手里拿到的是单条协议分享链接,而不是订阅 URL,应使用“从剪贴板导入”等对应入口,不能把两种内容混填。

订阅地址可能包含访问凭据,不要放入公开截图或发送到不明转换页面。排查时可只提供报错文字,并遮盖地址中的令牌部分。此步骤完成的标志是“目标分组内已经有可选服务器”,不是“表单已经保存”。确认这一点后,再进入模式选择,避免在配置尚未载入时调整网络入口。

第二步:选择代理模式与路由

先区分入口与分流规则

v2rayN 中容易混淆的是“系统代理”和“路由模式”。系统代理决定遵循系统设置的应用是否把请求交给客户端;路由模式决定内核收到请求后选择代理、直连还是拦截。选择“全局”并不意味着电脑上的所有程序都会自动接入,选择“绕过大陆”也不意味着系统代理已经开启。先确定路由,再在下一步启用入口,操作顺序会更清楚。

在主窗口的路由选择区域,或设置中的路由入口,选择符合当前需求的内置预设。日常首次验证可以使用“绕过大陆”这一类分流预设,使匹配直连规则的请求直接连接,其余请求按预设处理;“全局”通常用于让进入该入口的请求统一选择代理出站;“直连”则不适合用来验证代理服务器是否工作。各版本预设名称和具体规则可能不同,选择前可查看规则内容,不要只根据名称推断每一个域名的去向。

第一次连接先保留默认路由规则和数据文件,不必立即编辑 JSON。若某个目标被分到直连,其他目标却正常,问题可能在规则匹配而不是订阅。此时先记录目标域名与日志中的出站结果,再查路由分流相关术语。本教程不要求修改规则排序,完整的规则设置与平台准备工作放在安装大全中继续处理。

首次测试暂不叠加 TUN

TUN 是另一种接管流量的入口方式,涉及虚拟网络接口、路由和权限。为了让故障范围可控,桌面端第一次先用系统代理验证浏览器,暂不启用 TUN。等基础连接成立后,若某个应用不读取系统代理,再单独评估应用内代理或 TUN。不要同时更改 DNS、路由预设、内核和入口方式,否则一次失败可能对应多个原因。

v2rayNG 中进入“设置”查看路由相关选项,首次使用可先选用合适的内置预设。如果以前启用过“分应用代理”,还需要检查浏览器是否被包含在接管范围内。注意该设置可能采用“只代理选中应用”或“绕过选中应用”的不同语义,应阅读当前开关说明,不能仅凭勾选状态判断。确认路由与应用范围后,回到主界面选择服务器。

第三步:选择当前服务器并启动连接

桌面端启用系统代理

在 v2rayN 的服务器列表中选择一条配置,打开右键菜单并执行“设为活动服务器”。部分版本也可通过双击完成选择,以当前活动标记为准。列表中出现记录不代表它已成为当前连接目标;如果切换后仍使用旧服务器,先检查活动标记是否真的改变。首次测试只选一条配置,避免在结果尚未确认前连续切换多条记录。

随后在主窗口底部或托盘菜单中找到系统代理选项,选择“自动配置系统代理”。保持 v2rayN 运行,并查看日志区域是否出现内核启动异常、端口占用或配置解析错误。不同版本可能在选中服务器后自动重载内核,不一定另有“连接”按钮;判断重点是当前配置是否加载,以及本地入口是否成功监听,而不是寻找某个固定图标。

  • 自动配置系统代理:把当前本地入口写入系统代理设置,供遵循该设置的应用使用。
  • 清除系统代理:清除相应的系统代理设置,适合停止使用时恢复入口。
  • 不改变系统代理:不主动改写系统设置,并不等于把之前设置过的代理自动清掉。

本地端口以客户端当前设置为准。若界面显示 10808,排查时就检查这一端口,不要从旧教程照抄其他数字。端口对应的协议类型也应从当前入站设置确认,不能把 HTTP 与 SOCKS 入口混用。若日志显示端口被占用,先退出旧的客户端进程,再重新启动当前实例;仍有冲突时再调整端口,并同步检查相关入口设置。

安卓端启动并确认系统授权

在 v2rayNG 主界面点击要使用的服务器,使它成为选中项,再点击连接按钮。首次启动时,系统会要求确认 VPN 连接权限,阅读提示后允许。这里使用的是系统提供的网络接管接口,不需要另外购买一个 VPN 应用。若设备已有其他 VPN 连接,通常需要先停止原连接,再让 v2rayNG 接管。

启动后观察主界面的连接状态与系统通知。显示已启动只说明本地接管已经建立,还不能证明远端服务器可达。若按钮立即恢复停止状态,先查看日志中的配置或权限报错,不要直接更换路由。设备的后台限制也可能使连接在锁屏后停止,首次验证先保持应用在前台,待连接确认正常后再处理后台运行设置。

到这里,订阅、活动服务器和本地入口应当已经就绪。下一步必须从实际应用发起请求,并结合日志验证,不能仅凭托盘图标变化或连接按钮变色就结束配置。

第四步:验证是否生效并恢复设置

把页面结果与客户端日志对应起来

打开浏览器的新标签页,访问一个按当前规则应经过代理的 HTTPS 页面。优先使用正常内容页面,而不是刚才已经打开的缓存页面。观察是否能够完成加载,同时查看客户端日志或连接信息中是否有对应目标的请求,以及最终选择的出站。若当前日志级别不展示访问记录,可在需要时临时提高记录级别,测试后恢复;分享日志前应隐藏服务器地址和凭据。

接着访问一个按规则应直连的页面,检查它是否也正常。分流模式下,两个目标可能使用不同出站,这正是预期行为。仅仅看到一个网页能打开,不能证明所有应用都经过代理;只查看出口地址,也不能反推出每条连接的完整路径。更可靠的判断是把目标域名、测试时间和客户端记录放在一起核对,并确保没有其他代理扩展接管浏览器。

客户端提供的连接测试可以辅助判断服务器是否响应,但测试通过并不保证浏览器设置正确,测试失败也需要结合所用测试地址判断。若只有浏览器失败,先查看浏览器代理扩展、独立代理设置或已有连接缓存,必要时完全退出浏览器再重开。若所有请求都失败,则回看内核启动日志、当前活动服务器和订阅有效期,按出现问题的环节逐项排查。

单独核对其他应用与安卓接管范围

终端和部分桌面应用可能不读取系统代理,所以浏览器成功、终端失败并不矛盾。不要因此反复更新订阅或更换内核;应先检查该应用自己的代理入口。终端环境变量与应用内代理属于进一步配置,可按帮助中心的对应问题处理。首次验收只需确认一个遵循系统代理的浏览器能够按预期路由,再扩大接管范围。

安卓端同样用浏览器发起实际请求,并确认它没有被分应用规则排除。若 v2rayNG 显示连接中,但浏览器没有对应请求,先检查接管范围、其他 VPN 状态以及应用自身设置;若已有请求但连接超时,再检查远端配置和网络条件。每次只修改一项,然后重新访问同一个目标,这样才能判断是哪项调整产生了影响。

停止使用与下次启动

桌面端停止使用前,先选择“清除系统代理”,再退出客户端。如果直接结束进程,系统仍可能指向已经停止的本地端口,表现为浏览器突然无法访问。遇到这种情况,重新打开 v2rayN 清除设置,或在系统网络设置中检查代理开关。受组织策略管理的设备应遵循原有网络配置,不要随意覆盖管理方要求的代理设置。

安卓端点击连接按钮停止连接,并确认系统 VPN 状态已经结束。下次使用通常不需要重新添加订阅:先按需更新分组,确认当前服务器,再启动连接即可。若服务提供方更换订阅地址,再修改原分组,避免重复创建多组相同记录。桌面客户端也应保留已验证的路由预设,不必每次从头调整。

若四步中某一环节仍未完成,带着明确现象继续查找:启动前失败看安装与权限,更新失败看订阅地址,连接失败看内核日志,单个应用失败看入口与分流。具体故障见帮助中心;系统要求、安装路径和平台特有设置见全平台安装大全。先保留能工作的基础配置,再逐项增加功能。