本文速览

适合第一次在 Windows 或 macOS 使用 v2rayN 的用户。先按系统与处理器选择安装包，再完成运行环境、订阅导入和活动服务器设置，最后分别检查本地监听、系统代理与路由。首次验证只使用系统代理，不急着开启 TUN；遇到问题按“程序启动—核心运行—代理接入—流量分流”的顺序定位。

安装包选择：桌面版、WPF 与处理器架构

v2rayN 是桌面客户端，负责管理服务器配置、调用代理核心并提供系统代理等入口。客户端本身不附送可用服务器。开始前需要准备有效的订阅地址或服务器分享链接；仅打开主窗口，并不代表已经建立可用连接。

Windows 先进入「设置」→「系统」→「系统信息」，查看“系统类型”；macOS 打开苹果菜单→「关于本机」，查看“芯片”或“处理器”。Apple 芯片选择 ARM64，Intel 处理器选择 x64。Windows ARM 设备也应核对发行包说明，不要仅凭文件扩展名判断能否运行。

桌面版

推荐

采用跨平台界面。Windows 与 macOS 分别下载对应系统的发行包，设置思路相同，但系统权限和代理入口不同。本文优先按这一使用路径说明。

适合：首次使用，或需要在两种桌面系统间沿用操作习惯。

Windows WPF 版

保留经典 Windows 界面，仅用于 Windows。它不是 macOS 安装包，界面框架的差别也不等于服务器协议的差别；是否支持某个配置仍取决于实际调用的核心。

适合：熟悉经典 Windows 界面，且希望继续使用该界面的用户。

安装包以下载页当前说明为准。安装程序、压缩包和磁盘映像的处理方式不同，不能把所有发行形式都当成“解压后直接运行”。首次使用不要同时启动两个界面版本，以免争用本地端口。

Windows 首次启动：完整目录与运行环境

压缩包内可能同时包含主程序、核心目录和其他依赖文件。只把主程序拖到桌面，容易造成窗口可以打开、核心却无法启动的情况。使用压缩包时，先完整解压到当前用户可写的固定目录，例如 C:\Users\Public\Tools\v2rayN，并确认该目录的访问权限符合自己的使用范围。

  1. 展开安装包

    压缩包先执行资源管理器的「全部解压缩」，再进入解压后的目录；安装程序则按安装向导完成操作。不要在压缩软件的预览窗口中直接运行。

  2. 补齐运行环境

    若启动时提示缺少 .NET，按提示记录所需运行时类型、主版本和架构，再从 Microsoft 官方渠道安装。WPF 版需要匹配的 .NET Desktop Runtime；只装 SDK 或另一种架构的运行时，不一定能解决提示。

  3. 首次普通启动

    以普通用户权限打开主程序，先验证基础代理。不要把“以管理员身份运行”当作所有错误的通用修复；TUN 等功能涉及的额外权限，留到基础连接正常后单独处理。

  4. 确认写入权限

    打开设置并保存一次，再正常退出、重新启动。如果语言或其他选项恢复原状，检查配置保存位置是否可写，以及是否误启动了另一份程序。

macOS 首次启动：应用位置与安全提示

如果下载的是 .dmg，打开映像后按其中提示把应用拖入「应用程序」；如果是压缩包，先解压，再把应用移到固定位置。安装完成后退出映像，从「应用程序」启动，避免长期运行映像中的临时副本。

macOS 的系统代理按网络服务配置。Wi-Fi 与有线网络切换后，应进入「系统设置」→「网络」→当前网络服务→「详细信息」→「代理」查看实际状态。旧系统的入口可能位于「系统偏好设置」→「网络」→「高级」。

首次设置：语言、订阅与活动服务器

界面语言不影响服务器协议。需要调整时，从「设置」→「参数设置」查找语言选项，保存后按界面提示重启。不同发行版可能将语言入口放在设置菜单中；本文使用中文菜单名称，操作时以当前界面的同义入口为准。

  1. 建立订阅分组

    打开「订阅分组」→「订阅分组设置」，新增一组并填写备注和订阅地址。地址前后不要留空格，确认复制的是订阅链接，而不是网页登录地址。

  2. 更新订阅

    回到「订阅分组」，执行对应的更新操作。首次尚无可用代理时，先尝试不通过代理更新；只有已有可用连接、且直连获取失败时，再尝试通过代理更新。

  3. 检查导入结果

    确认列表出现服务器，检查协议、地址和端口是否有值。如果得到的是网页或登录提示，停止重复导入，向提供方确认订阅地址及访问条件。

  4. 设为活动服务器

    在目标服务器上右键，选择「设为活动服务器」，再查看核心日志是否正常启动。仅选中列表行不一定会切换实际使用的服务器。

若只有一条 vmess:// 或 vless:// 链接，可复制完整内容，再使用「服务器」中的“从剪贴板导入”入口。分享链接与订阅地址不是同一种输入：前者通常导入一个服务器，后者用于按分组拉取和更新配置。

系统代理与路由：分别完成首轮配置

系统代理决定遵循系统代理设置的应用如何接入本地监听；路由规则决定流量接入后走代理、直连还是被阻止。这两个开关不能互相替代。首次验证先使用系统代理，保持 TUN 关闭，减少权限、虚拟网卡和 DNS 接管带来的额外变量。

下面的 10808 是便于对照的示例端口，不保证是每个版本的默认值。先在「设置」→「参数设置」中确认实际本地监听类型和端口，再核对系统设置。若当前界面分别提供 HTTP 与 SOCKS 端口，应按协议分别填写，不能照抄混合监听的写法。

本地监听核对

监听地址
127.0.0.1，本机访问示例
监听类型
HTTP/SOCKS 混合，需以当前设置为准
示例端口
10808
局域网连接
首次设置保持关闭

先确认核心确实监听该端口，再配置调用它的应用；不要为排错直接开放所有网卡。

代理接入核对

系统代理
选择「自动配置系统代理」
HTTP 地址
127.0.0.1
HTTP 端口
与实际 HTTP 或混合监听一致
TUN 模式
基础验证阶段关闭

系统代理不是全设备流量接管；自行直连或使用独立代理配置的应用可能不遵循它。

Windows 可在「设置」→「网络和 Internet」→「代理」检查写入结果；macOS 则检查当前网络服务的代理选项。首次不要同时启用手工代理、自动配置脚本和另一个代理程序，避免无法判断实际生效的是哪一套配置。

连接验证：端口可用不等于网页可用

测试应从近到远。先确认客户端主窗口和核心都在运行，再看本地端口，最后验证代理请求。下面的命令假设已经确认 HTTP 或混合端口为 10808；如果实际端口不同，先替换数字。命令中的目标地址只用于演示请求方式。

Windows：先查监听，再发请求

Test-NetConnection -ComputerName 127.0.0.1 -Port 10808
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/

macOS：显式指定代理

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

显式代理参数可绕开“终端是否读取系统代理”的差异，但仍会受到核心路由规则影响。Windows 端口测试成功只说明本机有进程接受连接；HTTP 请求收到响应，也只说明该目标在当前规则下可达，不能据此推断所有网站、所有应用均正常。

观察结果优先检查下一步
本地连接被拒绝核心是否启动、端口是否一致查看核心日志，确认没有启动失败或端口占用
连接本地成功，请求超时活动服务器、远端连接和路由观察同一次请求对应的日志，避免只看历史报错
命令可用，浏览器不可用浏览器是否采用系统代理检查独立代理设置，重新建立浏览器连接
部分域名失败分流规则、DNS 与目标服务状态用同一目标重复测试，每次只调整一项设置

首次使用常见问题

窗口打开了，为什么还是不能上网？

依次确认服务器已导入、已设为活动服务器、核心启动成功，再查看「系统代理」是否选择「自动配置系统代理」。若显式代理命令能访问而浏览器不能，先检查浏览器接入方式，不要立即更换服务器协议。

提示端口被占用，要把端口都改掉吗？

先退出另一份 v2rayN 或仍在运行的核心进程。Windows 可执行 netstat -ano | findstr :10808 查看监听情况，再在任务管理器核对对应 PID；不要结束不认识的系统进程。确需更改端口时，同步更新调用代理的应用设置。

订阅第一次更新就超时怎么办？

先检查地址是否完整、订阅是否仍有效，以及系统日期和时间是否正确。没有可用代理时不要反复选择“通过代理更新”；已有可用服务器且直连失败时，再尝试该方式。更多情况可查看订阅更新排查。

退出客户端后，网页反而打不开了？

先重新打开客户端，在「系统代理」中选择「清除系统代理」，再正常退出。若程序异常终止，去系统代理页面清除本次设置留下的本地地址；单位网络原有的代理或脚本应先记录，不能随意删除。

需要一开始就开 TUN 吗？

不需要。先用浏览器和显式代理命令确认基础链路。只有应用不遵循系统代理、且确有接管需求时，再单独配置 TUN，并检查权限、路由和 DNS。开启后应重新验证原先可用的请求，不能把它当作连接失败的必选修复。

完成初始设置后的收尾

首次配置完成的判断标准不是图标变色，而是活动服务器明确、核心无启动错误、目标请求按预期路由，且正常退出后本地网络可以恢复。先保留这一套最小可用设置，再逐项增加开机启动、更多规则或 TUN 功能，出了问题才容易回退。