v2rayN 首次安装与初始设置:Windows 和 macOS 初次运行的常见坑

先选安装包：系统、架构与运行环境

先在下载页按系统和处理器架构选择安装包，不要只看文件名里的 v2rayN。Windows 桌面版与经典 WPF 版不是同一套界面；WPF 版用于 Windows，不能拿到 macOS 上运行。macOS 则需要区分 Apple Silicon 与 Intel，分别选择 arm64 与 x64 对应的包。

v2rayN 是配置和管理代理的客户端，真正处理连接的是内核。窗口可以正常打开，不代表内核已经就绪。首次启动遇到缺少运行环境的提示，应保留提示中的框架名称、架构和要求，再按安装包说明补齐；不要凭印象安装一个名称相近的运行时。

首次启动：解压目录与权限提示

Windows 压缩包应完整解压后运行，不能直接在压缩软件的预览窗口里双击主程序。可选择当前账户可写的独立目录，例如 D:\Tools\v2rayN。这个路径只是示例，不要求电脑必须有 D 盘；重点是主程序、随附文件和子目录要一起保留。

如果只复制一个可执行文件到桌面，客户端可能找不到内核或其他依赖。先退出程序，再重新完整解压，通常比逐个补文件更容易定位问题。也不要让两份不同目录中的程序同时运行，否则看到的配置、日志和端口可能不是同一份。

1. 完整解压

   在 Windows 中对下载的压缩包执行「全部解压缩」，进入解压后的目录启动主程序。不要移动或删除不认识的内核子目录。

2. 固定位置

   在 macOS 中将应用复制到「应用程序」，弹出磁盘映像后再打开应用。这样可避免一直从临时挂载位置运行。

3. 核对提示

   遇到系统拦截，先核对文件来源与提示内容。macOS 的允许打开入口通常在「系统设置」→「隐私与安全性」；只对已经确认来源的应用操作，不关闭整机安全保护。

4. 查看日志

   进入客户端的「日志」区域，检查是否出现缺少文件、拒绝访问或端口占用。菜单位置会随桌面界面变化，优先保留第一条具体错误。

导入订阅：保存地址不等于取得节点

订阅地址是用来获取节点配置的地址，不是节点名称，也不是服务商的登录页面。拿到地址后，先在客户端中建立订阅分组，再执行更新。只保存分组却没有更新，节点列表仍可能为空；更新成功后，也还需要选择一个节点作为活动服务器。

不同桌面界面会将入口显示为「订阅分组」或「订阅分组设置」。以下按常见菜单文字描述操作；如果按钮名称有调整，寻找“分组设置”和“更新订阅”这两个功能，而不是照着别人的截图随意修改其他选项。

1. 打开「订阅分组」→「订阅分组设置」，选择「添加」，填写便于识别的名称与完整订阅地址。
2. 保存后，回到「订阅分组」，对该分组执行「更新订阅（不通过代理）」。首次尚未建立可用代理时，这条路径便于减少依赖。
3. 如果直连无法访问订阅，而已有一个确认可用的代理节点，再尝试「更新订阅（通过代理）」。这不是所有订阅都必须开启的选项。
4. 更新完成后查看节点列表，选中一个节点，通过右键菜单的「设为活动服务器」或当前界面的对应操作启用它。
5. 若报解析错误，核对是否复制了完整地址、是否误贴网页地址，以及订阅提供方是否提供客户端可识别的格式。

节点能导入，只能说明配置被识别，不能证明服务端可连接。订阅地址也常带访问凭据，不要把完整地址贴进公开截图。需要求助时，保留报错文字与协议类型，遮住订阅参数、用户标识和服务器敏感信息。

选择内核：协议参数必须匹配

V2Ray 与 Xray 是内核项目，v2rayN 是桌面客户端，三者不是同一个名字的不同写法。VMess、VLESS 是节点协议；WebSocket 是一种传输方式；TLS 是连接保护机制。选择内核时，应看整个节点组合是否受支持，不能只看列表中的协议缩写。

对于使用 REALITY、xtls-rprx-vision 等参数的节点，应选择支持相应组合的 Xray，并确认客户端能够正确生成配置。常见入口是「设置」→「参数设置」→「Core 类型」；部分界面会将其独立列为「Core 类型设置」。修改后重新启用活动节点，再观察日志中的实际启动结果。

• 先保留导入值：地址、端口、用户标识、传输方式、路径、SNI 和公钥等字段由提供方决定，不要为了“优化”逐项猜填。
• 再核对支持范围：报“不支持的字段”或配置加载失败时，检查当前选中的内核及其对该配置的支持，而不是先改 DNS。
• 最后处理连接错误：配置加载成功后仍超时，再检查网络、服务端状态与节点信息。超时不等同于解析失败。

系统代理：核对本地地址与监听端口

第一次测试网页，优先使用系统代理。先在 v2rayN 的「系统代理」中选择「自动配置系统代理」，再检查操作系统记录的代理地址和端口。这个操作是让遵循系统代理的应用连接到本机客户端，不是把远端服务器地址直接填进系统设置。

下面两个端口是排查示例，不是要求覆盖现有设置，也不代表每个版本都默认使用它们。不同客户端界面可能使用混合监听，或分别提供 HTTP 与 SOCKS 监听；混合监听可在同一个端口处理两类代理协议，分离监听则需要分别核对。

若日志提示端口已占用，先退出重复启动的客户端和其他代理进程，再重试。确实需要改端口时，修改客户端监听后，应重新执行自动配置系统代理，并核对系统端口是否同步。只改一边，会出现窗口正常、节点已选中、浏览器却连接失败的情况。

验证与收尾：一次只改变一个变量

验证时先保持一个活动节点、一套已知路由和一种接管方式。系统代理只影响遵循该设置的应用，部分程序会使用自己的代理选项或直接连接。浏览器能打开网页，不代表所有应用都已经经过代理；节点延迟测试有结果，也不等于目标网站一定可用。

路由分流决定哪些连接直连、哪些连接进入代理。首次测试应使用客户端提供的、含义明确的预设，并记录选项。只有需要区分“规则未命中”和“节点不可用”时，才临时切换到全局代理测试，测试后恢复原来的分流设置。

• 窗口打不开：回到安装包、架构和运行环境，不要先处理订阅。
• 节点列表为空：检查分组保存、更新结果与订阅格式。
• 启动节点报错：检查内核支持、配置生成和本地端口占用。
• 浏览器提示代理连接失败：先核对本地监听与系统代理端口，而不是直接认定服务端故障。
• 只有部分网站打不开：再检查路由命中、DNS 解析和节点到目标网站的连通情况。

完成后记下安装目录、活动节点、所选内核、监听端口和系统代理状态。下次遇到问题，从最后一次改动的位置开始检查。升级前保存配置备份；不要把新旧目录中的配置和内核随意拼在一起，也不要在尚未确认可用时删除原有配置。