v2rayN 首次安装设置清单:Windows 与 macOS 通用要点和常见坑

安装包选择：系统、架构与界面版本

v2rayN 是桌面客户端，负责管理节点、启动代理内核和调整系统代理；安装完成不等于已经获得可用节点。首次下载先确认操作系统与处理器架构，不要只看文件体积。Windows 的 x64 与 ARM64、macOS 的 Intel 与 Apple 芯片分别对应不同构建，能打开界面也不代表所带内核一定匹配。

• Windows：打开「设置」→「系统」→「系统信息」，查看“系统类型”中的处理器架构。常见 Intel、AMD 桌面设备通常选择 x64，ARM 设备应按下载页的对应说明选择。
• macOS：打开苹果菜单→「关于本机」，查看“芯片”或“处理器”。Apple 芯片选择对应 ARM64 构建，Intel 设备选择对应 x64 构建。
• 界面版本：跨平台桌面版面向 Windows、macOS 与 Linux；经典 WPF 版面向 Windows。两者的菜单布局不完全相同，不要拿某一版的按钮位置逐像素对照另一版。

安装位置：先完整解压，再启动主程序

解压包不能直接在压缩软件的预览窗口内运行。主程序通常还需要相邻目录中的内核、资源或配置文件；仅拖出一个可执行文件，容易出现界面能启动但核心进程无法加载的情况。安装器、压缩包、磁盘映像的处理方式不同，应遵循所选包的安装说明。

1. 确认包类型

   安装器按向导完成安装；压缩包先完整解压到固定目录。macOS 若提供磁盘映像，打开后将应用移至「应用程序」，不要长期从挂载的映像中运行。

2. 固定存放位置

   Windows 解压版可使用 D:\Apps\v2rayN 这类可写目录，避免临时目录、压缩预览目录与同步盘。路径含中文不必一概判错，重点是目录可写且文件完整。

3. 处理启动提示

   Windows 如提示缺少运行时，先读清名称与架构，再按该包说明补齐；不要任意下载 DLL。macOS 若提示无法验证开发者，先确认来源，再到「系统设置」→「隐私与安全性」查看是否有针对该应用的允许入口。

4. 首次普通启动

   先以普通用户权限运行，只测试系统代理模式。暂不打开 TUN，也不为了解决所有问题直接提升权限；这样能把权限问题与节点问题分开。

5. 保留运行记录

   打开「帮助」→「关于」记录客户端版本，并在日志中记录内核名称与版本。检查一次退出、再次打开后节点是否仍在，确认配置能够正常保存。

内核加载：界面启动与代理就绪分开检查

v2rayN 的界面进程不是实际转发流量的内核进程。选中节点并设为活动服务器后，还要确认内核启动成功、本地端口开始监听。日志中的“找不到文件”“权限不足”“地址已被使用”分别对应不同方向，反复点连接通常不能解决这些问题。

进入「设置」→「参数设置」，查找当前版本提供的内核选择或“Core 类型”相关项目，确认节点使用的内核；若界面布局不同，以功能名称和运行日志为准。不要仅因节点名称写着 V2Ray，就强行把所有配置切到某一个内核。VMess、VLESS 是协议名称，Xray 等是内核实现，节点要求还包括传输与安全参数。

• 缺少内核文件：先确认下载的是带所需内核的完整包；若该构建要求额外准备内核，按包说明放到指定位置，不要随意改文件名。
• VLESS 与 REALITY：确认所选内核支持服务端要求的组合。服务器名、公钥、短 ID 与 flow 等应保留订阅原值，不能靠猜测填写。
• VMess 与时间：若日志提示认证或时间相关错误，先检查系统自动校时，再核对节点参数。系统时间严重偏差也可能影响 TLS 证书验证。
• 退出旧进程：先从托盘或菜单栏退出另一份 v2rayN，再启动当前版本。两个界面可能启动各自的核心，争用同一监听端口。

订阅导入：先确认来源，再验证一条节点

客户端安装包本身不提供服务器连接信息。订阅地址由服务提供方给出，通常包含访问凭据，应当按账号密码一样保存。不要把完整订阅链接粘贴到公开截图、讨论区或在线解析工具中；求助时可描述状态码和报错，隐藏链接中的令牌。

1. 打开「订阅分组」→「订阅分组设置」，新增分组，填写可辨认的名称与订阅 URL。不同界面版本可能以“添加”或“+”呈现新增操作。
2. 保存后，在「订阅分组」菜单执行当前分组的更新操作。首次还没有可用代理时，先尝试不通过代理更新；只有直连失败且已有可用节点时，再尝试通过代理更新。
3. 更新成功后确认服务器列表确实新增条目。只有分组名、没有服务器，可能是返回内容为空、订阅到期或格式不受当前版本支持，应先看更新日志。
4. 选中一条节点，通过右键菜单「设为活动服务器」启用，再查看内核日志。不要仅选中表格行就认为已切换了实际出站。

首次验证只需选一条节点，不必对整个订阅反复测速。延迟测试成功只说明对应测试请求得到了响应，不代表浏览器已经使用代理，也不代表下载带宽达到某个值。先让同一节点完成一次实际网页访问，再比较其他节点，排查结果更容易复现。

系统代理与端口：先用浏览器建立基准

系统代理和路由分流是两层设置：前者决定应用是否把请求送到本地代理，后者决定进入内核的请求如何出站。首次测试可在 v2rayN 主界面或托盘的「系统代理」菜单选择「自动配置系统代理」，同时保持常规路由设置。不要把“开启系统代理”理解成所有程序都被接管；部分应用不读取系统代理。

Windows 可到「设置」→「网络和 Internet」→「代理」核对系统代理；macOS 可到「系统设置」→「网络」→当前连接→「详细信息」→「代理」查看。系统入口名称会随系统版本调整。先由客户端写入，再到系统页确认结果，避免两边同时修改造成混淆。

curl -I -x http://127.0.0.1:10808 https://example.com

上面的命令仅适用于确实在 10808 提供 HTTP 或混合代理的配置；Windows 可用 curl.exe 避免命令别名影响。它显式指定代理，用于区分“本地代理可用”与“系统代理没有被应用读取”。返回 HTTP 响应说明这一次请求获得响应，不是速度测试；连接被拒绝则先查监听端口，TLS 或远端连接错误再结合内核日志判断。

• 命令成功、浏览器失败：暂时停用浏览器内单独设置代理的扩展，检查是否使用了另一套端口。
• 命令和浏览器都失败：先核对内核是否运行，再核对活动节点与日志，不要立刻更改 DNS、Mux 和所有路由规则。
• 仅部分网站失败：记录域名、时间与命中的路由，再检查 DNS 或分流。不要把一次网页失败直接归因于安装包。

开机自启与退出：确认代理不会残留

开机自启应放在连接验证之后设置。自动启动客户端、启动后最小化、自动设置系统代理是不同开关：界面已经在后台运行，不代表系统代理已写入；系统代理已开启，也不保证上一次活动节点仍然可用。首次配置完成后，至少做一次退出重开和一次重新登录测试。

• 客户端侧：到「设置」→「参数设置」查找自动启动、启动后最小化相关项目，按需启用。若当前构建没有对应选项，再使用操作系统提供的启动管理方式。
• Windows 侧：在「设置」→「应用」→「启动」核对启动项，避免同时保留快捷方式、任务计划和客户端自动启动三套入口。
• macOS 侧：在「系统设置」→「通用」→「登录项」核对应用是否允许登录时启动。应用移动位置后，也要重新验证登录项是否仍然有效。
• 退出前：先在「系统代理」菜单选择「清除系统代理」，再退出客户端。随后打开普通网页确认直连恢复；若之前有单位网络代理，应恢复原配置而不是直接清空。

首次安装常见问题：按现象只改一项

完成安装的判断标准可以很具体：客户端重开后仍能读取配置，活动节点能启动内核，浏览器能经系统代理访问，退出后直连恢复，重新登录后自启符合预期。保留客户端版本、内核版本、监听端口和一次失败日志，比一句“连不上”更有助于后续定位。备份配置时还要注意其中可能包含订阅凭据与节点密钥，不要公开上传。