先选版本：桌面版、经典版与处理器架构
安装 v2rayN 的第一步不是导入订阅，而是确认操作系统、处理器架构和界面版本。安装包选错时，常见结果是程序无法启动、系统提示应用不兼容，或者核心进程启动后立即退出。先在系统信息中确认设备类型，再进入下载中心选择对应文件。
Windows 如何选择
大多数近年生产的 Windows 电脑使用 x64 架构，应选择 Windows x64 安装包。使用 ARM 处理器的设备选择 arm64。只有明确运行 32 位系统时才考虑 x86 包；如果系统设置显示“64 位操作系统，基于 x64 的处理器”，就不要下载 x86 版本。
v2rayN 桌面版采用面向多平台的界面，Windows 与 macOS 的主要操作路径接近，适合需要在两套桌面系统之间保持相似使用方式的用户。经典版主要面向 Windows，菜单结构、托盘操作和服务器列表管理方式沿用较久，适合已经熟悉原有操作流程的用户。两者都可以完成订阅导入、节点选择、系统代理和路由分流，但设置名称与菜单位置可能随版本调整。
macOS 如何选择
在 macOS 中打开“关于本机”或“系统信息”，先确认处理器类型。Apple 芯片设备选择 arm64，Intel 处理器设备选择 x64。架构不匹配时，即使系统能够通过兼容机制尝试运行，也可能增加核心调用、托盘显示和更新过程中的排查成本，首次安装应直接使用原生架构包。
从旧版迁移到新版时，建议重新导入订阅，不要直接覆盖整套程序文件。旧设置中可能保存了不同的核心路径、本地端口、路由规则和界面字段，整包覆盖容易把失效配置一并带入。需要保留自定义规则时，可以先记录规则内容、监听端口和订阅分组，再在新版本中逐项恢复。
安装前准备：文件位置、运行权限与网络状态
Windows 经典版可能以压缩包形式提供。解压后再运行主程序，不要直接在压缩文件预览窗口中启动。程序需要在自身文件夹中读取核心、配置和运行数据；从临时预览位置启动，容易出现核心文件找不到、配置无法保存或更新后文件散落的问题。
程序文件夹应放在当前账户有读写权限的位置。路径可以使用英文或中文，但不宜放入会被频繁清理的临时文件夹。Windows 首次配置时通常不需要长期使用管理员身份运行。只有启用需要系统级权限的网络功能，或系统安全策略明确拦截写入时，再按提示处理权限。
macOS 下载完成后，将应用移动到“应用程序”再启动。系统首次打开从网络取得的应用时可能要求确认来源，可在系统设置的隐私与安全页面查看当前拦截原因。确认文件来自本站下载中心后，按系统给出的允许步骤操作。不要反复移动应用位置，否则系统可能重新记录权限，导致开机启动或网络权限需要再次确认。
首次启动前还要检查三项基础状态：
- 系统日期、时间和时区保持正确。时间偏差会影响依赖 TLS 的连接。
- 当前网络可以正常访问本地网络与常用直连站点，避免把基础断网误判为节点故障。
- 退出正在占用本地代理端口的旧实例，尤其是此前运行过的 v2rayN 进程。
首次启动：先检查核心，再设置本地端口
v2rayN 是图形客户端，真正处理 VMess、VLESS、Trojan 或 Shadowsocks 连接的是所选内核。常见配置会使用 Xray 内核，也可以按照版本提供的选项使用 V2Ray 内核。客户端负责管理配置、调用内核、切换系统代理和显示运行日志。界面能够打开，不等于核心已经成功运行。
首次启动后，先进入设置页面查看核心类型与核心路径。如果版本提供核心检查或版本信息功能，应先执行一次。日志中出现核心版本、监听地址和启动完成信息，说明程序已经进入可接收本地连接的状态。如果日志提示找不到可执行文件，应重新检查安装包是否完整解压、处理器架构是否正确，以及安全设置是否阻止核心启动。
接着确认本地监听端口。不同版本可能提供 SOCKS、HTTP 或混合端口，界面默认值也可能变化。新手可以保留当前版本给出的默认设置，不必为了照搬旧教程而强行改成某个固定数字。真正需要记录的是“当前实际端口”，因为浏览器手动代理、开发工具和端口排查命令都必须与它一致。
本地监听地址通常保持为回环地址，仅供本机程序连接。除非明确需要让局域网其他设备接入，否则不要开启允许来自局域网的连接。开放局域网监听后，还需要同时考虑系统防火墙、网络环境和访问控制，不属于首次安装的必要步骤。
日志中应关注哪些字段
address already in use：本地端口已被其他进程占用。connection refused：目标地址拒绝连接，可能是服务器未监听或端口填写错误。timeout：连接在规定时间内未完成，需要区分本地网络、服务器状态和路由路径。failed to parse：配置内容无法解析，常见于订阅转换异常或手动参数格式错误。- 证书名称或握手相关错误：重点核对服务器地址、SNI、传输方式和安全层参数。
不要只看服务器列表中的延迟数字。延迟测试可能使用不同的探测方式，能够返回延迟不代表目标网站一定可以访问；反过来，某些服务器不响应特定探测，但实际代理连接仍可能正常。判断配置是否可用，应以核心日志、实际连接测试和订阅参数是否完整为准。
导入订阅：更新、分组与节点选择
拿到订阅地址后，在订阅分组管理中新增一条记录。名称用于本地识别，可以写服务用途或线路类别；地址必须完整复制，避免前后混入空格或换行。保存后执行订阅更新，服务器列表出现配置才算完成导入。只保存订阅地址而不执行更新，不会自动生成节点。
订阅更新失败时，先检查地址是否过期、当前网络是否能访问订阅服务器，再查看更新日志。不要连续创建多条相同订阅。重复分组会产生同名节点，使后续判断当前配置来源变得困难。更新后的节点数量与服务端发布内容有关，不应通过反复点击更新来增加。
选择节点时，应重点核对协议与参数是否完整。VMess 配置通常包括用户标识、传输方式和安全设置；VLESS 还可能依赖 TLS、Reality、SNI、指纹或流控参数；Trojan 需要正确的密码和安全层信息；Shadowsocks 需要匹配的加密方式与密码。v2rayN 会根据订阅内容生成配置，普通用户不应在不清楚服务端设置的情况下随意修改这些字段。
节点选中后，需要将它设为活动服务器。列表中高亮某一行不一定等于已经切换；应观察状态栏、托盘菜单或日志中的当前服务器信息。切换后核心通常会重新载入配置，短时间内已有连接可能中断，这是配置重载的正常结果。
系统代理模式：为什么节点可用但浏览器没走代理
核心启动后只是在本机开放代理入口。应用是否经过该入口，取决于系统代理、应用自身代理或其他接管方式。首次安装最常见的问题是服务器测试正常、日志也显示核心运行，但浏览器仍然直连。原因通常不是协议错误，而是系统代理尚未启用。
在 v2rayN 中选择“设置系统代理”后，客户端会把当前本地代理地址写入操作系统。大多数遵循系统代理的浏览器和桌面程序会读取该设置。设置完成后，先关闭并重新打开浏览器测试；部分已启动程序只在启动时读取代理状态，不会立即响应系统设置变化。
系统代理常见模式可以按以下逻辑理解：
- 清除系统代理：移除 v2rayN 写入的代理设置，应用恢复按系统原有网络方式连接。
- 自动配置或规则模式：系统根据配置脚本或规则决定哪些请求交给本地代理。
- 全局代理：遵循系统代理的请求统一进入 v2rayN，再由核心路由决定最终出口。
“系统代理规则”和“核心路由规则”不是同一层。系统代理决定流量是否进入 v2rayN，核心路由决定已经进入的流量走代理、直连还是阻断。某个应用完全不读取系统代理时，修改核心路由不会让它自动进入代理。此时应先查看该应用是否提供独立的 HTTP 或 SOCKS 代理设置。
macOS 可在系统网络设置的代理页面核对当前服务是否写入了 HTTP、HTTPS 或 SOCKS 项。Windows 可在系统代理设置中确认地址和端口。手动检查时，端口必须与 v2rayN 当前监听值一致。若系统页面仍保留旧端口，应先在 v2rayN 中清除系统代理，再重新设置。
路由分流：先用预设，再处理自定义规则
路由分流用于决定进入核心后的连接出口。首次使用不建议立即堆叠大量自定义域名与 IP 规则。先选择版本提供的基础预设，确认代理连接和直连都能工作，再根据实际需求添加规则。这样出现异常时，可以明确判断是服务器、系统代理还是路由规则造成。
规则通常按顺序匹配，前面的规则可能先于后面的规则生效。域名规则用于匹配请求中的域名，IP 规则用于匹配解析后的地址，进程规则则依赖客户端与操作系统是否支持对应识别方式。修改规则后应重新载入配置，并通过日志确认实际命中了哪一条规则。
DNS 也会影响分流结果。如果规则依赖域名，但应用提前把域名解析为 IP，再把纯 IP 连接交给代理，核心可能无法取得原始域名。反过来，DNS 请求与实际连接使用不同出口时，也可能得到不适合当前线路的地址。首次设置阶段应保持 DNS 方案简单，等基础连接稳定后再配置国内外域名分组、远端解析或更细的防污染规则。
不要把“全局代理”理解为所有设备流量必然全部经过服务器。只设置系统代理时，仍有应用可能绕过系统代理；局域网其他设备也不会自动接入。需要接管更多类型流量时，可以研究客户端提供的 TUN 功能，但它涉及虚拟网卡、系统权限、DNS 接管和路由表变化，不适合作为首次安装的第一步。
常见故障一：系统代理未生效
系统代理未生效可以按固定顺序排查，避免同时修改多个选项。
- 确认 v2rayN 主程序仍在运行，托盘中可以找到图标。
- 查看核心日志，确认本地监听已经成功建立。
- 确认当前服务器已设为活动服务器，而不是仅在列表中被选中。
- 在系统设置中检查代理地址是否为本机地址，端口是否与客户端一致。
- 重新启动要测试的浏览器或应用，排除旧进程缓存代理设置。
- 暂时使用基础路由预设，排除自定义规则把目标错误分到直连或阻断出口。
如果只有某一个应用不生效，而浏览器可以正常通过代理访问，应优先检查该应用自身的网络设置。有些程序使用独立代理，有些程序只支持 HTTP 代理，还有些程序完全忽略系统代理。此时复制 v2rayN 的本地地址与对应协议端口到应用设置中，比反复切换服务器更有效。
如果所有应用都无法连接，但关闭系统代理后直连恢复，应查看核心是否已经退出。系统代理只是把请求发送到本地端口，本地没有进程监听时，表现通常是网页立即报连接失败。重新启动核心后仍失败，再检查端口占用与配置解析错误。
常见故障二：端口占用与重复进程
端口占用常见于旧版 v2rayN 没有完全退出、程序崩溃后核心进程仍在后台运行，或者其他网络工具使用了相同端口。日志中的 address already in use 是直接信号。处理时不要连续启动多个客户端实例，应先找出监听端口的进程。
Windows 可以在 PowerShell 中检查示例端口 10808。如果实际设置不是该端口，把命令中的数字改为当前值：
Get-NetTCPConnection -State Listen |
Where-Object LocalPort -eq 10808 |
Select-Object LocalAddress, LocalPort, OwningProcess取得进程编号后，可在任务管理器的“详细信息”中核对进程名称。确认是遗留的 v2rayN 或核心进程后，先从客户端菜单正常退出；只有界面已经无法操作时，再结束对应进程。不要在未核对名称的情况下批量结束系统进程。
macOS 可以在终端检查同一示例端口：
lsof -nP -iTCP:10808 -sTCP:LISTEN如果端口由另一项明确需要保留的服务占用，可以在 v2rayN 中更换本地监听端口。修改后要同步检查系统代理和使用手动代理的应用。只改客户端端口、不更新应用端口，会造成核心运行正常但应用无法连接。
重复进程还可能来自开机启动。新版与旧版同时设置自动启动时，登录系统后会先后抢占同一端口。迁移完成后，只保留当前使用版本的开机启动项，并确认旧程序已经退出。Windows 可检查启动应用列表，macOS 可检查登录项与后台扩展。
常见故障三：订阅更新成功但节点不能连接
订阅更新成功只说明客户端取得并解析了订阅内容，不代表每个服务器都在线。节点无法连接时，先切换同一订阅中的另一条配置。如果多条配置同时超时，再检查本地网络、订阅有效状态和服务端通知；如果只有单条失败，重点查看该节点的地址、端口和协议参数。
手动修改订阅节点后，下次更新可能会被服务端内容覆盖。需要临时测试时，可以复制一份配置再修改，并保留原始订阅节点作为对照。不要把不同节点的 SNI、传输路径、用户标识或 Reality 参数混合使用，这些字段必须与对应服务端保持一致。
协议选择应服从订阅内容。客户端支持某种协议，不等于现有服务器可以随意切换到该协议。VMess、VLESS、Trojan 和 Shadowsocks 的认证与传输参数不同，不能只修改协议名称完成转换。普通用户应直接使用订阅下发的完整配置。
安装完成后的稳定使用清单
首次设置完成后，建议保留一套可复现的基础状态：一个正常更新的订阅分组、一条已验证的服务器、默认本地端口、基础路由预设和清晰的系统代理状态。以后出现问题时，先回到这套状态，再逐项恢复自定义设置。
- 更新客户端前记录当前版本、核心类型、本地端口和路由预设。
- 订阅更新后确认当前活动服务器是否仍然存在。
- 切换网络后重新做一次实际连接测试，不只依赖旧延迟结果。
- 退出客户端时确认系统代理已经恢复到预期状态。
- 遇到故障先保存相关时间段日志，再重启程序，避免关键报错被覆盖。
- 自定义规则一次只改一组，修改后重新载入并验证命中结果。
Windows 与 macOS 的界面位置不同，但排查逻辑相同：先确认客户端进程，再确认核心进程；先确认本地端口，再确认系统代理；先验证订阅参数，再检查路由和 DNS。按这一顺序操作，可以把“程序打不开”“节点连不上”“浏览器不走代理”拆成独立问题，避免在多个设置页面之间来回试错。