适合第一次在桌面端使用 v2rayN 的读者。先按系统和处理器选包,确认主窗口与代理内核能分别启动;再导入一个已知可用的节点,用浏览器验证系统代理。最后检查关闭代理后能否恢复直连,把安装、节点和应用接入这三类问题分开。
Windows 与 macOS 首次运行
先确认安装包和电脑架构匹配。Windows 在「设置」→「系统」→「系统信息」(部分版本显示为「关于」)查看「系统类型」;标明 x64 的包对应 x64 处理器,不要只看系统是不是 64 位。macOS 在「关于本机」看「芯片」或「处理器」:Apple 芯片选 arm64,Intel 处理器选 x64。
按发布包类型运行
Windows
- 如果拿到的是 ZIP,先用「全部解压缩」展开。打开解压目录里的
v2rayN.exe,不要在压缩包预览窗口中启动,也不要把主程序单独拖到桌面。 - 目录选当前账号可写、位置固定的文件夹。若拿到的是有安装向导的 EXE,按向导安装,然后从开始菜单启动,不套用 ZIP 的步骤。
- 桌面版和 WPF 版是界面包选项,不是节点协议选项。初次安装先保留一个版本,避免两个实例同时监听同一个端口。
macOS
- 打开 DMG,把 v2rayN 拖入「应用程序」。复制完成后推出磁盘映像,再从「应用程序」启动,不要一直从挂载窗口运行。
- 如果下载的是压缩包,先解压,再把完整的应用移到「应用程序」。不要从应用包中单独取出同名可执行文件启动。
- 如果系统阻止打开,先核对包的来源、架构和发布说明。提示应用已损坏时先重新下载对应包,不要为排查关闭系统安全检查。
先确认主窗口能打开、关闭后能再次启动。通过这一步,再导入节点和调整系统代理。
运行库与本地端口
Windows 双击后若弹出「You must install .NET to run this application」,先读提示里的框架名、主版本和架构。比如提示缺少 Microsoft.WindowsDesktop.App 8.0 x64,就安装对应的 .NET 8 Desktop Runtime x64;仅安装同主版本的普通 .NET Runtime 不一定满足桌面程序。不同发布包的要求会变,不要把 .NET 8 当作固定前提。使用标明自包含的包时,如果主窗口已经能打开、只有连接失败,先查内核日志,不必重复安装运行库。
在「设置」→「参数设置」中查看本地监听配置。新版常见的是「本地混合监听端口」,同一个端口可接收 HTTP 和 SOCKS 请求;旧版可能把两种入口分开。上面的数字只用来识别常见配置,不要按数字猜代理类型。手动配置应用时,以当前设置为准,地址用 127.0.0.1,端口填对应入口;这不是节点的远程地址,也不需要为本机使用开启「允许来自局域网的连接」。
如果日志报 address already in use,先退出旧实例或其他占用同一端口的程序。确实需要改端口时,在参数设置里保存新值,重启内核,再重新应用系统代理;已经手动填过代理的应用也要同步更新。仅改客户端监听端口,浏览器仍可能向旧端口发请求。
节点导入与内核选择
v2rayN 是桌面界面,负责管理节点和启动内核;内核负责按节点配置建立连接。首次设置只导入一组订阅或一个已知可用的节点,然后把它设为活动服务器。先用默认的内核设置验证,只有节点要求某种传输或安全选项、或者日志明确提示配置不受支持时,才去改内核。
- 拿到订阅地址时,打开「订阅分组」→「订阅分组设置」,新增分组,在「地址(url)」粘贴完整地址并保存。回到主窗口,从「订阅分组」菜单执行不通过代理的更新;如果当前网络本身无法访问订阅地址,先确认订阅的访问条件,不要反复修改内核。
- 拿到单个
vmess://或vless://分享链接时,复制整条链接,用「服务器」菜单中的「从剪贴板导入批量 URL」,也可在主窗口聚焦时用 Ctrl + V(Windows)。分享链接不要填进订阅分组的地址栏。 - 确认节点出现在当前分组,双击目标行将其设为活动服务器,再看日志有没有内核启动错误。需要检查内核类型时,在「设置」→「参数设置」中找「Core类型设置」;界面文字可能随发布版本调整。
Xray 内核
推荐节点明确使用 VLESS 与 REALITY 时,优先用 Xray,并保留链接导入带来的传输和安全参数。Xray 也支持常见 VMess 配置,不需要只因链接以 vmess:// 开头就切换内核。
适合:首次配置 VLESS + REALITY,或使用来源未要求另选内核的常见 VMess 节点。
V2Ray 内核
如果当前版本提供该选项,且节点文档明确要求用 V2Ray 复现某套 VMess 配置,可以按文档选择。不要把缺少内核文件、端口冲突或节点超时都归为兼容性问题。
适合:有明确版本和配置要求的 VMess 环境。
订阅更新成功只表示客户端拿到了列表,不代表列表里的节点都能连接。「Core类型设置」可能影响同协议的其他节点;改前记下原选项,一次只改一项。若报的是找不到内核可执行文件,先核对所选发布包是否附带对应内核、是否完整解压,不要改协议字段来试错。
系统代理与浏览器验证
让浏览器先使用系统代理,不同时开启 TUN,也不额外修改浏览器的手动代理。这样能单独验证「应用是否进入本机代理」。路由是后一步:流量进入内核后,路由规则才决定直连还是走节点。开启系统代理不等于所有应用都走代理,也不等于所有目标都经节点。
| 系统代理菜单 | 实际作用 | 首次设置怎么选 |
|---|---|---|
| 自动配置系统代理 | 写入系统代理设置,供遵循系统设置的应用使用。 | 节点设为活动后,用它做浏览器连通测试。 |
| 清除系统代理 | 清理系统代理设置,不等于退出程序,也不会清除应用自己保存的代理。 | 验证结束后用来恢复直连;有单位代理配置的电脑应先记录原值,以便恢复。 |
| 不改变系统代理 | 不改写当前系统代理,不会主动清掉此前留下的配置。 | 只想给某个应用手动配置本地代理,或要保留现有系统设置时使用。 |
- 在 v2rayN 的托盘菜单或主界面打开「系统代理」,选「自动配置系统代理」。Windows 到「设置」→「网络和 Internet」→「代理」确认当前设置;macOS 到「系统设置」→「网络」→当前网络服务的「详细信息」→「代理」核对地址和端口。
- 用遵循系统代理的浏览器打开一个已知可用的 HTTPS 页面,刷新一次,同时查看 v2rayN 日志。有请求记录只说明流量进了内核;若需要确认是否走节点,再查请求对应的出站是否为代理而非直连。
- 验证完选「清除系统代理」,再用同一个浏览器打开原先可直连的页面。确认恢复后再退出程序,可避免内核已关、应用却仍向本机代理端口发送请求。
首次启动常见故障
双击没反应,是运行库没装吗?
先看托盘或菜单栏是否已有 v2rayN,窗口也可能只是没弹到前面。没有进程时,再核对架构、解压目录和运行库提示。如果主窗口能开而内核不能启动,就读主界面的日志,先处理里面第一条启动错误。
测延迟有数字,为什么网页还是打不开?
延迟测试不代表浏览器已经使用代理。先选中活动节点并应用「自动配置系统代理」,核对系统里显示的端口和内核监听端口是否一致。刷新网页时如果没有请求记录,再检查浏览器是否设了自己的代理,或者是否被扩展接管。
浏览器能打开,另一个软件还是连不上?
先看该软件是否读取系统代理。有独立代理设置时,按它支持的 HTTP 或 SOCKS 类型填写本机入口,再单独测试。对不支持系统代理、也没有手动入口的软件,反复切换 v2rayN 的系统代理模式不会改变它的连接方式。
退出 v2rayN 后,为什么连直连网页也打不开了?
重新打开 v2rayN,选「清除系统代理」。如果程序打不开,就去系统的代理页面,移除此次设置留下的本地代理;如果电脑原来就有工作网络要求的代理配置,恢复之前记录的值。只有一个应用仍不能联网时,再检查该应用自己的代理设置。