首次配置 v2rayN，建议按“确认系统架构 → 放好程序与配置 → 导入节点 → 核对内核 → 设置系统代理”的顺序完成。本文适合 Windows 与 macOS 新用户，重点区分程序能启动、内核能运行、应用流量已进入代理这三件事；先用浏览器建立可验证的连接，再考虑 TUN 与复杂分流。
一、下载前确认平台、架构与运行环境
v2rayN 是管理节点、订阅和路由规则的桌面客户端，真正建立代理连接的是内核。下载到图形界面，不等于已经具备可用节点；界面能够打开，也不代表包内的内核已经正常启动。首次安装应先匹配操作系统与处理器架构，再看所选发行包是否包含运行环境和内核。
Windows 与 macOS 的安装前检查
Windows
- 在「设置」→「系统」→「系统信息」查看“系统类型”，区分 x64 与 ARM64。
- 压缩包应先完整解压，再启动主程序；不要在压缩软件的预览窗口中直接运行。
- 如提示缺少 .NET 运行环境，按当前发行说明确认组件与架构，不要只凭旧教程安装任意版本。
macOS
- 在苹果菜单的「关于本机」查看芯片信息，区分 Apple 芯片与 Intel 处理器。
- 按发行包说明解压或放入“应用程序”目录，不要长期从临时挂载位置运行。
- 若系统阻止打开，先确认下载来源与包是否匹配，再查看「系统设置」→「隐私与安全性」中的具体提示。
两端先满足各自发行包的系统要求；运行环境是否随包提供，以当前下载说明为准。
Windows 可将便携目录放在当前用户可写的位置，例如 D:\Tools\v2rayN；这只是目录示例，不要求一定有 D 盘。避免放在需要额外权限才能写入的系统目录，也不要频繁移动正在使用的程序目录。macOS 需要同时留意应用本体与用户配置存放位置，两者不一定在同一目录。
二、首次运行：先导入节点，再启动连接
第一次打开 v2rayN，先保持默认路由与 DNS 设置。此时没有必要同时修改监听端口、启用虚拟网卡和替换内核。一次只处理一个环节，出现错误时才能判断是订阅、节点还是本机设置的问题。下面按常见中文界面列出路径；不同发行版可能调整按钮位置，以实际菜单和字段含义为准。
-
确认目录
完成解压或应用放置后启动 v2rayN。确认配置能够保存，关闭再打开时设置仍然存在；若出现写入失败，先处理目录权限。
-
添加订阅
打开「订阅分组」→「订阅分组设置」，新增分组，填写备注和完整订阅地址后保存。没有订阅时，可使用「服务器」→「从剪贴板导入分享链接」，但不要把订阅网址当成单个节点链接导入。
-
更新列表
在「订阅分组」菜单选择对应的更新订阅操作。首次尚无可用代理时先尝试不通过代理更新；列表为空应检查获取结果和解析提示，不要反复新增同一分组。
-
选择节点
选中一个节点，在右键菜单选择「设为活动服务器」。检查活动标记和日志，确认内核启动没有报错；仅将某一行高亮，并不一定完成活动节点切换。
-
设置代理
在底部状态栏或托盘菜单的「系统代理」中选择「自动配置系统代理」。然后用遵循系统代理的浏览器访问已知可达的 HTTPS 页面，再结合日志确认请求是否进入内核。
订阅地址通常带有访问凭据，应按账号信息保护。排查问题时可以提供状态码、错误文字和协议类型，不要将完整订阅地址、节点密码或 UUID 发到公开讨论区。需要更多导入说明，可查看v2rayN 导入教程。
三、内核选择：按协议与安全层匹配
V2Ray、V2Fly 与 Xray 不是 v2rayN 界面的不同皮肤。客户端负责把节点参数转换成内核配置，而内核决定支持哪些协议、传输与安全层组合。Project V、V2Fly 与 Xray 的技术说明可用于理解这些字段，但具体可用性仍要看本机所带内核的版本与客户端适配情况。
| 节点类型或现象 | 优先检查 | 不要混淆 |
|---|---|---|
| VMess 节点 | UUID、传输类型、TLS、路径以及系统时间是否正确 | 支持 VMess 不代表所有传输组合都能自动兼容 |
| VLESS + REALITY | 使用支持该组合的 Xray 内核，并核对 publicKey、shortId、serverName 等服务端要求的字段 | REALITY 是安全层机制，不是独立出站协议 |
| 提示未知字段 | 检查订阅格式、客户端转换结果及内核对该字段的支持 | 更新订阅不会自动补齐缺失的内核能力 |
| 内核立即退出 | 先看配置解析、可执行文件路径、权限和监听端口错误 | 内核没启动时，切换系统代理模式无法修复连接 |
需要核对时，可先打开「设置」→「参数设置」，查找当前发行版提供的内核选择项；部分版本将“Core 类型”放在单独页面或按协议设置，并非所有版本都有一个统一的全局切换开关。不要根据旧界面截图，强行寻找已经迁移的字段。
- 已有明确配置说明：优先遵循节点提供方注明的内核与参数要求。
- 导入后字段丢失：先检查分享链接与订阅格式是否被当前客户端识别，不要仅修改协议名称。
- 刚替换过内核：重新启动连接并观察日志，确认加载的是新文件，而不是仍在运行的旧进程。
四、系统代理、路由分流与 TUN 的边界
“系统代理已开启”只说明操作系统的代理设置被修改，不保证每个程序都会使用它。浏览器通常能遵循系统设置，某些命令行工具、游戏或自行管理网络连接的程序则不会。初次配置应先验证一个遵循系统代理的应用，再判断其他应用是否需要单独指定代理地址。
| 设置 | 解决什么问题 | 首次配置建议 |
|---|---|---|
| 自动配置系统代理 | 让遵循系统代理的程序连接本地代理入口 | 先使用这一入口验证浏览器访问 |
| 路由分流 | 决定已进入内核的请求走代理、直连或阻断 | 先用预设规则，连接正常后再逐条调整 |
| TUN 模式 | 通过虚拟网卡与系统路由接管更广范围的流量 | 基础链路正常后，再检查权限、路由和 DNS 配置 |
不要把“全局代理”理解成统一的技术开关。路由规则中的全部走代理，通常只影响已经进入内核的流量；它不能迫使绕过系统代理的程序自动接入。TUN 的接管范围更广，但也受路由排除项与平台实现影响，不宜当作首次运行的必选项。
五、本地端口：区分监听地址与服务器端口
本地监听端口是浏览器或其他程序连接 v2rayN 的入口；服务器端口则属于远端节点。修改本地端口不能修复远端拒绝连接。查看「设置」→「参数设置」中的本地监听设置，并结合主界面的端口显示确认实际值，不要把教程示例当成当前版本的固定默认值。
假设当前 HTTP 或混合代理入口确实监听在 127.0.0.1:10808，应用的 HTTP 代理地址才可以填写这个地址。若该端口只提供 SOCKS 服务，就必须在应用中选择 SOCKS 类型。部分发行版提供混合入口，另一些配置会分开监听，应以实际入站类型为准。
- 端口占用：日志若出现
address already in use或绑定失败，先确认是否重复运行了 v2rayN，再检查其他程序是否占用了同一监听地址与端口。 - 仅供本机使用：保留回环地址监听通常更合适。
127.0.0.1指向当前设备，手机填写这个地址只会连接手机自身。 - 局域网访问：允许局域网连接会改变暴露范围，还要考虑防火墙与访问控制；首次安装不建议为方便测试直接开放。
- 改端口之后：重启连接，并同步更新手动设置代理的应用。系统代理入口也应重新应用，避免继续引用旧端口。
六、常见问题：按启动、订阅、连接分层排查
排错时先写下失败发生在哪一层：程序打不开、订阅拿不到、内核起不来，还是只有某个应用无法访问。保留当前节点与设置，每次只改变一项。测速结果只是辅助信息，不能代替实际请求与日志；节点显示名称和列表里存在记录，也不能证明服务端当前可用。
窗口刚出现就退出，先重装吗？
先检查下载包的平台与架构、是否完整解压，以及启动时的系统错误提示。Windows 若明确提示缺少运行环境，按发行说明补齐相应组件；macOS 则先查看应用安全提示。不要在没有备份配置的情况下反复覆盖目录。
订阅更新超时，应该勾选通过代理吗？
只有已有可用节点时，通过代理更新才可能帮助访问订阅地址。首次列表为空且没有可用连接，开启此项可能仍然超时。先核对地址完整性与订阅时效，再区分网络请求失败和内容解析失败。
节点已经选中，浏览器还是打不开？
确认节点已设为活动服务器，日志中没有内核退出或端口绑定错误；再重新应用「自动配置系统代理」。若日志没有浏览器请求，优先检查代理入口；若已有请求但连接失败，再核对节点参数、远端连通性和 DNS 错误。
浏览器能用，其他程序为什么不行？
先确认该程序是否遵循系统代理。支持手动代理的程序可填写实际本地地址、端口和协议类型；确实需要接管其他流量时再考虑 TUN。不要直接关闭防火墙，因为未进入代理的请求不一定与防火墙有关。
退出以后普通网页也打不开了？
重新打开 v2rayN，在「系统代理」中选择「清除系统代理」，然后正常退出。Windows 可检查「设置」→「网络和 Internet」→「代理」；macOS 可检查「系统设置」→「网络」→当前网络服务→「详细信息」→「代理」。受单位管理的设备不要擅自删除组织配置。
七、完成初始设置后的检查清单
基础连接稳定后再加入自定义路由、DNS 策略和 TUN，后续每新增一项功能，都重复检查浏览器、常用程序与退出后的网络恢复情况。升级前备份订阅分组与自定义规则；备份中可能包含凭据，应保存在受保护的位置，而不是作为截图附件公开分享。
- 程序与内核均可正常启动，重启客户端后配置仍然保留。
- 活动节点明确，协议、传输方式与安全层参数匹配服务端要求。
- 至少一个遵循系统代理的浏览器已完成真实网页访问验证。
- 本地监听地址、端口和入站类型已核对，未无意开放局域网入口。
- 知道如何清除系统代理，退出程序后常规网络可以恢复。
如果需要从头核对流程，先看客户端配置教程；遇到订阅格式问题，可查看订阅转换与兼容性说明。先确定故障层级，再决定是否更换配置，通常比同时重置所有选项更容易定位原因。