v2rayN 配置教程
导入订阅 → 选择代理模式 → 连接 → 验证。已有有效订阅时,可按约 10 分钟的顺序完成首次设置;遇到错误先停在当前步骤排查。
开始前:客户端与有效订阅
先准备两样内容:已经安装并能打开的客户端,以及可信来源提供的有效订阅地址。客户端负责读取配置、启动内核和接收应用流量,本身不会自动生成可用的远程服务。如果手中只有客户端安装包,还需要先取得有权使用的服务配置,再继续本页步骤。尚未安装时,前往客户端下载页,按设备系统与处理器架构选择对应入口。
订阅地址通常是一整段链接,可能带有账户识别参数。复制时应包含完整内容,避免把换行、说明文字或末尾标点一起带入。订阅与单条服务器分享链接不是同一种输入:前者放进订阅分组,后者使用客户端的剪贴板导入入口。不要因为两者都能复制,就反复粘贴到同一个输入框。
为了看清每一步的效果,首次配置时先关闭其他代理客户端和可能接管网络的浏览器扩展,保持设备日期、时间准确,并确认普通网络连接可用。已有配置的用户先保存当前设置,暂时不要删除旧分组。下面先把服务器条目导入成功,再处理流量如何进入客户端,避免同时修改多个设置后无法判断问题出在哪里。
导入订阅:保存分组并更新
v2rayN:新增订阅分组
打开主窗口,进入顶部“订阅分组”中的分组设置入口,新建一个分组。备注填写容易辨认的名称,地址栏粘贴完整订阅链接;其他选项先保留默认值。检查地址前后没有多余空格后保存,回到主窗口,再从“订阅分组”菜单执行更新订阅。仅仅保存地址不会保证服务器列表立即出现,更新动作才会拉取内容并解析条目。
第一次还没有可用连接时,优先选择不通过代理更新订阅的选项。如果地址只能经由已有代理访问,需要先有一条能用的连接,再选择通过代理更新;不能依靠一份尚未下载的配置完成它自身的首次获取。更新结束后查看底部消息或日志,确认没有下载、解析错误,并切到刚才建立的分组查看条目。
v2rayNG:添加地址后返回主界面
在侧栏或更多菜单中找到“订阅分组设置”,点击新增按钮,填写备注与订阅地址,保存后返回主界面。接着打开右上角菜单,执行“更新订阅”;部分界面会把更新入口放在对应分组操作中。等待提示结束,再检查主界面是否出现配置条目。若列表使用分组筛选,先切换到新建分组,避免把筛选结果为空误认为导入失败。
两端都应先确认“有条目、能选中”,再进入下一步。条目显示的名称只是识别标签,不代表服务当前一定可连接。如果更新提示成功但列表为空,先检查订阅是否已过期、是否实际返回了配置内容,以及当前客户端能否识别这些配置。不要把登录网页地址或服务说明页当成订阅地址反复更新。
如果这一阶段仍然没有条目,停在订阅更新环节处理即可,改变系统代理模式通常不能修复地址错误或内容格式不符。更详细的原因分类见常见问题与订阅排障。条目已经出现后,记下准备测试的配置名称,接下来设置应用流量的入口与路由。
选择代理模式:入口与路由分开设置
这里需要区分两件事:系统代理决定哪些应用会把请求交给本地客户端,路由决定已经进入客户端的请求采用哪个出站。选择了路由预设,不代表所有应用都开始使用代理;开启系统代理,也不意味着全部连接都会走远程服务器。先把这两个层次分开,后面的验证才有明确依据。
v2rayN:配置系统代理与路由预设
在主窗口底部状态区域或托盘菜单找到“系统代理”,选择“自动配置系统代理”。这里的“自动配置”是客户端写入系统代理设置的操作,不等同于按网站自动分流。多数遵循系统设置的浏览器会使用该入口;有独立网络设置的应用、部分命令行工具则需要另外配置,不能仅凭系统代理状态推断它们的流量路径。
接着找到“路由”,首次日常使用可选择“绕过大陆”等与实际需求相符的预设。这个预设通常让匹配中国大陆域名或地址的连接直连,其余连接按配置处理,实际结果仍取决于规则内容与顺序。如果当前版本的名称不同,先查看预设说明,选择目的相近的一项,不要同时叠加多套自定义规则。需要理解匹配顺序时,再阅读路由字段参考。
最后打开参数设置,查看实际的本地监听地址、端口和代理协议。部分配置使用 10808 提供 SOCKS 入口、10809 提供 HTTP 入口,也有配置在单个端口接收多种协议,必须以当前客户端显示的设置为准。不要把端口数字当作固定答案。只供本机使用时,保持“允许来自局域网的连接”关闭,不必为了连接成功扩大监听范围。
v2rayNG:检查路由与分应用范围
进入设置中的路由相关选项,选用符合需求的预设;首次测试先不新增复杂规则。如果此前开启过“分应用代理”,建议暂时关闭,再完成一次基础验证。分应用代理既可能表示只代理勾选的应用,也可能表示让勾选的应用绕过代理,需看清界面当前选项。浏览器被排除时,即使客户端已经连接,浏览器也不会按预期进入代理链路。
路由选好后先返回主界面,不需要逐个编辑服务器的协议、传输或安全参数。这些通常已经包含在订阅中,随意改动反而会破坏与服务端的对应关系。下一步只做两件事:选定活动配置,并确认客户端真正启动。
连接:选定配置并确认启动
v2rayN:设置活动服务器
在已经导入的列表中找到准备使用的条目,右键选择“设为活动服务器”或含义相同的操作。若客户端提供双击切换,也可按界面提示完成。检查列表中的活动标记是否已经移到目标条目;只把一行点成选中状态,未必等于切换了实际出站。随后查看主窗口底部信息与日志区域,确认内核启动过程中没有立即退出或持续重复的错误。
部分版本会在切换活动服务器后自动重载内核,另一些界面提供启动或重启服务入口,以当前状态为准。不要一边连续切换条目,一边多次重启,这会让日志中的前后事件混在一起。如果看到“地址已被使用”或监听失败,先检查是否仍有另一份客户端在运行,再确认本地端口是否冲突;此时先不要改远程服务器地址。
v2rayNG:启动并完成系统授权
在主界面选中目标配置,点击连接按钮。首次启动时,安卓通常会弹出 VPN 连接请求,说明该应用将使用系统网络通道。核对发起请求的应用名称确实是正在使用的 v2rayNG 后再允许。拒绝授权会使连接无法建立;如果此前已经授权,系统可能不再重复询问,不能以是否弹窗作为启动成功的唯一依据。
授权完成后,观察连接按钮、状态提示以及系统通知是否发生变化,并打开客户端日志查看是否有启动错误。如果设备上另一款应用正在占用 VPN 通道,先停止那条连接再试。首次验证期间保持客户端在前台,暂时不锁屏;这样可以先确认配置本身可用,再处理后台运行与电池管理问题。
连接图标或“运行中”状态只说明本地服务或系统通道已建立,不保证远程服务器可达。出现超时、连接被拒或安全握手错误时,记录错误发生的时间,回查配置是否有效、设备时间是否正确以及网络是否可用。详细解释放在连接排障 FAQ,这里先不修改高级传输字段。没有明显启动错误时,继续进行实际访问验证。
验证是否生效:页面、日志与路径
先打开浏览器,新建页面访问一个已知可用的 HTTPS 站点。选择与当前路由预期相符的目标:如果某个网站按规则直连,它能打开只能证明直连路径可用,不能证明远程代理已生效。为了减少缓存干扰,可换一个尚未打开的页面或刷新新内容,同时记下访问时间,便于与客户端日志对应。
回到客户端查看同一时间段的记录,关注请求目标、匹配的出站标签和错误信息。如果日志显示请求走向 direct,应先判断这是否符合路由预设;若预期经远程出站却走了直连,再检查规则顺序。不同配置的远程出站标签不一定相同,不要只搜索某一个固定标签就下结论。日志等级为 warning 时可能不会显示每条成功请求,这也不等于流量没有经过客户端。
需要更清楚的连接记录时,可以临时把日志等级调到 info,重新发起一次访问,检查后恢复原设置。较详细的日志可能包含访问域名与连接信息,不应整段公开。若客户端提供连接详情或路由查看入口,也可以用它辅助确认;内置连接测试只能说明测试请求的结果,不能代替实际浏览器或业务应用的验证。
桌面:浏览器与终端分别确认
在 v2rayN 桌面环境中,如果浏览器可用而终端工具仍然失败,先不要更换订阅。终端可能没有读取系统代理,需要按工具说明单独设置代理地址或环境变量。填写时区分 HTTP 与 SOCKS 协议,并使用前面实际确认的监听端口。反过来,浏览器自身的代理扩展也可能覆盖系统设置;先停用扩展或让它遵循系统设置,再进行对照。
若需要比较启用前后的行为,先在客户端选择“清除系统代理”,再暂停内核并测试;恢复时重新启动内核、启用自动配置系统代理,使用同一目标再次测试。不要只退出客户端而留下系统代理指向一个已停止监听的端口,否则出现的访问失败只是本地入口不可用,无法说明远程链路的状态。
安卓:确认测试应用在代理范围内
在 v2rayNG 中,先确认浏览器没有被分应用设置排除,再访问同一测试目标。若前台使用正常、锁屏后很快中断,优先检查系统对后台运行和电池使用的限制,按设备设置允许客户端维持必要的后台连接。只有在基础连接已验证之后,再逐个启用分应用规则;每调整一次,重新测试相关应用,避免把路由错误与后台限制混为一谈。
完成验证的标准是:配置条目有效,客户端启动没有持续错误,实际应用能按预期访问,日志或连接详情支持当前路由判断。单独一个网页能打开、一个连接图标亮起,或者一次内置测试成功,都不足以证明所有应用都已进入同一条路径。后续遇到问题,按“订阅内容 → 本地启动 → 应用入口 → 路由结果 → 远程连接”的顺序回查即可。
日常更新订阅时通常只需执行分组更新,不用重复整个教程。需要自定义 DNS、入站或路由规则时,继续阅读配置字段参考;遇到订阅更新失败、端口冲突或部分应用无法访问时,转到常见问题,按现象选择排查路径。