v2rayN 首次安装与初始设置：Windows 与 macOS 通用要点和常见坑

一、安装包与目录：先确认系统和处理器架构

v2rayN 是桌面客户端，负责管理节点、订阅、内核和系统代理；实际连接由 Xray-core、sing-box 等所选内核处理。客户端下载完成，不代表已经获得可用节点。订阅地址或节点参数需要另外准备，且应来自可信来源。

先在下载页选择操作系统和处理器架构。Windows 可在「设置」→「系统」→「系统信息」查看系统类型；macOS 可在苹果菜单的「关于本机」查看芯片或处理器。Apple 芯片通常选择 arm64 包，Intel 处理器选择 x64 包。不要仅按文件大小判断安装包是否合适。

二、首次启动：确认配置可保存、内核能运行

第一次打开先不要同时修改 DNS、路由、TUN 和端口。保持默认设置，观察主窗口日志。界面能打开只说明图形程序启动成功；还需要在选择节点后确认内核进程成功启动，且没有端口占用或文件缺失错误。

1. 完整解压

   Windows 将压缩包内的文件和子目录全部解压；macOS 按包内说明安装。不要只复制主程序，也不要把不同版本的内核目录随意拼到一起。

2. 检查设置

   进入「设置」→「参数设置」，核对本地监听端口与当前内核相关选项。不同平台和版本的子页名称可能不同，记录当前显示值，不照抄其他版本截图。

3. 导入节点

   通过主界面的「订阅分组」菜单管理订阅，或使用「服务器」菜单中的剪贴板导入功能添加单条节点。导入后核对协议、地址、端口与传输方式。

4. 设为活动

   在节点列表选择一个节点，使用右键菜单中的「设为活动服务器」。再查看日志，确认所选内核启动成功，而不是只看节点行是否被选中。

5. 保存并重开

   暂不启用开机启动。正常退出客户端后重新打开，确认订阅、节点和参数仍然存在。若设置丢失，先排查写入权限和数据目录位置。

日志若提示找不到内核可执行文件，应先核对安装包是否包含该内核、文件是否完整，以及安全软件是否将文件隔离。不要只改一个“内核类型”选项就认为文件已经就位；也不要在未确认来源前恢复被拦截的文件。

三、订阅与节点：导入成功不等于连接成功

订阅是一份节点配置的获取入口，不是代理监听地址。完整订阅链接可能带访问令牌，应像密码一样保存，避免发到公开评论或完整显示在排错截图中。节点名称可以自定义，但协议和传输参数必须与服务端一致。

• 添加分组：在「订阅分组」→「订阅分组设置」新增记录，填写备注和订阅地址并保存；菜单文字若有差异，以当前版本的订阅管理入口为准。
• 更新内容：返回「订阅分组」，选择对应的更新订阅操作。首次没有可用代理时先尝试直连更新；只有已有可用节点且直连失败时，再尝试通过代理更新。
• 检查结果：节点列表应出现具体的服务器条目。如果为空，先看订阅请求是否成功，再检查返回内容是否属于客户端支持的订阅格式。
• 选择活动节点：选一个节点设为活动服务器，再执行连接测试。列表中显示几十个节点，并不代表当前已经选定了一个出口。

VMess 与 VLESS 是代理协议，WebSocket 是传输方式，TLS 与 REALITY 是安全层相关配置，不能互相替换。手动录入时，要同时核对服务器地址、端口、用户标识、传输类型和安全参数。例如 WebSocket 的路径 /ws 与 / 并不等价；TLS 的服务器名称也不一定等于连接地址。

四、本地端口：分清浏览器入口和远端端口

远端服务器端口与本地代理端口是两件事。节点使用 443，不代表浏览器也要把本地代理填成 443。浏览器连接的是本机监听入口，再由内核连接远端服务器。以下两张卡是常见配置形态，不是要求同时创建两套监听。

若日志出现 address already in use，表示监听地址或端口已被占用。先退出重复运行的客户端，再检查其他代理进程。确需修改端口时，必须同步更新系统代理和应用内的手动代理设置；只改客户端一处，应用仍会连接旧端口。

• 单机使用保持回环地址监听，不必为了首次连接开启局域网访问。
• 127.0.0.1 指当前设备。另一台设备填写这个地址，不会连接到运行 v2rayN 的电脑。
• 不需要为本机浏览器访问而在路由器上配置端口转发，也不应把本地代理入口直接暴露到公网。

五、系统代理与 TUN：首次配置先选一个入口

节点已经启动但浏览器没有走代理，常见原因是系统代理没有设置。可在 Windows 托盘或 macOS 菜单栏打开 v2rayN 菜单，选择「系统代理」→「自动配置系统代理」。这里的“自动配置”是客户端菜单操作，不应直接理解成浏览器的 PAC 脚本模式。

系统代理解决的是“应用如何进入内核”，路由分流解决的是“进入内核后如何出站”。即使开启系统代理，路由仍可能让部分目标直连。首次测试保留默认路由，并选择一个按当前规则应走代理的目标；不要用一个本就直连的网站判断代理是否工作。

六、连接验证：从内核日志到真实请求

节点延迟数字只说明对应测试有响应，不代表网页、DNS 和传输层都工作正常。首次验收应按下面的顺序做，每次只改变一个变量，并记录测试时使用的节点、路由模式和本地端口。

1. 看启动：活动节点选定后，日志没有配置解析失败、内核退出或监听端口占用错误。
2. 看入口：确认浏览器读取系统代理，或者在应用中明确指定已启用的本地端口。
3. 看请求：打开一个按当前规则走代理的 HTTPS 页面，观察访问是否成功及日志中的相关错误。
4. 看重复性：关闭并重新打开浏览器，再正常重启客户端，确认连接能恢复，而非只成功一次。

如果本机有可用的 curl，可以绕开浏览器设置做一次明确指定入口的测试。下例只适用于已经确认 10808 是 SOCKS 或混合端口的情况；Windows 使用 curl.exe，macOS 可将命令名改为 curl。示例域名用于验证请求过程，最终是否代理仍由路由规则决定。

curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/

socks5h 表示让代理端处理目标域名解析；上面的 10 秒是连接超时上限，20 秒是整次请求的时间上限，不是实测延迟。若提示连接本地端口失败，先查内核和监听；若已连接本地端口但远端握手失败，再查节点参数、系统时间和网络连通性。

七、开机启动与常见问题：稳定后再自动运行

确认手动启动、订阅更新和网页访问都正常后，再进入「设置」→「参数设置」，查找当前版本的开机启动选项。macOS 还可在「系统设置」→「通用」→「登录项」核对应用是否获准登录时运行；不同系统版本的入口名称可能略有差异。

• 先留一个启动来源：避免同时添加系统登录项、快捷方式和客户端自启动，造成多个实例争用同一端口。
• 区分启动与连接：开机打开客户端，不保证内核已成功运行，也不保证系统代理已经设置。
• 更新前备份：先正常退出，再备份当前配置和订阅记录；不要在核心运行期间直接覆盖文件。
• 重启后验收：查看活动节点是否保留、端口是否一致，以及浏览器是否仍能完成真实请求。

首次安装的完成标准是：配置能保存、内核能启动、一个节点能完成真实请求、退出后直连能恢复。达到这四项后，再逐步增加 TUN、分应用需求或自定义路由，后续出现问题也更容易定位。