本文速览
适合第一次使用 v2rayN 的桌面用户。本文从版本选择、解压启动、核心确认和订阅导入开始，继续说明系统代理、端口、路由分流与开机启动设置；完成后可以独立判断“节点已连接但网页不通”“核心缺失”和“重启后没有自动运行”等问题。
安装前先选对桌面版本
v2rayN 是桌面端代理管理客户端，负责保存节点、调用代理核心、切换系统代理并执行路由规则。它本身不是节点服务。首次使用前需要准备有效的订阅地址或完整节点参数，还要确认计算机的系统类型与运行环境。
Windows 用户通常会看到 WPF 与 Avalonia 两种桌面形态。WPF 版贴近 Windows 原生界面，适合只在 Windows 上使用的场景；Avalonia 版覆盖 Windows、macOS 与 Linux，界面和功能布局更统一。macOS 用户应选择 Avalonia 形态，不要把 Windows 的可执行文件直接复制过去运行。
Avalonia 版
推荐采用跨平台界面，Windows、macOS 与 Linux 的主要菜单位置接近，适合需要在多台桌面设备上保持相似操作习惯的用户。
适合:macOS、Linux，以及偏好统一界面的 Windows 用户
WPF 版
使用 Windows 桌面界面技术，窗口行为和托盘交互更接近传统 Windows 软件。
适合:只使用 Windows，并重视原生桌面交互
下载完成后，应把压缩包完整解压到固定目录，例如 Windows 下的
D:\Apps\v2rayN。不要长期在压缩包预览窗口中直接启动，也不要把程序目录放在会频繁清理的临时文件夹。程序配置、日志和核心文件需要稳定的读写位置。首次启动：确认核心、端口与日志状态
打开主程序后，不要立即判断节点是否可用。先检查状态栏、核心类型和本地监听端口。只要核心没有正常启动，订阅中的节点即使显示出来，也不能建立实际代理连接。
7.15.4
本文界面示例版本
10808
常见本地 SOCKS 端口
10809
常见本地 HTTP 端口
127.0.0.1
本机回环监听地址
不同版本或迁移过的配置可能使用其他端口，因此以上数字只能作为常见初始值。实际端口应以「设置」→「参数设置」中的本地监听配置为准。浏览器、下载工具或开发工具若手动填写代理，也必须使用这里显示的地址和端口。
-
完整解压
把全部文件解压到固定目录，再启动主程序。确认目录可写，并保留核心、配置和日志所在的子目录。 -
选择核心
进入「设置」→「参数设置」→「Core 类型」，日常使用 VLESS、REALITY 或较新的传输配置时优先选择 Xray。 -
核对端口
在参数设置中查看 SOCKS 与 HTTP 监听端口，确认没有与其他本地代理程序使用同一端口。 -
查看日志
返回主界面打开日志区域，正常状态应出现核心启动与监听成功信息，而不是持续重复的错误行。 -
保存重启
修改核心或监听参数后保存设置，并执行一次「重启服务」，让新参数真正载入。
核心缺失通常表现为启动后立即停止、日志提示找不到核心文件，或节点测试全部失败。先确认下载的是完整桌面包，而不是只包含主程序的精简文件；再检查「Core 类型」是否指向当前目录中实际存在的核心。切换核心后必须重启服务。
导入订阅并完成第一次连接
订阅地址用于批量获取节点及其协议参数。它可能包含 VMess、VLESS、Trojan 等配置，其中 v2rayN 常见的主力组合是 Xray 核心配合 VLESS、REALITY 或 VMess。订阅导入后，客户端会把服务端给出的地址、端口、用户标识、传输方式和安全层参数写入本地列表。
-
添加分组
打开「订阅分组」→「订阅分组设置」，选择新增，填写便于识别的备注名称并粘贴完整订阅地址。 -
更新订阅
保存后进入「订阅分组」→「更新全部订阅」，等待节点列表刷新。首次更新不要连续快速点击。 -
测试延迟
选中一组节点执行真实延迟测试。家庭宽带常见可用结果约为 40 至 250 毫秒，超时只说明本次探测未完成。 -
设为活动
双击目标节点，或使用右键菜单将其设为活动服务器，确认主界面状态栏已显示所选节点。 -
启动代理
选择合适的系统代理模式，再打开浏览器访问普通网页，观察日志是否产生新的连接记录。
订阅更新成功但列表为空时，先确认当前订阅分组已经启用，再核对系统时间。VLESS 与 VMess 的认证和安全握手都依赖正确的参数，部分传输方式还对时间偏差较敏感。桌面系统应启用自动设置日期、时间和时区。
VLESS + REALITY
- 建议核心
- Xray
- 常见传输
- TCP
- 常见 Flow
- xtls-rprx-vision
- 关键参数
- 公钥与短标识
订阅正常导入时会自动填写，手动修改任一关键值都可能导致握手失败。
VMess + WebSocket + TLS
- 建议核心
- Xray 或 V2Ray
- 传输
- WebSocket
- 安全层
- TLS
- 关键参数
- Host 与路径
路径、Host、端口和用户标识必须与服务端一致，不能根据示例自行猜测。
系统代理、浏览器代理与路由分流
节点变成活动状态，只表示 v2rayN 已经选定出站配置；网页是否经过代理，还取决于系统代理和应用自身的网络设置。最常见的误区是看到延迟测试成功，就认为浏览器一定会自动使用本地端口。
自动配置系统代理
推荐由 v2rayN 写入系统代理地址，适合浏览器和大多数遵循系统网络设置的桌面应用。
适合:首次配置、日常网页访问
手动填写代理
在特定应用中填写
127.0.0.1 与实际端口，不改变其他应用的系统代理行为。适合:开发工具、单独控制的应用
清除系统代理
删除 v2rayN 写入的系统代理设置，浏览器恢复直接连接，但客户端核心可以继续运行。
适合:暂停使用、排查本地网络问题
第一次连接建议使用「系统代理」→「自动配置系统代理」。随后刷新浏览器页面，并查看日志是否出现目标域名和出站记录。若日志完全没有新增连接，问题多半发生在浏览器到本地代理这一段，而不是远端节点。
部分浏览器会读取系统代理，部分独立配置过的浏览器则继续使用自己的代理规则。若曾经手动设置过代理，应检查其中的地址、协议和端口。SOCKS 客户端通常连接
127.0.0.1:10808，HTTP 代理常见为 127.0.0.1:10809，但最终仍以 v2rayN 当前参数为准。本地 SOCKS 示例
地址：127.0.0.1
端口：10808
本地 HTTP 示例
地址：127.0.0.1
端口：10809路由分流决定一条连接走代理、直连还是阻断。刚完成安装时，不建议立刻导入复杂规则。先使用客户端提供的基础规则验证连接，再按实际需求调整。规则优先级从上到下匹配时，一条过宽的直连规则可能提前接管流量，让后面的代理规则失效。
- 日志显示 direct：连接被路由到直连出站，应检查域名规则、IP 规则与规则顺序。
- 日志显示 proxy 但超时：本地代理已收到请求，应继续检查节点、线路和协议参数。
- 日志没有请求：浏览器没有使用当前系统代理，或填写了错误的本地端口。
- 只有部分网站异常：检查 DNS、域名分流和浏览器缓存，不要先重装客户端。
核心类型怎么选，什么时候需要切换
v2rayN 是管理界面，实际连接由所选核心处理。Xray 与 V2Ray 核心都可以处理常见代理协议，但对新传输特性和参数的支持范围不同。节点由订阅导入后，客户端通常会按配置选择兼容核心；手动切换前应先了解节点使用的协议。
Xray 核心
推荐适合 VLESS、REALITY、XTLS Vision 与常见 VMess 配置，更新后的协议能力通常先在这里体现。
适合:日常主力、新协议订阅
V2Ray 核心
适合标准 VMess、WebSocket、TLS 等成熟组合，可用于兼容已有节点配置。
适合:传统 VMess 节点、兼容性验证
如果节点使用 VLESS + REALITY，并带有
xtls-rprx-vision Flow，应选择支持该组合的 Xray 核心。若节点是标准 VMess + WebSocket + TLS，两种核心通常都能处理，但仍应以订阅给出的参数和客户端识别结果为准。切换路径为「设置」→「参数设置」→「Core 类型」。保存后执行「重启服务」，再观察日志中的核心名称与版本。仅改变下拉选项而不重启，现有进程可能继续使用旧核心。
开机自启、托盘运行与配置保存
开机自启包含两个不同动作：启动 v2rayN 主程序，以及启动后恢复代理核心或系统代理。只勾选程序自启，不代表系统登录后一定会自动选中节点并写入代理设置。首次配置后应主动重启计算机做一次完整验证。
程序启动
- 菜单路径
- 设置 → 参数设置
- 选项
- 开机自动启动
- 验证位置
- 系统启动项
- 预期结果
- 登录后出现托盘图标
修改后正常退出一次，让配置写入程序目录，再重启系统验证。
代理恢复
- 活动节点
- 保留上次选择
- 核心状态
- 登录后自动启动
- 系统代理
- 按上次模式恢复
- 验证方法
- 查看状态栏与日志
托盘图标存在但核心未启动时，应先查看启动日志，而不是重复点击订阅更新。
Windows 下若开机自启失效，先进入系统的启动应用列表，确认 v2rayN 没有被禁用；再检查程序目录是否移动。自启记录通常指向原来的程序路径，移动文件夹后需要关闭并重新启用开机启动选项。
macOS 下应确认系统登录项中允许 v2rayN 启动，同时保留网络相关权限。若程序只在 Dock 或菜单栏出现，但网页仍直接连接，应查看系统代理是否恢复。系统更新或网络环境切换后，代理设置可能需要重新应用一次。
- 退出前确认配置修改已经保存，不要直接结束核心进程。
- 移动程序目录后，重新设置开机启动并检查订阅数据是否仍在。
- 更新客户端前备份现有配置目录，更新后先核对核心和端口。
- 托盘图标、核心进程和系统代理是三种状态，应分别检查。
常见坑按这个顺序处理
排查连接问题时，固定顺序比反复切换节点更有效。建议依次确认订阅是否更新、系统时间是否准确、核心是否启动、本地端口是否监听、系统代理是否开启，最后再核对协议参数与线路状态。
订阅更新后为什么没有节点？
打开「订阅分组」→「订阅分组设置」，确认分组已启用且地址完整。随后校准系统时间，再执行「更新全部订阅」。如果返回内容为空，应向订阅提供方确认订阅状态。
提示核心缺失该怎么处理？
先退出程序，确认桌面包已经完整解压。重新打开后进入「设置」→「参数设置」→「Core 类型」，选择目录中存在的核心，保存并重启服务。
节点能测延迟，网页却打不开？
先选择「系统代理」→「自动配置系统代理」，再刷新网页并观察日志。日志没有请求时检查浏览器代理；出现请求但超时时，再检查节点和线路。
日志为什么提示端口占用？
关闭其他占用同一端口的本地代理程序，或在参数设置中把监听端口改为未使用值，例如从 10808 调整为 10818。保存后重启服务，并同步修改手动代理端口。
勾选自启后重启没有运行？
检查系统启动项是否允许 v2rayN，确认程序目录没有移动。关闭并重新启用「开机自动启动」，正常退出客户端一次，再重启系统测试。
还可以用日志把问题分成三段：浏览器到本地端口、本地核心到节点、节点到目标站点。第一段没有记录，重点看系统代理；第二段握手失败，重点看时间、核心和协议参数；第三段持续超时，重点看节点质量与线路时段。
完成首次设置后，建议保留一组已经验证可用的基础配置，不要同时修改核心、端口、DNS 与路由规则。每次只改变一个变量，再通过日志和网页访问结果判断影响，这样更容易找到真正原因。