适合第一次在 Windows 或 macOS 使用 v2rayN 的用户。按安装包选择、文件落位、订阅导入、监听端口和系统代理逐项检查，先建立一条可验证的连接，再调整路由与启动选项。本文端口均作为明确标注的配置示例，最终以客户端当前设置和启动日志为准。
安装包选择：先核对系统与处理器
v2rayN 是桌面客户端，界面负责管理配置，实际连接由内核处理。能打开主窗口，只能说明界面已运行，并不代表内核、节点和系统代理都已准备完成。首次安装应从客户端下载页选择对应平台，再核对处理器架构与包的说明。
Windows 可在「设置」→「系统」→「系统信息」查看系统类型；macOS 可在苹果菜单的「关于本机」查看芯片。Intel 与 AMD 的常见桌面设备通常选择 x64；搭载 ARM 处理器的设备应优先选择对应架构包。不要把不同平台的内核文件混放到同一目录。
对应架构的完整包
推荐下载页若同时提供完整包和精简包，首次使用优先选择包含所需运行文件与内核的完整包。解压后仍要确认日志中的内核启动结果，不能只看文件数量。
适合：首次安装、希望减少手动补齐文件的用户。
精简包或单独更新包
按包说明补齐运行环境与内核，确认版本、架构和目录结构相互匹配。不要直接覆盖正在运行的程序目录。
适合：已有可用环境、清楚组件位置的用户。
文件落位：完整解压后再启动
Windows 压缩包应先完整解压到固定目录，例如 D:\Apps\v2rayN，再运行其中的主程序。不要从压缩软件预览窗口启动，也不要只把主程序拖到桌面：内核、资源文件和运行依赖可能仍留在压缩包里。
macOS 如果下载的是磁盘映像或应用包，按包内说明把应用放入「应用程序」后启动；如果提供的是压缩包，先完成解压。首次打开遇到系统安全提示，应先确认下载来源和包的完整性，再到「系统设置」→「隐私与安全性」查看对应应用提示，不要关闭整个系统的安全防护。
-
固定目录
Windows 选择当前账户可写的目录；macOS 按包说明放置应用。避开临时解压目录，也不要在多个文件夹保留同时运行的副本。
-
首次启动
打开主界面，查看日志或底部信息区域。若出现缺少运行环境的提示，按提示安装匹配架构的运行环境，不要把任意动态库复制进程序目录。
-
核对内核
在「设置」→「参数设置」查看内核相关选项，结合日志确认实际启动的内核。提示找不到文件时，检查完整解压结果及所选内核对应目录。
-
导入配置
进入「订阅分组」→「订阅分组设置」，新增分组并填写订阅地址；保存后在「订阅分组」菜单执行更新订阅。名称略有差异时，选择对应分组的更新命令。
-
选中服务器
在列表中选中一条配置并设为活动服务器，再检查内核启动日志。列表里有节点，不等于已经选定可供当前连接使用的节点。
如果内核文件被系统安全软件隔离，应先核对下载来源，再查看隔离记录并决定是否恢复。不要通过关闭全部防护来掩盖问题。更新或重新解压前，先退出托盘中的程序，并备份订阅分组、路由和自定义配置。
订阅与协议：导入后核对关键字段
订阅地址用于获取配置列表，不是本地代理地址。订阅可能包含认证信息，分享截图时应遮住完整链接、用户标识和密码。若只有单条分享链接，可使用「服务器」→「从剪贴板导入批量 URL」这一类导入命令；不要把分享链接填写到系统代理的服务器栏。
- 先确认订阅结果：更新后查看分组内是否出现配置，以及日志是否提示下载失败、解析失败或返回空内容。更新成功与服务器可连通是两件事。
- 再核对协议：VMess、VLESS 是不同协议；WebSocket 是传输方式，TLS 是连接安全设置，不能互相代替。导入后应保留服务端要求的组合。
- 按配置选择内核：VLESS 与 REALITY 等配置需要支持相应功能的内核与版本。Xray 与 V2Fly 的能力并不完全相同，不要把切换内核当成通用修复按钮。
- 避免盲改参数：服务器地址、端口、用户标识、传输路径、SNI 和公钥等信息必须与服务端对应。订阅已正确填写的字段，不应根据其他教程截图重写。
监听端口：统一客户端与应用设置
本地监听端口是浏览器、系统或命令行连接 v2rayN 的入口，不是远端服务器的端口。进入「设置」→「参数设置」，找到本地监听或入站相关设置，记录实际地址、端口以及支持的代理类型。不同版本和历史配置可能保留不同端口，不能只凭教程记忆填写。
下面两张卡假定你已确认当前存在 127.0.0.1:10808 混合监听，同时接受 HTTP 与 SOCKS 请求。若客户端使用分离监听，应分别填写真实端口；不能仅为了照抄示例而把两类入口强行改成同一端口。
HTTP 代理示例
- 代理类型
- HTTP
- 服务器
127.0.0.1- 端口
10808- 使用位置
- 支持手动 HTTP 代理的应用
访问 HTTPS 网站也可经 HTTP 代理建立隧道，不必因此改填 SOCKS 类型。
SOCKS 代理示例
- 代理类型
- SOCKS5
- 服务器
127.0.0.1- 端口
10808- 命令行形式
socks5h://127.0.0.1:10808
curl 的 socks5h 写法把目标域名交给代理处理；其他应用需查看自身的域名解析选项。
仅供本机使用时保留回环监听，不必打开允许局域网连接。修改端口后，应让内核重新加载配置，并同步更新手动代理应用。若日志出现 address already in use，先查是否同时运行了两个客户端实例，再定位占用进程，而不是连续尝试随机端口。
系统代理：先验证内核，再接管应用流量
首次排查建议先不启用 TUN，只验证本地代理链路。客户端有可用节点、内核已经监听后，再在主窗口或托盘菜单的「系统代理」中选择「自动配置系统代理」。这里的“自动配置”是客户端菜单动作，不等同于让用户手动填写 PAC 脚本地址。
- Windows：到「设置」→「网络和 Internet」→「代理」核对代理地址与端口是否指向当前监听入口。受组织策略管理的设备可能不允许修改，应先确认管理要求。
- macOS：到「系统设置」→「网络」→ 当前网络服务 →「详细信息」→「代理」检查。部分系统版本需要授权才能修改网络代理，不要忽略权限提示。
- 应用范围：系统代理不保证所有程序都会遵循。部分命令行工具、游戏和自行配置代理的应用有独立网络路径，不能用单个应用的结果推断所有流量。
- 退出顺序：停止使用前先清除系统代理，再退出客户端；退出后若网页打不开，优先检查是否仍保留指向本地端口的系统代理。
用显式代理请求隔离问题
Windows 可在 PowerShell 使用下面的命令；macOS 终端把 curl.exe 换为 curl。示例仍要求本地 10808 接受 HTTP 代理。测试地址为 https://example.com/，它只是连通性目标，不是专用测速服务。
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/收到 HTTP 响应说明这次请求走通了指定代理入口，但不能据此判断所有网站或 UDP 流量可用。若提示无法连接本地端口，先查监听；若已建立代理连接后出现 TLS 或远端超时，再结合内核日志检查节点、系统时间与网络。显式代理请求正常而浏览器失败时，排查浏览器独立代理设置、扩展及系统代理，不要立刻重装客户端。
首次运行常见坑：按症状缩小范围
窗口能打开，为什么启动节点就报错？
先看第一条内核错误。找不到可执行文件时检查解压目录和内核选择；提示配置字段不支持时核对协议与内核版本；提示端口被占用时检查重复实例。三种错误对应不同处理路径，单纯重开系统代理都不能解决。
节点显示延迟，网页却一直转圈？
延迟测试不等于完整网页访问。先用显式代理命令测试，再核对系统代理地址、端口和当前活动服务器。若只有特定域名失败，查看路由是否将其分到直连，以及日志是否出现解析或握手错误，不要一次改动 DNS、路由和内核三组设置。
macOS 每次打开都提示权限问题怎么办？
先确认应用已经移到固定位置，而不是仍从挂载的磁盘映像运行。安全提示到「系统设置」→「隐私与安全性」查看；系统代理修改失败则检查相应授权。若是组织管理设备，应联系管理员确认策略，不要执行来源不明的提权命令。
关闭客户端以后，为什么整个浏览器都断网了？
检查系统代理是否仍指向 127.0.0.1:10808 或旧端口。重新打开客户端并执行「系统代理」→「清除系统代理」，或在系统网络设置中恢复原有代理配置。若原先使用单位提供的代理，应恢复原值，而不是一概关闭。
完成检查：保存可用配置再做进阶调整
第一次配置成功后，先记录实际可用的设置，再考虑开机启动、路由规则和 TUN。系统代理决定应用是否把连接交给客户端；路由分流决定已进入内核的连接走哪个出口。两者处在不同环节，开启系统代理不等于所有目标都通过远端节点。
- 确认固定目录内的程序可以再次启动，内核日志没有启动错误。
- 记录活动订阅分组、节点协议、所用内核与本地监听端口，备份时妥善保护订阅凭据。
- 分别测试一项显式代理请求和一个遵循系统代理的浏览器访问。
- 测试一次清除系统代理后的正常网络访问，避免下次退出客户端后误判断网。
- 进阶修改每次只调整一项；保留修改前的路由、DNS 和入站配置，出错时可以逐项还原。
需要对照完整流程时，可查看客户端配置教程；需要区分 VMess、VLESS、传输与内核能力时，可查阅协议手册。先把“配置已导入、内核已启动、端口可访问、应用已使用代理”四个状态逐项确认，比反复重新下载安装包更容易定位问题。