客户端使用文档

v2rayN 使用教程
订阅导入与连接验证

按四步完成首次配置:导入订阅、选择代理模式、启动连接、验证访问。已准备好客户端和有效订阅时,可按约十分钟的操作路径完成;遇到错误先停在当前步骤检查,不必反复重装。

订阅分组 系统代理 路由预设 实际访问验证

开始前:确认安装与订阅来源

先从安装包页面选择适合设备的客户端,完成安装后打开主界面。首次启动看到空服务器列表属于正常情况,客户端本身不附带可直接使用的服务器。需要准备由服务提供方交付的订阅地址,或者一条完整的服务器分享链接,并确认相应服务仍在有效期内。

订阅地址通常是一个网络地址,更新后可生成多个服务器配置;分享链接则常以协议名称开头,通常对应单条配置。两者应使用不同入口导入。订阅中可能包含访问凭据,请不要把完整地址发到公开讨论区,也不要在截图中保留地址内容。还应确认设备能够正常联网,系统日期与时间准确,并暂时退出其他正在接管网络的工具,减少相互覆盖设置的情况。

本教程先完成最短可用路径,不要求手动编辑配置文件,也不要求先启用虚拟网卡。若尚不清楚入站、出站或订阅的含义,可随时查阅V2Ray 术语表,然后回到当前步骤继续。

步骤 01 · 配置来源

导入订阅:保存地址后执行更新

v2rayN:添加订阅分组

在主界面打开“订阅分组”菜单,进入“订阅分组设置”,新增一个分组。备注填写便于辨认的名称,例如“日常使用”,再把完整订阅地址粘贴到地址栏中。检查开头、结尾是否多出空格或换行,确认没有只复制到网页中的一部分文字,然后保存。这里保存的是获取配置的入口,保存完成并不等于已经取得服务器条目。

返回主界面,再从订阅分组菜单执行“更新订阅”,首次配置优先使用名称中带“不通过代理”的更新方式,因为此时尚未建立可用的代理连接。更新完成后,切换到刚建立的分组,查看服务器列表是否出现名称、地址或协议等字段。只要列表确实生成了可选配置,就可以进入下一步;此时不必逐条修改协议参数。

v2rayNG:保存订阅后返回主界面更新

打开侧边菜单中的“订阅设置”,点击新增按钮,填写备注和订阅地址并保存。随后回到服务器列表,从右上角菜单执行“更新订阅”。部分版本会针对当前分组更新,另一些版本会提供统一更新入口,因此操作前先确认当前选中的分组。更新成功后,主界面应出现可点选的服务器条目,而不是仅在订阅设置页多出一行地址。

如果服务提供方给的是一条服务器分享链接,先复制完整内容,再使用客户端的“从剪贴板导入”入口。不要把单条分享链接直接填入需要网络请求的订阅地址栏。通过这种方式导入的配置通常不会随订阅分组自动更新;服务端参数变化后,需要重新获取对应配置。

列表为空时先检查更新结果

若提示下载失败,先核对地址是否仍有效、当前网络是否能访问该订阅服务,以及服务提供方是否要求额外登录。若提示解析失败,可能取得的是登录页、错误提示页或不受支持的订阅格式,而不是配置内容。不要连续删除并重建分组;先阅读更新提示,再向提供方确认可用于当前客户端的订阅格式。

订阅只有通过已有代理才能访问时,应先准备一条可用的单独配置,连接成功后再尝试通过代理更新。订阅地址并不能凭空解决自己的访问前提。确认服务器条目已经出现后,接下来设置流量怎样进入客户端,以及进入后采用哪种路由。

步骤 02 · 流量入口

选择代理模式:区分接管方式与路由

“系统代理”和“路由模式”解决的是不同问题。前者决定应用如何把连接交给客户端,后者决定客户端收到连接后,是直接访问还是使用代理出站。只修改路由而没有让应用接入客户端,浏览器可能仍沿原来的网络访问;只开启系统代理,也不代表全部连接都会选择代理出站。

v2rayN:先使用系统代理完成首次配置

在设置中查看本地监听地址和端口,保留默认值通常更容易排查。随后在主界面底部状态栏或托盘菜单找到“系统代理”,选择“自动配置系统代理”。这一操作会把系统中的相关代理设置指向本地客户端,遵循系统代理设置的浏览器和应用才会使用该入口。不要把远端服务器端口误填为本地代理端口,它们处于连接路径的不同位置。

“清除系统代理”用于撤销接管;“不改变系统代理”则表示客户端不主动改写系统设置,不等同于自动关闭已有代理。首次使用时,建议明确选择自动配置,而不是让上一次运行留下的设置决定当前行为。暂时不启用 TUN 等额外接管方式,先验证系统代理路径,可以减少权限、路由和虚拟网卡相关变量。

接着检查路由预设。日常可先选择“绕过大陆”一类预设,让匹配的中国大陆目标按规则直连,其他连接再按预设处理。若需要短暂确认代理出站是否可用,可切换到“全局”进行对照,测试后再恢复适合日常使用的规则。具体匹配仍取决于预设内容与规则顺序;全局路由也不等于系统内所有应用都会被接管。

v2rayNG:确认 VPN 模式与分应用设置

在 v2rayNG 的设置中确认使用 VPN 模式,而不是仅提供本地代理端口的模式。VPN 模式通常可让安卓应用通过系统接口进入客户端,无需逐个在应用内填写代理地址。如果之前设置过分应用代理,先检查测试用浏览器是否被排除;初次配置可暂时不设置复杂的应用名单,待连通后再缩小接管范围。

路由先保留客户端默认配置,或选用与需求相符的绕过规则。此时不要同时调整 DNS、自定义规则和分应用名单,否则下一步访问失败时很难判断是哪一项造成的。端口示例 socks 10808、http 10809 仅用于理解本地入口,实际值以当前客户端显示为准。有关规则优先级和协议选型,可在完成连接后阅读协议手册,这里先保持设置简单。

步骤 03 · 活动配置

启动连接:选定服务器并检查运行状态

v2rayN:将一个条目设为活动服务器

回到服务器列表,选择服务提供方建议使用的条目。通常可以通过右键菜单中的“设为活动服务器”完成切换,部分版本也提供双击等快捷操作。操作后查看列表中的活动标记或状态栏,确认当前配置确实指向刚选择的条目,而不是仅选中了列表中的一行。首次测试固定使用一个条目,不要在页面加载期间连续切换。

v2rayN 通常会在设置活动服务器后应用配置并启动或重启内核,不一定存在与手机端相同的大型连接开关。查看底部状态与日志区域,确认没有持续出现配置解析失败、监听失败或内核退出等错误。若提示端口被占用,先检查是否重复运行了客户端,或者另一个程序正在使用同一端口;修改端口后,还需要让系统代理同步指向新的本地入口。

有些协议需要特定内核能力。如果日志明确提示协议或安全层字段不受支持,应核对当前配置要求的内核,不要靠随意更改加密或传输选项尝试启动。尤其是含 REALITY 的配置,应确认客户端使用支持它的内核,并保留服务提供方给出的参数。常见内核关系可查阅术语表中的内核与客户端分类。

v2rayNG:点选条目后开启连接

在主界面点选目标服务器,确认选中标记已经移动,再点击连接按钮。首次启动通常会出现系统 VPN 连接请求,核对应用名称后允许。授权完成后,主界面应切换到运行状态,系统状态栏也可能显示 VPN 标识。如果授权窗口被取消,单独选中条目并不会建立系统接管,需要重新点击连接并完成授权。

如果设备上已有其他 VPN 连接,新的连接可能替换原有连接,或者受到设备管理策略限制。先停止其他网络接管工具,再重新测试当前客户端。连接按钮没有保持运行状态时,应先打开日志查看启动原因,而不是反复导入同一份订阅。

至此,“已启动”只表示本地服务进入运行状态,尚不能证明远端服务器可用。部分代理连接只有在应用真正发出请求后才建立,因此启动时没有报错也不足以完成验证。下一步需要实际打开网页,同时观察客户端是否收到流量。

步骤 04 · 实际访问

验证是否生效:网页访问与日志对照

先发出新请求,再确认对应出站

打开浏览器,新建标签页访问一个已知可用的网站,随后再访问一个按当前路由应由代理处理的目标。不要只观察已经打开的页面,因为页面内容可能来自缓存,既有连接也可能沿用切换前的路径。测试时先使用普通网页,避免同时启动大文件下载,以便清楚对应某次请求与日志记录。

回到客户端查看日志;如果当前日志级别不显示访问记录,可临时按设置开启相应记录。留意新请求是否进入、目标域名是什么、使用哪个出站,以及是否出现连接超时或解析失败。分享日志前,应隐去订阅地址、服务器凭据和其他个人信息。访问成功并且记录显示走了预期出站,才说明当前测试目标的路径符合设置。

内置延迟测试可辅助比较同一测试方式下的条目表现,但不能单独作为连接成功的依据。不同测试入口可能测量握手、网页请求或其他环节;一次有结果不代表所有网站均可访问,一次超时也可能与测试目标有关。首次配置以实际页面加载和出站记录为主,不必为了最小的测试数值反复切换。

网页打不开时按连接路径逐项检查

先看客户端有没有收到请求。完全没有对应记录时,桌面端检查系统代理是否仍为自动配置、本地监听端口是否一致,以及浏览器是否设置了独立代理;安卓端检查 VPN 是否仍运行、浏览器是否被分应用规则排除。系统代理对不遵循该设置的应用不一定有效,因此不能用一个应用的结果直接推断所有应用。

有请求但出站不符合预期时,先确认路由预设。可以临时切换全局路由,对同一目标重新发起请求;如果访问恢复,问题更可能在规则匹配,而不是服务器配置本身。此时记录目标与命中的规则,再恢复原设置,之后按协议手册的相关说明检查,不要直接删除全部路由。

请求已进入代理出站却失败时,继续检查错误类型。域名解析失败应核对当前 DNS 设置和设备基础网络;握手或认证失败应核对系统时间与订阅参数;持续连接超时可换一个已知有效的条目作对照。每次只修改一项,再发起同样的请求,才能判断改动是否有效。若所有条目都失效,再联系服务提供方确认账号、流量额度及服务器状态。

最后测试停止与网络恢复

完成验证后,也应知道如何退出。v2rayN 可先选择“清除系统代理”,再退出客户端,避免系统继续把请求发往已经停止的本地端口;如果原先有自定义系统代理,应恢复原配置。v2rayNG 点击停止按钮,确认 VPN 运行状态结束,再测试普通网络是否恢复。

首次配置完成后,记住可用分组、活动服务器和路由预设即可,不需要立即开启全部高级功能。日后发现服务器条目变化,先更新订阅;只有部分网站异常,先检查路由;所有应用都无法访问,再回到接管方式与基础网络逐项核对。这样能把问题定位在具体环节,而不是每次从安装开始重做。

v2rayN下载