quickstart
V2Ray 使用教程:订阅与连接
导入订阅 → 选择代理模式 → 启动连接 → 验证流量。首次配置按顺序完成,后续通常只需更新订阅与切换节点。
开始前,先从下载页选择适合设备的客户端并完成安装。准备一条由服务提供方提供的有效订阅链接,确认设备时间与时区正确,并让普通网络保持可用。客户端负责读取配置和建立连接,不会自动提供远程服务器;尚未取得订阅或节点配置时,先补齐这一项,再继续操作。
这是一条面向首次使用的短流程。首次配置可按约十分钟安排,但订阅更新与连接测试会受网络状态影响。先使用默认本地端口,不同时开启 TUN、不批量修改 DNS,也不叠加多个代理工具。保持变量少,出现问题时才容易分清是订阅、节点还是应用设置造成。需要完整原理和进阶配置时,再阅读V2Ray 使用手册。
01 订阅导入:先建立分组
订阅链接通常指向一份可更新的节点配置集合,不是需要在浏览器中登录的网页。复制时应取完整地址,避免把前后的说明文字、空格或换行一起带入。如果链接来自二维码或消息窗口,先确认复制的是订阅地址,而不是某个单独节点的分享链接。两者都能导入配置,但后续更新方式不同;概念不清时可查看订阅与节点术语。
v2rayN:添加地址,再更新订阅
打开 v2rayN,在顶部找到“订阅分组”相关菜单,进入“订阅分组设置”。新增一条分组记录,在备注栏填一个便于辨认的名称,例如“日常连接”,再把完整订阅地址粘贴到地址栏。其他筛选或自动更新选项先保持默认,保存后关闭设置窗口。此时只是记住了地址,主界面尚未出现节点也属于正常情况。
返回主界面,在订阅菜单中执行更新。如果已有多个分组,优先选择刚添加的分组更新,避免同时改动其他节点来源。第一次配置还没有可用代理时,通常先选“不通过代理”的更新方式;只有当前已存在可用连接,并且订阅地址需要借助该连接访问时,才考虑“通过代理”。不要在代理尚未启动时反复选后者,否则更新请求可能一直失败。
观察日志或状态提示,等待更新完成,再切到对应分组。节点列表应出现名称、地址、端口或协议等记录。数量没有固定标准,应以服务提供方的配置为准。如果更新提示成功但列表为空,先检查是否停留在其他分组、是否启用了名称筛选,再检查订阅地址是否仍有效。此阶段只确认配置已读入,不需要同时修改节点的传输、安全层或认证字段。
v2rayNG:从订阅分组设置添加
在 v2rayNG 中打开侧边菜单或相关菜单,进入“订阅分组设置”,通过添加按钮新建分组。填写备注与订阅地址并保存,返回节点主界面,再从右上角菜单执行“更新订阅”;部分版本会标为“不通过代理更新订阅”或提供分组范围选择。与桌面端一样,保存地址不等于已经下载配置,必须完成更新才能看到节点记录。
如果手中只有单个节点分享链接,可复制后使用“从剪贴板导入”一类入口;二维码则使用扫描入口,并按系统提示授予必要权限。单节点导入不具备订阅分组的自动更新关系,服务端改动后可能需要重新导入。不要为同一条订阅同时创建多个重复分组,以免更新后列表混杂,误选已经失效的旧记录。
完成这一阶段的判断很简单:对应分组内已有节点,更新日志没有持续报错。接下来先决定哪些应用流量进入客户端,以及进入之后采用哪套路由;不要把“已导入”直接理解成“已连接”。
02 代理模式:区分入口与出口
桌面端的“系统代理”和“路由模式”是两个不同层次的设置。系统代理告诉遵循系统设置的应用,把请求交给本地客户端;路由模式决定客户端收到请求后,是通过远程节点转发,还是直接连接目标。即使路由选了全局,未使用系统代理或未单独配置代理的应用,也不一定会进入客户端。理解这一点,可以避免“全局已经打开,为什么某个应用没有变化”的误判。
v2rayN:先用日常路由,再配置系统代理
在底部状态栏或路由菜单中找到路由设置。普通网页浏览可先选择“绕过大陆”或名称相近的预设,让预设规则匹配的流量直连,其余按该预设的出口处理。实际命中结果取决于规则内容和所用分类数据,并非只根据网页语言判断。首次上手先用现成预设,不自行添加域名规则;规则顺序与 DNS 关系留到路由分流章节再处理。
接着找到“系统代理”,选择“自动配置系统代理”。这会把系统中的代理入口指向客户端本地监听地址。Windows 中常见的入口位于托盘菜单或底部状态栏;Linux 与 macOS 的桌面环境、权限和系统接口可能影响自动设置结果。如果选择后浏览器没有变化,应打开系统网络代理设置,核对是否已经写入本地地址,而不是重复切换路由。
Linux 桌面如果需要手动配置,可在系统网络设置中把代理方式改为“手动”,将 SOCKS 主机填写为 127.0.0.1,端口填写客户端实际的 SOCKS 监听端口。不要把远程节点地址填在这里。若系统要求 HTTP 或 HTTPS 代理字段,应使用客户端明确提供的 HTTP 或混合监听端口,不凭经验把 SOCKS 端口复制过去。本文后面的命令使用 10808 作为示例,实际值以客户端设置为准。
v2rayNG:路由设置与 VPN 接管
安卓端进入设置中的路由选项,选择适合日常使用的绕过规则。某些版本会把路由预设放在“预定义规则”中;寻找设置含义即可,不必逐字对照桌面名称。此时先不要开启按应用代理或调整应用排除名单,因为被排除的应用可能始终直连,增加首次验证的难度。稍后启动连接时,安卓系统会通过 VPN 接口把符合条件的流量交给客户端。
“全局”可以用于短暂对照测试:当某个网站在日常路由下失败时,切换到全局并重新建立请求,观察结果是否变化。如果全局可访问而日常路由不可访问,才进一步检查规则或解析路径。测试结束后恢复原来的路由。全局不是修复失效节点的开关,也不能让未进入客户端的桌面应用自动使用代理。
到这里,订阅已经准备好,流量入口和路由也有了明确选择。下一步只选一个节点启动,先验证一条完整路径;多内核切换、TUN 与复杂分流暂时保持原状。
03 启动连接:选定活动节点
回到节点列表,优先选择服务提供方明确说明可用、且协议参数已完整导入的记录。首次连接不必对所有节点进行连续测试,也不需要仅凭节点名称判断质量。列表中的测试结果只能反映特定测试方法下的表现,不能代替目标应用的实际访问。如果订阅内有多种协议,先使用默认导入配置;关于协议与传输的区别,参见协议概念速查。
v2rayN:设为活动服务器并查看日志
在目标节点上打开右键菜单,选择“设为活动服务器”或相近选项,部分版本也支持双击节点。确认主界面的选中标记或状态栏已指向这条记录。v2rayN 通常会随活动服务器变化生成运行配置并启动或重启内核,不一定另有一个醒目的“连接”按钮。因此要看日志与当前服务器状态,而不是寻找和安卓相同的操作外观。
打开日志区域,检查是否出现配置读取失败、端口被占用、权限不足或内核进程退出的提示。没有这些启动错误后,再确认系统代理仍为自动配置状态。切换节点可能让已有连接中断,测试时最好重新打开网页或重新发起请求,不要只观察此前已经加载完的页面。此处也无需打开“允许来自局域网的连接”,同一设备上的浏览器通常使用回环地址即可。
v2rayNG:选择记录并确认 VPN 授权
点击需要使用的节点,确认选中标记已经改变,再点击主界面的连接按钮。首次运行会弹出安卓系统的 VPN 连接请求,核对请求来自正在使用的 v2rayNG 后确认授权。连接按钮状态改变、系统出现 VPN 指示时,说明本地接管已经启动,但远程节点是否可用仍要通过下一步访问测试确认。
如果另一款应用正在占用系统 VPN,先断开它,再启动 v2rayNG。通常同一用户环境中不能让两个普通 VPN 服务同时接管;频繁来回启动容易造成刚连接又断开的现象。若切回浏览器后连接很快停止,再查看安卓电池与后台运行限制,按设备设置允许客户端保持运行。不要一开始就修改所有省电选项,只针对确实出现的后台中断处理。
连接失败时先留意错误发生的位置。如果内核根本无法启动,先解决本地端口或权限问题;如果能启动但请求超时,再检查当前网络与节点是否可用;如果日志明确提示配置字段不支持,核对所选内核与节点协议的兼容性。不要为了碰运气同时改端口、路由、DNS 和协议,否则即使恢复也难以复现原因。具体错误可对照疑难解答处理。
当活动节点正确、内核运行没有持续错误、系统代理或 VPN 入口已启用后,配置链路才算准备完成。接下来使用真实应用确认请求路径。
04 验证生效:应用与日志对照
首先用准备实际使用的浏览器打开一个目标网站,再打开一个普通可访问的网站作为对照。不要只刷新已有标签页,因为缓存、连接复用或后台预加载可能让观察结果失真。可以新建窗口重新请求,并在同一时段查看客户端日志。如果网页成功打开且日志记录了相应请求,说明这次应用请求进入了客户端;是否走远程节点,还要结合命中的路由与出口标签判断。
桌面端:单独测试本地 SOCKS 入口
如果浏览器打不开,先用命令把“客户端连接”与“浏览器系统代理”拆开检查。确认客户端设置中的 SOCKS 监听端口;下面以 127.0.0.1:10808 为例,端口不同就替换为实际值。命令中的 socks5h 会把目标域名交给代理侧处理,适合检查这条明确指定的请求路径。终端需要已安装 curl,命令不依赖浏览器是否遵循系统代理。
curl -x socks5h://127.0.0.1:10808 -I https://www.example.com
如果返回 HTTP 响应头,说明这个目标上的显式 SOCKS 请求已经得到响应;它不代表所有应用或全部网站都正常,也不保证当前路由一定使用了远程出口。若提示无法连接到本地地址,优先检查客户端是否仍在运行以及端口是否一致。Linux 上还可以查看监听情况,确认本地端口是否存在,再回到客户端日志寻找启动错误。
ss -tlnp
在输出中查找客户端实际使用的端口;部分进程信息可能受权限限制,缺少进程名称不等于端口未监听。如果命令可访问而浏览器不可访问,重点检查系统代理是否写入成功,以及浏览器是否另设了代理扩展或独立网络配置。有些终端程序不读取桌面系统代理,需要单独配置,不能拿这类程序的失败直接判定客户端失效。
安卓端:检查目标应用是否进入 VPN
保持 v2rayNG 连接,切到浏览器重新访问目标网站,再返回客户端查看日志。如果某个应用失败而浏览器正常,检查是否启用了按应用代理,目标应用是否在排除名单中。也要考虑应用自身的网络限制。若所有应用都失败,可暂时换一个已知可用节点再测试;仍无变化时,先核对设备时间和基础网络,再按故障排查问题逐项检查,不急于反复重装。
常见现象可以按路径归类:本地端口连接失败,多半需要先检查运行状态与端口;显式 SOCKS 可用但浏览器失败,先看系统代理;全局可用但日常路由失败,先看规则与解析;只有部分应用失败,先看应用自身配置。DNS 的深入处理见DNS 设置章节。每次只调整一项,重新发起请求并记录结果,再决定是否继续。
结束使用:清除入口,再停止连接
桌面端结束使用前,选择“清除系统代理”,再退出 v2rayN;如果曾手动修改 Linux 网络代理,也要在系统设置中恢复原有方式。仅关闭主窗口可能只是缩到托盘,未必停止运行。反过来,如果内核已停止但系统代理仍指向本地端口,遵循该设置的应用可能无法联网。安卓端点击断开按钮,并确认系统 VPN 指示消失即可。
最后再打开一个普通网站,确认恢复后的网络访问正常。首次配置完成后,保留已验证的分组、节点与路由组合;日常使用从更新订阅、选择活动节点开始。遇到新的问题,先回到四步中的对应环节检查。需要学习规则编写、TUN 或日常维护时,再进入完整使用手册,不必在首次连接时一次配齐全部功能。