QUICKSTART / 首次配置

V2Ray 使用教程
订阅导入与代理设置

导入订阅 → 选择代理模式 → 连接 → 验证是否生效。先完成一条连接,再调整分流与进阶设置。

适合首次使用的简短操作流程。开始前请准备客户端和有效订阅地址;安装包本身不包含可用服务器。

STEP 01 / SUBSCRIPTION

导入订阅

先确认手里的是订阅地址,还是单个服务器分享链接。订阅地址通常是一个用于获取配置列表的 HTTPS 链接;单条分享链接可能以 vmess://、vless:// 或 trojan:// 开头。两者的导入入口不同:本教程优先使用订阅分组,单条配置则使用“从剪贴板导入”。没有订阅时,不要把网站首页地址填进订阅栏。

还未安装客户端,可先到安装包页面选择适合设备的版本,安装或完整解压后启动。准备好配置后,关闭剪贴板共享或录屏中可能暴露订阅的窗口。订阅链接可能携带访问凭据,不要将完整链接发到公开讨论区,也不要在求助截图中保留二维码。

v2rayN:新增分组,再更新订阅

打开 v2rayN,在顶部“订阅分组”菜单中进入“订阅分组设置”,选择“添加”。在备注中填写一个方便识别的名称,将完整订阅地址粘贴到地址或 URL 栏,确认首尾没有多余空格与换行,然后保存。备注只用于区分来源,不会改变连接方式;暂时保留其他设置的默认值。

回到主窗口,选择刚创建的分组,再从“订阅分组”菜单执行更新订阅。首次连接尚未建立时,优先使用名称中带“不通过代理”的更新操作,前提是当前网络能够访问该订阅地址。更新结束后,服务器列表应出现条目。如果只有分组名称、列表仍为空,说明只保存了地址,还没有成功取得配置,不能继续把它当作已完成导入。

v2rayNG:添加订阅,再拉取列表

打开 v2rayNG,进入右上角菜单中的“订阅分组设置”,点击添加按钮,填写备注和订阅地址并保存。随后返回服务器列表,在菜单中选择更新订阅的操作。菜单提供更新范围时,可只更新刚添加的分组,避免其他来源的变化干扰首次设置。等待更新完成,再检查主界面是否出现可选服务器。

若拿到的是单条分享链接,先复制完整内容,再使用主界面添加菜单里的“从剪贴板导入”。不要将单条链接随意填入订阅地址栏。导入后打开条目编辑页,核对协议、地址和端口;例如 VLESS 配置还可能包含流控、传输层安全、SNI 与公钥等字段。只核对提供方给出的参数,不要凭协议名称自行补值。

这一阶段需要看到什么

完成标志是列表中出现服务器条目,而且客户端没有报告订阅解析失败。条目名称不代表可用性,导入成功也不代表远端服务正在工作。如果更新报错,先确认链接仍有效、系统时间准确,并区分“请求失败”和“格式不支持”。订阅格式与协议支持是两件事;不清楚术语时,可查看概念速查。列表就绪后,下一步先设置流量入口和路由,再开始连接。

STEP 02 / TRAFFIC MODE

选择代理模式

这里需要分清两个问题:程序怎样把流量交给客户端,以及客户端拿到流量后怎样决定去向。“系统代理”和安卓 VPN 模式主要解决入口问题,“路由”决定直连、代理或阻止等出站选择。把路由切为全局,并不能让所有桌面程序自动进入代理。首次配置建议使用简单入口,暂不同时开启 TUN、浏览器代理扩展和其他代理软件。

v2rayN:系统代理与路由分别设置

在 v2rayN 主窗口底部或托盘菜单找到“系统代理”,选择“自动配置系统代理”。这个选项会让客户端把本地代理地址写入当前系统的代理设置,浏览器等遵循系统设置的程序才会把请求发到本地监听端口。若使用的系统或桌面环境不能自动应用该设置,应按该环境的代理入口手动配置,不要假定菜单选中后所有程序都已接入。

接着查看“路由”选择项。若使用内置规则,新手可从“绕过大陆”等符合实际需要的规则开始;需要对照测试时,可临时选择全局代理规则,验证后再恢复日常分流。具体配置名称以当前规则列表为准。“全局”描述的是进入内核后的默认去向,不是更强的连接方式,也不会修复错误的服务器参数。

如果浏览器已经装有单独的代理扩展,先暂停扩展或切回使用系统代理,避免两层设置互相覆盖。本教程不要求修改本地监听端口。确实需要手动填写地址时,应从客户端当前设置中读取实际端口,并使用本机回环地址;不要从其他教程照抄一个数字后直接套用。

v2rayNG:选择 VPN 模式与路由规则

进入 v2rayNG 的设置,确认使用 VPN 模式,而不是仅提供本地代理端口的代理模式。VPN 模式会通过安卓系统的 VPN 接口接收符合配置的设备流量,第一次启动时系统会要求授权。这里的 VPN 授权是本地流量接管入口,不表示订阅已经有效,也不表示所有请求都会走远端服务器。

随后检查路由设置,选择适合日常使用的内置规则。第一次验证时,可先保留默认的分应用设置,不添加排除应用列表;否则测试浏览器若被排除,会出现客户端显示运行、浏览器却没有进入代理的情况。已有分应用配置时,应先确认测试应用属于当前接管范围,再继续下一步。

模式设置完成后,不急着改 DNS、Mux 或传输参数。首次目标是建立一条能解释清楚的连接路径。需要进一步理解系统代理、TUN 和分流关系,可阅读协议与内核技术参考;遇到具体界面或权限问题,可转到常见问题。接下来选择一个配置完整的条目并启动连接。

STEP 03 / CONNECTION

选择服务器并连接

先选一个配置来源明确、参数完整的服务器。首次操作不要连续切换多个条目,也不要同时修改协议与路由。这样若连接失败,可以确认问题发生在同一组条件下。服务器名称中的地区或用途只是提供方写入的备注,不能据此判断协议是否匹配或连接是否成功。

v2rayN:设为活动服务器,观察内核启动

在服务器列表中选中目标条目,通过右键菜单选择“设为活动服务器”;部分版本也支持双击条目完成选择,以菜单提示为准。确认列表的活动标记已经移动到该条目,再查看窗口下方的信息或日志区域。正常情况下,客户端会载入配置并启动对应内核;若显示端口占用或进程启动失败,此时还没有建立可用的本地入口。

如果订阅提供的是 VLESS 配合 REALITY 的配置,应使用支持该组合的内核,常见选择是 Xray。不要只因为界面提供切换项,就随意切到另一内核;客户端能显示字段,并不等于所有内核都接受相同配置。保留订阅自带参数,不自行开启 Mux,也不要将 TCP 随意改为其他传输方式。

活动服务器确定后,再检查“自动配置系统代理”仍处于预期状态。桌面客户端不一定提供单独的“连接”按钮,活动配置载入、内核启动和代理入口生效共同构成运行流程。关闭主窗口可能只是最小化到托盘;测试期间保留客户端运行,不要在浏览器打开前直接退出程序。

v2rayNG:选中条目,确认系统授权

在主界面点击目标服务器条目,确认选中标记,再点击底部连接按钮。首次启动会出现安卓系统的 VPN 连接请求,核对发起应用是 v2rayNG 后确认授权。若曾拒绝授权,返回客户端重新点击连接,不需要反复删除和重新导入订阅。系统提示已有其他 VPN 连接时,先确认是否可以停止另一个应用,再继续。

启动后查看客户端运行状态与系统 VPN 标识。它们只能说明本地接管服务已经启动,不能单独证明远端握手成功。部分设备会限制后台活动,首次验证阶段请让客户端保持前台,等连接确认后再按设备设置调整电池管理。不要一开始就同时更改后台权限、DNS 和路由,避免无法判断是哪项改变起了作用。

启动错误与远端连接错误分开看

本地端口被占用、权限不足和配置解析失败,应先在设备上处理;连接超时、认证失败或握手错误,则需要核对服务器可达性、账号有效性、系统时间与安全层参数。日志里出现错误时,记下发生时间和错误类型,不要公开包含订阅凭据的整段内容。没有启动错误后,进入最后一步,用真实访问验证,而不是只看连接图标。

STEP 04 / VERIFICATION

验证代理是否生效

验证要同时回答“能否访问”和“是否走了预期路径”。网页能打开,可能是路由规则选择了直连;客户端显示运行,也可能只是本地服务已启动。首次检查请使用刚才选定的同一个服务器、同一种网络和同一套模式,避免测试过程中频繁切换条件。

先检查浏览器,再核对连接记录

重新打开一个浏览器窗口,访问平时已知可用的 HTTPS 网站,并刷新页面。不要只看已经打开的标签页,因为浏览器缓存和旧连接可能保留之前的结果。先确认页面内容能实际刷新,再打开另一个独立网站复测;单一网站打不开,不能直接推断整条代理链路失败。

接着查看客户端连接记录或日志,观察测试时刻是否有对应请求,以及当前日志级别是否显示路由或出站信息。若日常日志不包含逐条请求,不必把“没有详细记录”当作故障;可按客户端提供的诊断选项临时增加记录,测试后恢复。外部 IP 查询只能作为辅助证据,因为直连规则、出口共享和查询站点本身都会影响判断。

区分浏览器正常与其他应用正常

在 v2rayN 上,浏览器成功后再打开需要使用的其他应用。若只有某个应用失败,先确认它是否遵循系统代理,或是否有自己的代理设置。系统代理不会自动覆盖所有程序;确有接管更多流量的需求时,再学习 TUN 的权限与路由要求,不要为解决一个应用的问题立即改动整套订阅。

在 v2rayNG 上,先确认测试应用没有被分应用规则排除。如果应用在连接前已经运行,可完全关闭后重新打开,让它建立新连接。浏览器正常而某个应用异常时,也可能与应用自己的 DNS、连接复用或协议有关,应单独检查。先完成浏览器基线测试,再处理个别应用,比同时更改多个选项更容易定位。

停止连接,确认退出行为

完成测试后,在 v2rayN 中先选择“清除系统代理”,再退出客户端。若只是停止内核、系统代理却仍指向本地端口,浏览器可能因找不到本地服务而无法访问。清除后检查网络是否恢复预期行为;如果设备原本使用单位或其他程序配置的代理,应提前记下原设置,并按实际需求恢复。

在 v2rayNG 中点击停止连接,确认系统 VPN 标识随之消失,再重新打开测试页面。停止前后的结果应结合路由理解:本来走直连的网站可能没有明显变化,这属于正常现象。断开测试的目的是确认客户端的接管与退出行为,而不是要求每个页面都出现截然不同的结果。

验证失败时,按顺序缩小范围

若所有网页都无法打开,先看本地入口是否启动、系统代理或 VPN 授权是否生效,再核对活动服务器和日志。若只有域名访问异常,再检查 DNS 与路由;若只有一个条目失败,可在保留模式不变的前提下换一个配置验证。每次只调整一项,并记录调整前后的现象,不要先清空全部配置。

订阅可更新、服务器已选中、客户端运行正常、浏览器能刷新且请求路径符合预期,才算完成首次配置。之后可以恢复日常分流规则,再按需要补充应用范围设置。更完整的异常检查见常见问题;协议字段和内核兼容性见技术参考。本教程到这里结束,下一次使用通常只需确认活动服务器、启动入口并做一次简短访问测试。