使用文档 · 初次配置

v2rayN 配置教程

订阅导入 → 代理模式 → 启动连接 → 验证生效。按四步走完首次使用流程。

开始前,先确认客户端能够正常打开,并准备一条有权使用的订阅地址,或一条有效的单项配置分享链接。客户端负责读取配置与转发流量,本身不会自动生成可连接的服务端。还没有安装客户端时,先到客户端下载页选择对应安装包,完成安装后再回到本页。首次配置建议保持默认参数,只修改下面明确提到的设置,方便在出现问题时定位到具体一步。

本页以订阅地址为主线。订阅地址通常用于获取一组配置,分享链接通常只包含一项配置,两者的导入入口并不相同。复制时保留完整内容,避免把说明文字、换行或聊天消息中的标点一并复制。订阅地址可能包含个人认证信息,不要发到公开讨论区,也不要把二维码或完整地址留在截图里。

01 导入订阅并更新配置

v2rayN:先保存分组,再更新订阅

打开 v2rayN,在顶部“订阅分组”菜单中进入“订阅分组设置”,新增一个分组。备注填写便于辨认的名称,随后把订阅地址粘贴到地址栏。这里填写的是完整订阅 URL,不是服务端域名,也不是单项配置中的密码。确认地址首尾没有多余空格,再保存分组并返回主界面。保存成功只表示地址已记录,列表此时仍然为空并不一定是故障。

接着打开“订阅分组”菜单,执行“更新订阅”。某些版本会区分“不通过代理”与“通过代理”的更新方式。第一次配置、尚未建立连接时,先使用不通过代理的方式;若地址提供方明确要求另一种访问方式,再按其说明处理。等待更新结束,查看主界面的配置列表与底部日志。更新成功后应能看到分组对应的配置条目,日志不应持续显示下载失败或解析错误。

如果列表仍为空,先检查当前是否选中了其他分组或启用了搜索筛选,再回到订阅分组设置确认地址已经保存。浏览器能打开地址不代表客户端一定能解析返回内容:登录页面、到期提示和普通网页都不是有效订阅。此时应向地址提供方确认订阅是否有效、是否适用于当前客户端,不要反复新增相同分组。更新完成后,选中一项配置并记住它的备注,下一步将以这项配置继续。

v2rayNG:从侧栏添加,回主界面更新

在 v2rayNG 主界面打开左侧菜单,进入“订阅分组设置”,点击添加入口,填写备注和订阅地址后保存。返回主界面,从右上角菜单执行“更新订阅”。注意区分“添加订阅分组”和“从剪贴板导入”:前者保存订阅地址,后者主要读取单项配置分享内容。把订阅 URL 当成普通分享链接导入,可能无法得到预期结果。

看到配置条目后,点击其中一项使其成为当前选择;选中标记只代表后续连接将使用该配置,还不代表已经启动网络转发。如果只有单项分享链接,先复制完整链接,再使用主界面的“从剪贴板导入”;二维码可使用扫描入口读取。单项导入不会自动建立可更新的订阅分组,之后需要更换参数时,应重新获取配置或手动调整。无论采用哪种方式,先确认列表中确实存在可选配置,再进入代理模式设置。

02 选择代理模式与路由规则

桌面端:区分系统代理与路由

v2rayN 中有两类容易混淆的设置。“系统代理”决定遵循操作系统代理设置的应用是否把请求交给客户端;“路由”决定请求进入内核后采用代理、直连还是阻止。切换路由并不会自动让所有程序使用代理,打开系统代理也不会覆盖每个程序自行指定的网络设置。首次操作先把这两件事分开,后面的验证会更清楚。

在主界面的路由选择入口查看预设规则,初次使用可以从“绕过局域网”或含义相近的预设开始,让本地设备访问保留直连。不同版本的预设名称可能不同,选择前查看规则说明;如果已有服务提供方或管理员给出的明确要求,应以这些要求为准。暂时不必编辑每一条域名或 IP 规则,也不必为了让界面看起来完整而启用额外选项。

系统代理稍后在连接步骤中设置为“自动配置系统代理”。这项设置主要适用于浏览器等遵循系统代理的程序;对于使用自有代理配置或直接建立连接的应用,不能据此判断它一定经过客户端。本教程先用普通浏览器完成验证,不把 TUN 模式作为首次连接的必要步骤。需要了解规则顺序、协议类型和内核差异时,可查看协议与内核技术参考,完成基础连接后再调整更细的行为。

安卓端:先保持 VPN 模式与默认应用范围

v2rayNG 通常通过 VPN 模式接收应用流量。打开侧栏“设置”,检查运行模式相关选项;若版本提供“VPN”和“仅代理”等模式,首次使用选择 VPN 模式。仅代理模式主要供已经会手动设置应用代理的用户使用,单纯启动它并不能让其他应用自动接入。VPN 模式也不等于所有请求都通过远端服务器,进入客户端后的流量仍会按路由规则决定去向。

初次连接时,先保持“分应用代理”关闭,避免把用于验证的浏览器意外排除在接管范围之外。路由预设先采用绕过局域网或原有默认方案,不要同时修改 DNS、传输方式和应用筛选。每次只变更一个设置,测试结果才有明确含义。模式确认后返回主界面,检查当前选中的配置仍是第一步导入的那一项,然后继续启动连接。

03 启动连接并完成授权

v2rayN:设为活动服务器,开启系统代理

在配置列表中选中准备使用的条目,通过右键菜单中的“设为活动服务器”或版本提供的等效入口启用它。部分版本也支持双击配置切换活动服务器。操作后观察当前配置标记及日志区域,等待内核完成启动。v2rayN 不一定有一个与安卓相同的大型“连接”按钮,关键是活动服务器已切换、内核正在运行,并且应用流量有正确的进入路径。

接着在底部状态栏或托盘菜单的“系统代理”选项中选择“自动配置系统代理”。如果此前选择的是“清除系统代理”或“不改变系统代理”,仅切换活动服务器通常不会让浏览器自动使用客户端。设置完成后保持 v2rayN 运行,最小化窗口即可,不要立即退出进程。桌面环境可能要求确认系统代理变更,出现系统授权提示时,应核对发起操作的程序与当前动作一致。

如果日志显示端口被占用或内核启动失败,先停止其他正在运行的代理客户端,并确认没有重复打开另一份 v2rayN。不要一边启动多个客户端,一边来回修改系统代理,否则浏览器实际连接到哪一个进程会变得难以判断。端口冲突解决后重新启用活动服务器,再观察日志是否恢复正常。若错误指向协议或字段不兼容,应回到第一步确认订阅格式,而不是随意替换认证参数。

v2rayNG:点击连接,确认系统 VPN 请求

在主界面确认目标配置已选中,点击右下角连接按钮。首次启动时,安卓系统会显示 VPN 连接请求,说明该应用将通过 VPN 接口处理网络流量。核对应用名称后确认授权,再返回 v2rayNG 查看运行状态。若取消了这次请求,列表中的配置依然存在,但网络接管不会开始,需要再次点击连接并完成授权。

启动后,系统通常会显示 VPN 状态标识或运行通知;具体位置取决于设备系统。这个标识只能证明本地 VPN 接口处于运行状态,不能单独证明远端服务可用。如果设备已经运行其他 VPN 应用,先停止另一个连接,再启动 v2rayNG。普通个人使用场景中,不要假定两个 VPN 客户端可以同时接管相同的应用流量。

首次测试先让客户端留在前台或后台正常运行,不要从最近任务中强制结束。如果刚连接能够访问、锁屏后却经常断开,再到系统应用设置中检查 v2rayNG 的电池使用限制与后台运行权限。各设备菜单名称不同,通常可从应用详情的“电池”或“耗电管理”进入。先完成下一步访问验证,再处理后台保活,避免把连接问题与系统省电行为混为一谈。

04 验证访问并确认退出方式

用实际请求与日志交叉确认

保持客户端运行,打开一个遵循系统网络设置的普通浏览器,访问已知正常的网站。先确认页面可以完成新的加载,而不是仅显示之前保存的内容。必要时新开窗口或刷新未缓存的页面。只看“已连接”、VPN 标识或配置列表里的测试结果都不够:本地接口能运行、服务端能接受连接、浏览器能完成请求,是三个不同环节。

同时查看客户端日志,确认刚才访问时是否出现新的连接记录。日志展示粒度受日志级别影响,没有逐条域名记录不一定表示请求未进入;重点先看是否出现重复的连接失败、名称解析失败或认证相关错误。需要分享日志求助时,先移除订阅地址、服务端地址和个人认证内容,保留错误类型及操作发生的先后顺序即可。

若要进一步确认代理路径,应选择一项按照当前路由确实会进入代理出站的请求。允许的情况下,可以使用可信的网络信息页面观察出口变化,但不要把一次出口显示当作所有应用都已生效的证明:规则可能让部分网站直连,其他应用也可能采用独立的代理设置。与其反复切换全部选项,不如固定一个浏览器、一个配置和一套规则进行对照。

打不开时,按进入路径逐层检查

桌面浏览器打不开时,先回到 v2rayN 确认活动服务器没有切错,内核没有退出,系统代理仍为“自动配置系统代理”。若浏览器安装了管理代理的扩展,或启用了手动代理设置,先恢复为使用系统代理后重试。其他软件能够访问而只有某个应用失败时,优先检查该应用自己的网络设置,不要立刻重装客户端或重导全部订阅。

安卓端先确认 VPN 仍在运行,测试浏览器没有被分应用规则排除,也没有被另一个 VPN 应用替换连接。若日志明确显示服务端连接失败,可以在同一订阅内换一项配置,再重复完全相同的测试;若只有某个域名失败,再检查路由与 DNS。每次变更后重新发起请求并观察日志,把问题缩小到具体环节。更深入的协议兼容性和内核选择问题,转到协议参考阅读,本页不要求手动编写内核配置。

结束使用时,先恢复系统网络入口

验证完成后,可以做一次停止与恢复的对照,确认操作路径已经掌握。桌面端先在 v2rayN 中选择“清除系统代理”,再退出客户端;如果直接结束进程而系统代理仍指向本地监听地址,浏览器可能会在客户端退出后无法访问。重新使用时,启动客户端、确认活动服务器,再选择“自动配置系统代理”,不需要每次重新导入订阅。

安卓端点击连接按钮停止运行,并确认系统 VPN 状态标识或运行通知已相应结束。下次打开时,选择已有配置后再次连接即可。订阅需要更新时,继续使用原分组的“更新订阅”入口,不必重复粘贴相同地址。至此,列表中有配置、流量进入方式正确、连接完成授权、实际请求验证通过,首次配置流程才算走完。后续要调整分应用代理或路由规则,先记录当前可用设置,再逐项修改并复测。