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

一、安装包选择：先分系统、架构与界面类型

v2rayN 是管理服务器、调用代理内核并配置本地代理入口的桌面客户端。主界面能打开，只说明界面程序启动成功；内核文件、节点参数和系统代理仍需要分别确认。第一次安装应从客户端下载页选择对应平台，保留安装包的类型与架构信息，遇到错误时更容易定位。

不要因为看到“.NET”就安装多个不同版本的运行库。缺少运行时的启动提示通常会列出框架名称、所需版本和架构；例如提示缺少 Microsoft.WindowsDesktop.App，应核对对应的 .NET Desktop Runtime，而不是只安装基础 Runtime 或开发用 SDK。具体主版本随客户端发行包变化，以包内说明和错误提示为准。

二、首次启动：解压目录、应用位置与权限

Windows 压缩包必须先完整解压。直接在压缩软件中双击主程序，可能只临时释放一个文件，导致内核、资源文件或配置无法正常读取。可将解压版放在当前用户可写的固定目录，例如 D:\Tools\v2rayN；路径只是示例，重点是目录长期存在，并且当前账户能保存配置。

1. 核对安装包

   在下载页确认系统、处理器架构和包类型。Windows 使用系统的“全部提取”完整解压；使用安装程序的版本则按安装向导完成，不套用解压版的目录规则。

2. 固定应用位置

   Windows 解压版保留完整目录结构。macOS 若提供磁盘映像，打开后将应用复制到「应用程序」，不要长期从临时挂载的映像中运行。

3. 完成首次打开

   Windows 先用普通用户启动。macOS 若提示开发者身份无法验证，先确认下载来源，再按系统提示到「系统设置」→「隐私与安全性」查看允许打开的选项；不要关闭整个系统的安全检查。

4. 查看启动日志

   打开主界面日志区域，确认配置能够保存，内核可以启动。若出现文件缺失、权限不足或架构不匹配，先解决对应错误，再导入订阅。

三、内核选择：按节点需求确认 Xray 或 V2Fly

客户端与内核是两层程序。v2rayN 负责界面与配置管理，真正建立代理连接的是内核。版本号不同也正常，不需要为了数字一致而替换文件。首次安装先保留发行包提供的内核配置；确有协议需求时，再查看「设置」→「参数设置」以及版本提供的 Core 类型相关设置。

不同版本对 Core 类型设置的组织方式可能不同，有些按协议分别指定。确认的是当前选中节点实际调用哪个内核，而不是只看设置窗口里出现过哪个名称。日志若显示不支持的字段或无法解析配置，先核对节点要求与内核版本，不要随机修改加密、传输和 TLS 参数。

• 文件缺失：重新完整解压对应发行包，并检查系统安全记录是否隔离了内核文件，不要从不明来源单独补文件。
• 架构不符：界面和内核都需要匹配系统支持的架构，主界面可打开不代表附带的内核一定可执行。
• 启动失败：保存第一条内核错误及其前后日志。后续大量连接失败可能只是内核没有启动的结果。

四、导入订阅：先选中服务器，再验证连接

安装完成不会自动获得服务器。订阅地址由服务提供方提供，通常包含访问凭据；网页账户入口、套餐说明页和单条节点分享链接都不等同于订阅地址。复制时确认整段内容完整，没有换行、中文引号或前后空格。

1. 在 v2rayN 主界面打开「订阅分组」→「订阅分组设置」，新增分组，填写便于识别的别名和订阅地址，保存设置。
2. 回到「订阅分组」菜单，执行「更新全部订阅（不通过代理）」。首次没有可用节点时，优先尝试直接更新。
3. 确认列表出现服务器记录。若地址只能通过代理访问，需要先有另一条可用连接，再使用「更新全部订阅（通过代理）」；该选项不能凭空建立第一条连接。
4. 在服务器列表选中一个节点，使用右键菜单中的「设为活动服务器」。确认当前活动服务器已变化，并查看日志中是否出现启动错误。
5. 运行客户端提供的连接测试作为初筛，然后继续配置系统代理。延迟测试成功并不代表浏览器已经使用该节点。

五、本地监听端口：客户端与系统设置必须一致

本地监听地址是应用连接 v2rayN 的入口，不是远程服务器地址。「设置」→「参数设置」中可查看本地监听相关设置；保存后若客户端要求重启内核，应完成重启，并在日志中核对实际监听端口。下面是两种配置示例，不能把它们同时当作当前版本的默认值。

首次使用保留回环地址 127.0.0.1。开启“允许来自局域网的连接”会改变入口的可访问范围，涉及防火墙与访问控制，不是解决本机网页打不开的通用步骤。系统代理里的端口、手工设置的软件端口和内核日志里的监听端口必须相互对应。

端口占用的检查方法

如果日志出现 address already in use，先检查是否重复启动了 v2rayN。下面分别是 Windows 命令提示符与 macOS 终端的检查示例；使用其他端口时替换数字。

netstat -ano | findstr ":10808"

lsof -nP -iTCP:10808 -sTCP:LISTEN

Windows 需要查看本地地址列和监听状态，末列 PID 可到任务管理器的「详细信息」中核对。确认进程归属后再关闭重复实例，或更换本地端口；不要仅因看到数字就结束陌生进程。端口改变后，系统代理和手工代理设置也要同步更新。

六、系统代理与路由模式：两项设置分别确认

系统代理决定遵循操作系统代理设置的软件把请求交给哪里；路由规则决定请求进入内核后直连、代理还是阻断。设置“全局代理”不能让所有软件自动遵循系统代理，选择“自动配置系统代理”也不代表内核中的每条请求都会走远程服务器。

• 连接验证：打开一个已知可访问的 HTTPS 页面，同时看内核日志是否出现相应连接。日志详细程度不足时，可临时提高日志级别，测试后恢复。
• 应用差异：部分浏览器支持独立代理设置，部分命令行工具只读取环境变量；这些程序不一定跟随系统代理。
• 退出顺序：结束使用时先在「系统代理」中选择「清除系统代理」，再退出。若程序异常关闭留下旧设置，可到操作系统的代理入口手动恢复。

确认基本连接后，再按需启用开机启动、自动更新订阅或 TUN。macOS 切换网络服务后若代理表现变化，重新检查当前服务的代理项；Windows 若设置写入后立即被改回，应检查是否有其他代理程序、管理策略或安全工具同时管理这些设置。

七、首次安装常见问题：按故障发生位置排查

求助时保留这些信息

• 系统版本、处理器架构、v2rayN 版本，以及桌面版或 WPF 版等包类型。
• 所用内核及版本、实际本地监听端口、系统代理模式，以及是否启用了 TUN。
• 错误发生在哪一步：打开界面、启动内核、更新订阅，还是访问网页；附第一条相关错误及发生时间。
• 分享前隐藏订阅地址、服务器访问凭据、UUID 和密码。截图优先展示设置项名称与错误文本，不公开完整节点配置。

首次配置的完成标准是：客户端设置能保存、内核启动正常、本地入口与系统代理一致、实际网页访问成功。四项都确认后，再逐项调整路由与自动化选项，每次只改一项，出现问题时才能回到上一次可用状态。