v2rayN 设置代理：从导入节点到连接验证的完整步骤
简答：v2rayN 设置代理通常分四步：导入订阅、启用活动节点、选择系统代理模式，再按需要设置路由或 TUN。浏览器优先用系统代理；命令行和不读取系统代理的软件应手动填写本地代理端口或启用 TUN。
定义：v2rayN 设置代理，是把已导入的节点交给客户端核心运行，再通过系统代理、应用代理或 TUN 将流量交给对应的本地入口。
先按目标选择：你需要哪一种代理范围？
先不要直接打开 TUN。v2rayN 的系统代理主要影响会读取操作系统代理设置的程序，例如部分浏览器；路由模式决定流量进入核心后走代理还是直连，两者不是同一个开关。官方说明将系统代理和核心路由分开定义：系统代理负责把软件流量送入核心，路由负责按规则选择不同出站。详情可查看v2rayN 官方系统代理与路由说明。
| 目标 | 建议设置 | 适用范围 |
|---|---|---|
| 只让浏览器等常规软件使用代理 | 自动配置系统代理 + 合适的路由模式 | 会读取系统代理的应用 |
| 只让某个软件使用代理 | 在该软件填写 v2rayN 参数设置中的本地 HTTP 或 SOCKS 入口 | 支持手动代理的软件 |
| 让不读取系统代理的程序也接管 | 优先考虑 TUN，并按系统要求授予权限 | 需要接管更多系统流量的场景 |
| 国内外流量分开处理 | 系统代理负责送入核心，路由模式负责分流 | 需要直连与代理并存的场景 |
截至2026年10月24日，Releases 标记为 Latest 的是 7.25.6。界面名称可能随发行版变化，以下步骤以功能名称为准，不建议只按截图寻找按钮。v2rayN 官方 Releases。
最快完成 v2rayN 设置代理：导入、选择、开启
- 准备配置来源。你需要订阅地址、单个节点分享链接，或二维码。订阅链接属于敏感配置，不要发到公开帖子、截图或聊天群；客户端和内核应从可信来源获取。
- 添加订阅。打开订阅管理或订阅分组相关入口，新增订阅地址并保存，然后执行更新。官方订阅说明列出了 v2rayN 可识别的多种标准分享格式和订阅方式，具体格式仍以配置提供方实际返回内容为准。可查看v2rayN 官方订阅功能说明。
- 选择活动服务器。更新成功后，在节点列表中选中一个配置，将其设为当前活动服务器；如果列表为空，先检查订阅地址是否能在浏览器中访问、返回内容是否为有效订阅，而不是登录页或错误页面。
- 启动核心并观察日志。启动服务后，确认日志没有启动失败、解析失败或监听端口被占用。节点显示出来不等于流量已经走代理，仍要继续验证系统代理和实际出口。
- 开启系统代理。在系统代理选项中，普通桌面使用场景选择“自动配置系统代理”；暂时不想让客户端改动系统设置时选择“不改变系统代理”；退出前或排查残留时选择“清除系统代理”。这些选项的含义以官方说明为准，不要把“清除系统代理”理解成关闭核心路由。
- 选择路由模式。如果希望国内地址直连、其他流量按代理处理，可选择与“绕过大陆”类似的分流模式；如果只想确认节点是否能承载全部请求，可临时选择全局类模式测试。测试完成后再恢复适合日常使用的分流模式。
最短验证路径是：节点已设为活动服务器 → 核心日志持续运行 → 系统代理已自动配置 → 浏览器重新打开页面 → 对比出口 IP 或查看连接日志中命中的策略。四项中任何一项缺失，都不能直接判断代理已生效。
不同系统的入口与权限：不要混用操作步骤
Windows
- 系统代理从客户端的系统代理选项设置；Windows 设置页也可以检查代理开关、地址和例外列表。
- 如果只给某个软件使用代理，在该软件中填写客户端参数设置显示的本地 HTTP 或 SOCKS 地址。常见教程会写死端口，但不同版本、合并监听或自定义配置可能不同，应以参数设置页和运行日志显示的实际端口为准。
- 启用 TUN 时，按提示以管理员权限运行；官方界面说明指出，开机启动相关权限主要用于启动 TUN。若出现“需要管理员权限”，先完全退出客户端，再用管理员身份启动后重新启用 TUN。可参考v2rayN 官方界面与 TUN 设置说明。
- 如果日志提示 bind、listen 或端口占用，先关闭其他代理客户端，再检查实际监听端口；不要只改浏览器代理地址。
macOS
- macOS 版本属于桌面客户端范围，但菜单位置和系统权限提示可能与 Windows 不同。优先使用客户端的系统代理选项，再到系统网络设置中确认代理地址和端口。
- 若系统阻止应用启动或网络扩展，按 macOS“隐私与安全性”中的提示放行，并解除应用隔离后重新打开；不要从不明来源替换核心文件。
- 需要 TUN 时，按系统弹窗授予网络扩展或相关权限；若只想让浏览器工作，先用系统代理，不要把 TUN 当作默认必需步骤。
Linux
- Linux 桌面环境的系统代理入口不完全一致，可先在客户端开启自动配置，再回到桌面环境的网络或代理设置确认是否写入。
- 如果应用作为专用用户运行，必须确保该用户能读取配置文件、执行核心文件并访问必要的运行目录；配置文件权限错误时，日志通常会出现 permission denied。
- 终端程序通常不会自动读取桌面系统代理。需要时，在程序自身设置 HTTP 或 SOCKS 代理，或在终端会话中设置对应环境变量；端口必须以客户端当前参数设置为准。
v2rayN 官方项目定位是 Windows、Linux 和 macOS 的桌面 GUI 客户端；iOS 与 Android 不属于这一个桌面程序的操作入口，应使用对应平台的客户端处理配置，不能照搬 Windows 菜单。
系统代理开了但软件不生效：按这个顺序排查
- 检查浏览器是否有独立代理。浏览器扩展、独立代理插件或企业策略可能覆盖系统代理。先临时关闭独立代理，只保留系统代理，再重新打开页面。
- 检查应用是否读取系统代理。命令行工具、部分开发工具、游戏和后台服务可能不读取系统代理。此时在应用内部填写本地 HTTP 或 SOCKS 代理；如果应用没有代理选项，再考虑 TUN。
- 检查活动节点和核心日志。节点列表存在但未设为活动服务器，或者核心启动后立即退出，都会导致系统代理指向一个没有正常工作的入口。
- 检查路由模式。分流模式下，目标地址可能被规则判定为直连。查看连接日志中命中的策略，比只看网页是否打开更可靠。
- 检查系统时间。时间偏差可能导致 TLS、订阅下载或节点握手失败。先同步系统时间，再重试订阅更新和节点连接。
- 检查其他 VPN 或代理冲突。同时运行多个客户端可能抢占系统代理、端口或 TUN 路由。排查时只保留一个客户端运行。
- 退出后清理残留。退出前选择清除系统代理，随后回到 Windows、macOS 或 Linux 的系统设置确认代理开关已恢复。若手动填写过应用代理，也要恢复该应用原设置。
如果日志出现“failed to listen”或“bind”字样，优先处理端口冲突；如果日志显示请求已命中某个策略但网页仍失败，再检查 DNS、MTU、节点状态或目标应用自身的代理兼容性。
什么时候需要 TUN：权限、冲突与验证方法
TUN 适合需要接管更多系统流量、而目标软件又不读取系统代理的场景，但它会改变系统路由，排查难度也高于系统代理。建议先完成普通系统代理验证，再决定是否启用。
- 启用前：关闭其他 VPN、虚拟网卡工具和代理客户端，记录当前网络设置，确保客户端能以所需权限运行。
- 启用后：先确认 TUN 状态为运行，再打开连接日志，观察目标请求是否命中预期策略。不要只用 ping 判断代理是否生效，因为 ICMP 是否被代理取决于核心、协议和 TUN 路由策略。
- 出现断网：先关闭 TUN，恢复系统代理或清除系统代理，再重新启动客户端；随后检查 DNS、路由排除地址和 MTU，而不是连续切换多个模式。
- 出现权限错误：Windows 重新以管理员身份运行；macOS 检查隐私与安全性中的放行提示；Linux 检查专用用户、配置文件和核心文件权限。
v2rayN 官方界面说明还列出了 TUN 协议栈、MTU、自动路由和路由排除地址等设置。除非已经确认基础连接正常，否则不要同时修改这些高级参数。
验证代理是否真正生效的四步清单
- 看节点状态：活动服务器已选中，核心没有持续报错或反复重启。
- 看系统设置：系统代理处于自动配置状态，地址和端口与客户端参数设置一致。
- 看实际请求：打开网页或运行目标应用，观察连接日志是否出现对应域名及命中的策略。
- 做出口对比：记录未启用代理时的出口 IP，再在同一网络下启用代理比较；不要用单次延迟结果代替连通性判断。
如果浏览器有效、命令行无效，通常是命令行没有读取系统代理；如果命令行有效、某个软件无效，优先检查该软件是否使用独立网络栈、独立 DNS 或独立代理设置。
常见问题
v2rayN 开启系统代理后，为什么浏览器还是打不开？
先确认活动节点已选择、核心没有报错，再检查浏览器是否设置了独立代理或代理扩展。随后查看连接日志是否命中预期策略，并确认系统代理地址和端口与客户端参数设置一致。
系统代理和路由模式有什么区别？
系统代理决定哪些应用把流量送进 v2rayN；路由模式决定流量进入核心后走代理还是直连。只开其中一个，可能仍无法得到预期效果。
v2rayN 需要手动填写 HTTP 或 SOCKS 代理吗？
浏览器等会读取系统代理的应用通常不需要。命令行、开发工具或不读取系统代理的软件，才需要在软件内部填写本地 HTTP 或 SOCKS 入口，端口以当前参数设置为准。
什么时候应该开启 TUN？
当目标软件不读取系统代理，且确实需要接管更多系统流量时再考虑 TUN。启用前关闭其他 VPN 和代理客户端，并按 Windows、macOS 或 Linux 的权限要求运行。
退出 v2rayN 后系统代理还残留怎么办？
在退出前选择清除系统代理，然后回到系统代理设置确认开关、地址和端口已恢复。如果某个应用单独填写过代理，还要在该应用中手动恢复原设置。
订阅更新失败但单个节点可以导入，应该查什么？
先在浏览器中检查订阅地址是否可访问、返回内容是否为订阅而不是登录页或错误页，再检查客户端日志和订阅格式。订阅地址不要公开，也不要把包含节点信息的截图发到公开位置。