v2rayN 使用教程：
订阅导入与连接验证

按“导入订阅 → 选择代理模式 → 连接 → 验证”的顺序操作。已安装客户端、已有可用订阅时，预留约 10 分钟完成首次配置；先跑通基础连接，再调整分流与 TUN。

开始前，确认客户端可以正常打开，并准备好由可信来源提供的订阅地址或单个节点分享链接。客户端负责读取配置与转发流量，安装程序本身不附带可直接使用的服务器。订阅地址可能包含访问凭据，不要把完整地址发到公开评论、截图或在线解析工具中。

01 · 导入订阅，确认节点已出现

先区分手里的内容。以 HTTPS 开头、用于获取一组服务器配置的地址，通常是订阅地址；以 vmess://、vless://、trojan:// 或 ss:// 开头的内容，通常是单个节点分享链接。两者导入入口不同。不要把服务商的登录页面、订单页面或说明文档地址填进订阅输入框，即使它们也能在浏览器中打开。

在 v2rayN 桌面端添加分组

打开主窗口，进入“订阅分组”中的“订阅分组设置”，新增一条分组记录。备注可以写成便于识别的名称，例如“日常使用”；地址栏粘贴完整订阅地址。粘贴后检查开头与结尾，避免带入空格、换行或聊天软件附加的标点。其他选项先保留默认值，保存并返回主界面。

接着在“订阅分组”菜单中执行更新订阅。如果菜单提供“通过代理更新”和“不通过代理更新”等选项，而当前尚未建立代理连接，先尝试不通过代理更新。等待本次操作结束，再查看主窗口的节点列表。能看到协议、地址或备注等记录，才说明订阅内容已被解析；仅保存了分组名称，还没有完成节点导入。

如果已有其他订阅分组，可以切换到刚添加的分组，避免把旧节点误当成这次更新的结果。更新过程出现错误时，先读日志中的具体原因：连接超时、认证失败与内容解析失败不是同一类问题。不要连续点击更新，也不要为了重试而添加多个相同分组，否则后面很难判断正在使用哪一份配置。

在 v2rayNG 安卓端添加订阅

从侧边菜单进入“订阅分组设置”，点击添加按钮，填写备注与订阅地址后保存。返回主界面，打开菜单执行更新订阅；部分版本需要先切换到对应的订阅分组。更新完成后，列表应出现节点条目。如果只看到一个空分组，继续检查更新结果，而不是直接点击连接按钮。

如果拿到的是单个分享链接，先复制完整链接，再使用客户端的“从剪贴板导入”功能。v2rayN 通常在服务器相关菜单中提供该入口，v2rayNG 通常在主界面的添加菜单中提供。单个链接导入后不会自动变成可定期更新的订阅；以后服务器参数发生变化，需要重新导入或按来源说明修改。

若更新失败，先确认地址仍有效、设备时间正确，并查看来源是否要求特定网络访问。需要代理才能更新的订阅，必须先有另一条可用连接，不能依靠尚未导入的节点完成第一次更新。详细排查见订阅更新问题，这里先不要改动传输或认证字段。

02 · 选择代理模式，先用简单路径

“代理模式”经常混指两个设置。第一个是接入方式，决定应用流量能否进入客户端，例如系统代理、安卓 VPN 或桌面 TUN；第二个是路由规则，决定进入客户端的流量走代理、直连还是被阻止。只修改路由规则，不会让原本忽略系统代理的应用自动使用代理。首次配置把这两层分开检查，后续排错会轻松很多。

v2rayN：先设置系统代理

桌面端先保持 TUN 关闭，在主窗口或托盘菜单找到“系统代理”，选择名称类似“自动配置系统代理”的选项。这里的目标是把桌面环境的代理地址指向本机监听端口，而不是启动额外的网络接管。若界面还有 PAC 相关模式，首次验证先不选它，避免自动配置规则增加一个需要排查的环节。

Linux 桌面环境对系统代理的处理并不完全相同。如果客户端提示已经设置，但系统设置里没有对应变化，打开桌面环境的“网络代理”页面检查。需要手动填写时，地址使用 127.0.0.1，端口以客户端参数设置中的实际监听端口为准。只有本地入口支持 HTTP 或混合代理时，才能把该端口填入 HTTP、HTTPS 代理栏；不要仅凭端口数字猜测协议。

随后查看客户端的路由选择，优先使用绕过局域网与私有地址的规则，保留本地打印机、路由器管理页等地址的直连路径。不同版本可能使用“绕过局域网”“绕过私有地址”或组合名称，先阅读规则说明再选择。暂时不要导入复杂规则集，也不要同时调整 DNS、探测与传输参数。这样发生问题时，仍能明确是哪一步产生了变化。

v2rayNG：先保留默认 VPN 接入

安卓端首次使用时，通常保留默认的 VPN 接入方式即可。路由先采用客户端自带的基础规则，应用分流暂时不启用，或者确认稍后用于验证的浏览器包含在代理范围内。应用分流中的“仅代理所选应用”和“绕过所选应用”含义相反，第一次连接时选错方向，很容易出现客户端已运行、浏览器却没有请求记录的情况。

这一阶段先完成模式选择，不急着更改高级设置。系统 VPN 授权会在下一步启动连接时出现。若设备上还有其他依赖 VPN 接口的网络工具，先停止它们，再测试 v2rayNG；系统通常不能让同一用户环境中的多个此类连接同时接管流量。

完成后记住当前组合：桌面端是系统代理加基础路由，安卓端是默认 VPN 接入加基础路由。下一步只更换节点、观察连接，不再同时更换接入方式。一次只动一个变量，才能判断改善或错误来自哪里。

03 · 选择节点，启动客户端连接

回到节点列表，先选择一条配置完整、来源明确的记录。节点备注只是名称，不能代表实际可用性。列表中的 Ping 或 TCP 测试通常只检查部分网络路径，即使有结果，也不等于协议认证、TLS 与目标访问全部成功。若客户端提供“真连接测试”或类似功能，优先用它筛选候选节点，但仍要完成最后一步的真实应用验证。

v2rayN：设置活动服务器并检查日志

在节点条目上打开右键菜单，使用“设为活动服务器”等对应操作；部分版本也支持双击切换，具体以界面提示为准。确认活动标记已经移到所选条目。v2rayN 通常会在切换后生成配置并启动或重载内核，因此不一定存在独立的“连接”按钮。此时查看窗口下方日志，确认没有配置解析失败、内核退出或监听端口冲突等错误。

如果节点已经激活但应用仍无法访问，再确认系统代理仍处于刚才选择的状态。客户端的活动服务器、内核运行状态、系统代理状态是三个不同信息，不能用其中一个代替另外两个。托盘图标或节点选中状态只能作为辅助判断，不能作为代理已生效的最终证据。

日志提示监听端口被占用时，先检查是否重复启动了客户端，或者另一个代理工具正在监听相同端口。不要直接结束无法识别的系统进程。关闭重复实例后重试；确实需要修改端口时，必须同步修改系统代理与后面的验证命令。若日志是认证失败、证书错误或远端拒绝连接，则应核对节点来源与设备时间，而不是反复更换本地端口。

v2rayNG：点击连接并确认系统授权

在安卓节点列表中点选目标条目，确认选中标记正确，再点击主界面的连接按钮。首次启动时，系统会弹出 VPN 连接请求，核对请求来自 v2rayNG 后确认。授权结束后返回客户端，查看运行状态与日志。若系统提示另一条 VPN 连接将被替换，先确认当前网络工具的用途，再决定是否继续。

连接后保持客户端运行，先不要清理后台或启用额外的省电限制。若测试时正常、锁屏一段时间后断开，再针对后台限制处理，不要在首次配置阶段一口气关闭全部电池管理选项。需要真连接测试时，可按当前版本提供的菜单执行；测试结果只用于比较当前条件下的候选节点，不宜跨网络、跨时间直接比较。

如果一条节点测试失败，可以尝试同一订阅中另一条节点，并保留其他设置不变。若所有节点都出现相同错误，优先检查网络、系统时间、订阅有效期与客户端日志。不要把所有连接问题都归因于路由规则，也不要在不清楚用途时删除 TLS 或传输参数。

启动异常可转到常见问题中的故障排查分类。提交排查信息时，记录操作时间、客户端名称与具体错误文本；截图前遮住订阅地址、服务器凭据和分享链接。

04 · 验证代理生效，再保留设置

验证分两层进行：先确认客户端到服务器的代理链路能工作，再确认浏览器等目标应用确实使用了这条链路。网页能打开只是一个现象，因为该页面也可能走了直连或缓存。更可靠的做法是同时观察新请求、路由结果与客户端日志，不依赖一个图标或一次测速。

用浏览器发起新请求

打开浏览器的新标签页，访问一个你有权访问、且按当前路由应走代理的 HTTPS 页面。需要时刷新页面，避免只看到旧缓存。同时打开客户端日志，查找对应时间的目标域名与连接记录。日志应能帮助判断请求是否进入内核，以及匹配了代理还是直连出站；部分版本默认日志较简略，可以临时提高到 info 级别，验证结束后恢复原设置。

如果日志显示直连，这不一定是故障，可能只是当前规则的预期结果。为了检查代理出口，可以临时选择将普通目标流量交给代理的全局代理路由，再发起一次新请求，测试完成后切回原规则。这里改变的是路由，不是把系统代理从关闭变为开启；两者仍要分别确认。不要使用局域网设备页面来验证远端代理，因为这些地址通常应当直连。

安卓端同样观察浏览器请求与 v2rayNG 日志。若客户端保持运行，但浏览器请求完全没有对应记录，检查该浏览器是否被应用分流排除。桌面端则检查浏览器自身是否配置了独立代理，或已有扩展覆盖了系统设置。只有目标应用采用了正确入口，后面的节点调整才有意义。

用终端单独验证 HTTP 代理入口

桌面端可以用下面的命令做一次显式代理测试。执行前，先到客户端参数设置确认：本地入口支持 HTTP 或混合代理，监听地址为本机，端口确实是 10808。如果实际端口不同，修改命令中的数字。命令访问的是示例域名，不代表它在你的路由规则中一定走远端代理，仍需结合日志判断出站。

curl -I --connect-timeout 10 --max-time 20 \
  -x http://127.0.0.1:10808 https://example.com

看到目标站点返回的 HTTP 响应头，说明本地代理入口与本次请求链路可以工作；响应状态不必固定为某一个数字。某些 HTTPS 代理输出会先出现隧道建立响应，不能只看到这一行就认定目标请求已经完成。继续查看后续响应与 curl 是否报错。若返回连接被拒绝，先查本地端口与内核运行状态；若是超时，再结合客户端日志定位远端连接。

这条命令使用了显式 -x 参数，因此成功只证明它指定的代理路径可用，不能证明系统代理已经正确设置。反过来，浏览器可用而终端普通命令不可用，也可能只是终端程序不读取桌面系统代理。需要让当前终端中的常见 HTTP 工具读取代理时，可以在确认端口后设置环境变量：

export http_proxy=http://127.0.0.1:10808
export https_proxy=http://127.0.0.1:10808
curl -I --connect-timeout 10 --max-time 20 https://example.com

这里 https_proxy 的值仍以 http:// 开头，表示客户端提供的是 HTTP 代理入口，不是在声明目标网站的协议。环境变量只影响支持它们的程序及当前 shell 后续启动的进程，不会接管所有软件。测试时也留意 no_proxy 或程序自身代理设置是否让目标被绕过。

结束测试，确认可以正常恢复

验证成功后，保留一个已确认可用的活动节点和基础路由，再逐项尝试应用分流、TUN 或自定义 DNS。每增加一个设置，都用相同的方法重新检查一次。配置字段与完整示例集中在V2Ray 配置文件参考大全，首次连接无需逐段编辑 JSON。

暂时不用代理时，桌面端先在客户端中清除或恢复系统代理，再退出程序；如果系统代理是手动填写的，也需要在桌面网络设置中恢复。安卓端点击停止连接，确认 VPN 已断开。当前终端设置过环境变量的，可以执行以下命令恢复当前 shell；如果写入过 shell 启动文件，还需要手动删除对应设置。

unset http_proxy https_proxy