QUICKSTART / 初次配置
v2rayN 使用教程:
订阅导入与连接验证
按四步完成一次可检查的连接:导入订阅、选择代理模式、启动连接、验证请求。先使用预设设置,再调整分流与 DNS。
开始前:客户端与订阅地址
先从客户端下载页选择与设备匹配的安装包,完成安装并打开主窗口。桌面使用 v2rayN,安卓使用 v2rayNG。初次启动时,先确认窗口能够正常显示,设置可以保存;不要同时修改监听端口、路由、DNS 和内核。保持初始设置,后面出现问题时才有明确的对照。
客户端不等于服务器。安装客户端后,还需要已有的有效订阅地址,或者一条完整的服务器分享链接。订阅地址用于获取服务器配置列表;分享链接通常描述单条服务器记录,两者的导入入口不同。本站提供客户端与配置说明,不提供订阅地址,也不生成服务器账号。尚未取得配置时,应先向配置提供方确认地址、有效期和适用客户端。
订阅链接可能包含访问凭据。复制时保留完整内容,不要自行删除问号后的参数,也不要把它粘贴到公开讨论或在线解析工具。若需要请别人协助排查,只提供已经隐藏地址与凭据的错误信息。初次配置可按约十分钟安排操作,但订阅有效性、网络条件和设备权限会影响实际用时。
一、导入订阅并更新列表
在 v2rayN 中添加订阅分组
复制订阅地址后,打开 v2rayN 主窗口的“订阅分组”相关菜单,进入“订阅分组设置”。新增一个分组,在备注中填写便于识别的名称,例如“日常配置”;在地址栏粘贴完整订阅链接。检查开头与结尾是否多出空格或换行,确认没有把说明文字一起复制进去,然后保存。此时保存的是订阅来源,服务器列表不一定立即出现新条目。
返回主窗口,在订阅菜单中执行更新。客户端可能提供“通过代理更新”和“不通过代理更新”等入口。如果当前尚未建立任何可用连接,先尝试不通过代理更新;如果订阅地址本身必须经由已有代理才能访问,则需要先有一条可用连接,再使用通过代理更新。不要仅因为按钮名称不同就反复切换,先看更新结果中的具体错误。
更新结束后,切换到刚创建的订阅分组,确认服务器列表出现条目。重点检查备注、协议类型、服务器地址和端口是否有内容,不必急着批量测速。列表已经存在旧记录时,还要核对当前分组,避免把其他分组的内容误认成此次更新结果。订阅更新成功只说明列表已获取并解析,不代表其中每条服务器都能连接。
如果更新失败,先确认设备可以正常访问网络,再检查订阅是否过期、地址是否被截断、系统时间是否准确。出现解析错误时,返回内容也可能是登录页面或服务端提示,而非客户端能够识别的订阅格式。不要把报错页面当作配置继续导入。需要进一步定位时,可参考订阅更新失败自查清单。
v2rayNG 的对应操作
在 v2rayNG 中打开主界面菜单,进入订阅分组设置,通过添加按钮填写分组备注和订阅地址,保存后返回主界面,再从菜单执行更新订阅。更新完成后选择对应分组查看服务器条目。如果拿到的是单条分享链接,应使用“从剪贴板导入”等配置导入入口,而不是把它填进订阅地址栏。两种方式都应以列表实际新增记录作为完成标志。
完成这一阶段后,应当能看到至少一条可供选择的服务器记录。先不要连接,下一步先确定应用通过什么入口接入,以及连接进入内核后采用哪套路由规则。订阅、节点和分享链接的详细区别可查阅名词解释。
二、选择代理入口与路由模式
先区分系统代理与路由规则
桌面初次使用,先采用系统代理入口,暂时不启用 TUN。系统代理的作用是告诉遵守该设置的应用:把请求交给本地代理地址。路由规则则决定已经进入内核的连接走代理、直连还是其他出站。这是两个不同层次的设置;系统代理已经开启,并不等于每条连接都会走代理出站。
在 v2rayN 中找到系统代理菜单,常见入口位于窗口底部或托盘右键菜单。先认清“设置系统代理”和“清除系统代理”的位置,等下一步确认内核正常启动后再设置。不要把浏览器单独填写的代理地址与系统代理混用,否则关闭一处设置后,另一处仍可能继续影响浏览器请求。
接着找到路由选择入口,初次使用可选择客户端提供的预设规则,例如界面中用于区分常见直连目标与代理目标的规则。不同版本提供的预设名称和具体规则可能不同,应查看所选项目的说明。若临时使用“全局”类路由排查,也只能理解为调整已进入内核的流量处理方式,不能据此判断所有应用流量都已被接管。
这一轮不要新增自定义规则,也不要同步改 DNS。先保留客户端随附的设置,记录当前选中的路由名称。如果后面出现某个网站能访问、另一个网站不能访问的情况,就可以围绕同一套规则复现,而不是在多处改动后失去判断依据。关于规则顺序、域名匹配和出站标签,继续阅读JSON 手册的 routing 部分。
v2rayNG 使用系统 VPN 接口接入
v2rayNG 的常规连接方式通过安卓系统 VPN 接口接收流量,不需要在手机的无线网络设置中另填桌面代理端口。初次连接先保留默认路由及应用范围设置。若曾开启按应用代理,应检查浏览器是否处于选定的代理范围内;不在范围内的应用不能用来证明当前代理连接是否正常。
设备上另一个正在运行的 VPN 服务可能与本次连接冲突,应先处理已有连接,再启动 v2rayNG。这里的目标只是固定接入方式和规则,减少变量。完成后返回服务器列表,下一步再选择活动服务器并启动服务。
三、选择服务器并启动连接
在桌面确认活动服务器和内核日志
在 v2rayN 的服务器列表中选中一条记录,通过右键菜单中的“设为活动服务器”或同类操作将其启用。部分版本也支持双击或快捷键,具体以当前界面提示为准。确认活动标记确实移到所选记录,不要仅凭鼠标高亮判断:高亮行可能只是当前选中项,并非内核正在使用的服务器。
切换活动服务器通常会触发配置生成与内核重载;如果当前版本需要单独启动或重启服务,就使用相应菜单。随后查看底部日志区域,确认没有配置加载失败、端口被占用或内核退出等错误。日志中出现监听信息,说明本地入口已经建立,但这仍不是远端连接成功的充分证据,最终要由实际请求验证。
找到设置中的本地监听端口,并记录当前 SOCKS 入口地址与端口。常见示例是 127.0.0.1:10808,但客户端版本和历史设置可能改变它,应以实际界面为准。不要直接把订阅中的远端服务器端口填进浏览器代理设置;浏览器连接的是本地客户端,客户端再按配置连接远端服务器。
如果日志提示端口占用,检查是否已打开另一份客户端或其他本地代理程序。先退出不需要的实例,再重启当前服务。确实需要改端口时,保存新值,并同步修改所有手动填写该入口的应用。内核能够正常运行后,再执行“设置系统代理”。此时先保持客户端运行,不要立刻关闭程序;关闭窗口是否退出进程,取决于客户端设置。
在 v2rayNG 中确认连接授权
在 v2rayNG 列表中点选目标服务器,确认活动标记,再点击主界面的连接按钮。首次启动时,系统通常会显示 VPN 连接请求;阅读提示后确认,系统才会建立相应接口。随后查看客户端连接状态和系统状态提示。授权被拒绝时,服务不能按预期接收应用流量,需要重新发起连接并完成授权。
如果按钮显示已连接但请求仍失败,打开日志查看对应时间的错误,不要连续切换服务器和内核。先记住所选记录、路由模式和错误内容,再进入验证步骤。系统连接图标只能说明接口处于运行状态,无法证明远端服务器接受了请求。
四、验证实际请求是否生效
把浏览器结果与日志对应起来
保持客户端日志窗口可见,在浏览器中访问一个允许访问且当前可用的 HTTPS 页面。优先使用自己熟悉的固定地址,刷新或打开新的页面,避免仅观察已经缓存的内容。记录发起请求的时间,再查看日志中是否出现对应目标或连接记录。页面成功加载与日志中的请求证据相互对应,比单看连接按钮或延迟数字更有判断价值。
还要检查请求命中的出站。采用分流规则时,一部分目标可能直连,这是规则的正常结果,不应把直连页面打开当作代理出站验证成功。日志展示的详细程度取决于日志级别;没有看到目标记录,也可能是当前级别未记录访问详情。确需临时增加日志时,应在验证后恢复,分享日志前隐藏服务器地址、订阅链接和其他敏感内容。
如果客户端内置连接测试成功,但浏览器没有相应请求,优先检查浏览器是否使用系统代理,以及是否有扩展或独立代理设置覆盖了系统设置。若只有某个应用不生效,先查该应用的代理支持和连接设置,不要立即重装客户端。系统代理不能保证覆盖所有程序,确实需要扩大接入范围时,再阅读TUN 模式设置说明。
必要时单独测试本地入口
熟悉终端且设备已提供 curl 时,可以用以下命令检查一次本地 SOCKS 入口。命令以本地端口为 10808 为前提;如果界面显示的是其他端口,请先替换。这里使用保留的示例域名发起请求,测试结果仍受目标站点可用性和当前路由规则影响。
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/
socks5h 会把目标主机名交给 SOCKS 代理端处理,适合将这次请求与浏览器自身的解析行为区分开。收到 HTTP 响应头表示这条请求路径有响应,并不自动证明它使用了代理出站;仍需结合路由与日志判断。如果提示无法连接本地地址,先查监听端口和服务状态;如果连接本地成功后才超时,再查远端服务器、传输参数和网络条件。
安卓端也按相同思路验证:连接后从浏览器发起新请求,回到 v2rayNG 查看日志和测试结果。前台可用、锁屏后异常时,再检查系统电池管理是否限制了后台服务。不要为了测试一次连接就修改所有后台权限;应先确认异常确实与后台暂停有关,再按设备设置调整。
保存有效设置,并正确结束连接
确认请求路径符合预期后,保留当前活动服务器、订阅分组和路由设置。以后更新订阅时,检查原活动记录是否仍然存在;列表变化后可能需要重新选择。若要调整分流或 DNS,每次只改一项,并重复同一组访问测试。需要直接编辑字段时,再进入V2Ray JSON 配置手册,不要把客户端生成配置中的所有字段当作必须手动维护的内容。
桌面结束使用时,先清除系统代理,再退出客户端,避免应用继续请求已经停止监听的本地端口。安卓端使用 v2rayNG 的停止按钮结束服务,并确认系统连接状态已解除。至此,完整流程应留下四个可核对结果:订阅已更新、代理入口与路由已明确、服务已启动、实际请求已验证;任何一步失败,都返回该步骤排查,不必从安装开始重做。