适合第一次使用 v2rayN，或从 Windows 迁移到 macOS 的用户。按“匹配安装包 → 启动内核 → 导入配置 → 确认本地监听 → 设置系统代理 → 验证请求”的顺序操作，先跑通一个节点，再配置分流和其他功能。文中的端口是明确标注的配置示例，不代表所有版本的默认值；菜单文字可能随桌面界面版本变化，应结合当前设置页与运行日志核对。
1. 安装包选择：先核对系统与处理器
v2rayN 是桌面图形客户端，负责管理节点、订阅、路由及内核进程；真正处理代理连接的是内核。主窗口能够打开，只说明界面启动成功，不能据此判断内核已经运行，也不能证明浏览器流量已进入代理。首次安装要把这几个环节分开验证。
| 使用环境 | 选择原则 | 首次检查 |
|---|---|---|
| Windows x64 | 选择对应的桌面包；WPF 是 Windows 经典界面，不是 macOS 安装包。 | 在「设置」→「系统」→「系统信息」核对系统类型，并阅读安装包的运行要求。 |
| macOS Apple 芯片 | 选择 arm64 的 DMG。 | 打开苹果菜单 →「关于本机」，确认芯片信息。 |
| macOS Intel | 选择 x64 的 DMG。 | 核对处理器类型及软件要求的最低系统版本。 |
Windows 压缩包应先完整解压到一个可写目录，例如 C:\Tools\v2rayN，再启动其中的主程序。不要直接在压缩软件的预览窗口里运行，也不要只把主程序单独拖出来：内核、资源和其他依赖可能仍留在压缩包中。若下载的是安装程序，则按安装向导操作，不必强行套用解压流程。
macOS 打开 DMG 后，将应用拖入「应用程序」，弹出磁盘映像，再从「应用程序」启动。这样可以避免后续仍从临时挂载位置运行。跨设备迁移时，应使用客户端提供的导入或备份功能；不要直接覆盖另一平台的整个程序目录，尤其要重新检查内核路径和文件权限。
2. 首次启动：按五步建立最小配置
先使用普通系统代理模式完成基础验证。TUN、复杂分流、自定义 DNS 和自动启动可以稍后再加，避免多个变量同时变化。下面采用常见菜单名称；如果跨平台界面的入口位置不同，可在对应设置页按字段名称查找，不必寻找完全相同的按钮排列。
-
启动并看日志
打开主程序，查看主窗口的日志区域，确认没有“内核文件不存在”“权限不足”或启动后立即退出的错误。缺少依赖时按当前安装包说明补齐，不要从陌生页面单独下载同名运行文件。
-
录入订阅
进入「订阅分组」→「订阅分组设置」，新增分组，把订阅地址填入 URL 字段并保存；再从「订阅分组」菜单执行「更新全部订阅（不通过代理）」。部分界面把更新操作放在分组右键菜单中。
-
选中节点
更新后确认列表出现节点，选中目标节点并按 Enter，或从右键菜单执行「设为活动服务器」。核对当前活动项，避免只是选中了表格行，却没有真正切换连接配置。
-
核对内核
打开「设置」→「参数设置」中的「Core 类型」或对应内核设置页，检查当前协议使用的内核。保存后观察重启日志；若版本没有这一选项，以节点编辑页和实际启动日志显示的内核为准。
-
设置系统代理
Windows 从托盘图标的「系统代理」菜单选择「自动配置系统代理」；跨平台界面若提供状态栏入口，可从同名入口操作。macOS 如要求代理设置授权，先阅读提示，再核对系统网络设置中的实际代理地址与端口。
订阅无法直连更新时，只有已经存在一个可用活动节点，才适合尝试「更新全部订阅（通过代理）」。空列表、内核未启动时直接切换这个选项，通常不能解决首次导入问题。单节点分享链接则使用「服务器」→「从剪贴板导入分享链接」，不应当作可定期刷新的订阅地址填写。
3. 内核选择：按节点参数，不按名称猜性能
Project V 是相关代理技术的生态背景，V2Fly 与 Xray 是不同的内核项目。v2rayN 能否使用某个内核，要看当前版本、安装包和配置入口是否支持。不要仅因为界面中出现 VMess 或 VLESS，就推断任意内核都能处理节点的全部扩展参数。
Xray 内核
推荐节点包含 VLESS、REALITY 或 Vision 参数时，优先核对 Xray 的适用条件与版本要求。保留订阅提供的传输、安全层、服务器名称和 Flow 等字段，不要把 VMess 节点直接改成 VLESS。
适合：服务端明确要求 Xray，以及使用相应扩展参数的节点。
V2Fly 内核
当当前 v2rayN 版本提供该内核选项，且服务端配置明确兼容时，可以按其要求使用。导入 VMess 也仍需核对传输、安全层及内核版本；不能把更换内核视为通用修复办法。
适合：已有明确 V2Fly 配置要求、需要保持原有配置行为的环境。
确认内核是否生效，要看保存配置后生成的启动记录和错误信息，而不是只看下拉框。若提示未知字段、无法解析配置或不支持某种安全设置，先检查内核版本与节点参数是否匹配；若提示连接超时，则继续检查网络可达性、服务端地址和端口。两类错误不是同一层的问题。
- 每次只改一项：先记录当前设置，再调整内核或节点参数，避免无法回溯。
- 订阅字段优先：自动导入后不要随意重写 SNI、传输路径或公钥。
- 界面与内核分开看：升级界面不等于已经更新所有内核文件，具体以安装包说明和运行记录为准。
4. 本地端口：区分代理入口与远端服务器
浏览器连接的是电脑上的本地代理入口，内核再连接远端服务器。节点中的远端端口，例如 443，不应该直接填入系统代理的本地端口栏。下面用一组便于排查的示例说明；实际值必须以「设置」→「参数设置」中的本地监听配置为准。
有些版本提供独立 SOCKS 与 HTTP 端口，有些使用混合入口。只有确认该端口支持 HTTP 代理时，才能用它设置系统 HTTP/HTTPS 代理。不要照抄示例后假定端口已经存在，也不要为了让其他设备连接而直接把监听范围放宽到所有网卡。
客户端监听示例
- 监听地址
- 127.0.0.1
- SOCKS 入口
- 10808，需确认已启用
- HTTP 入口
- 10809，需确认已启用
- 局域网访问
- 首次调试保持关闭
这是配置示例，不是固定默认值；混合入口请按当前版本实际设置填写。
系统代理核对
- 服务器地址
- 127.0.0.1
- HTTP 端口
- 与客户端 HTTP 或混合入口相同
- HTTPS 请求
- 使用支持 CONNECT 的本地 HTTP 代理
- 退出后的处理
- 停用客户端前清除对应代理设置
HTTPS 代理栏通常仍指向本地 HTTP 代理入口，并不要求在回环地址上部署证书。
Windows 可在「设置」→「网络和 Internet」→「代理」查看系统代理；macOS 可在「系统设置」→「网络」→ 当前网络服务 →「详细信息」→「代理」检查。若客户端使用 PAC，应核对自动代理配置项；若使用手动 HTTP 代理，则核对服务器与端口，不能只查看其中一种设置。
5. 连通性验证：先测入口，再测浏览器
系统代理只影响遵循系统代理设置的程序，并不等于接管整台电脑的所有流量。路由规则又是在请求进入内核后决定直连还是代理；“开启系统代理”和“所有请求走远端节点”不是同一个动作。首次测试应选一个确定会命中代理规则的目标，并同时查看日志。
- 确认活动节点、内核启动时间与本地监听端口，先排除进程未启动。
- 用命令显式指定代理，验证本地入口到远端目标这一条链路。
- 再用浏览器访问同一目标；命令成功而浏览器失败时，重点检查系统代理和浏览器自有设置。
- 在基本连接稳定后，再逐项调整路由、DNS 和其他接管方式，每次修改后重复测试。
以下命令假定已确认 127.0.0.1:10808 是 SOCKS 入口。socks5h 会把目标域名交给代理端处理，适合与应用自行解析域名的情况做对比；它不能单独证明整台电脑不存在其他 DNS 请求。
Windows PowerShell
Get-NetTCPConnection -LocalPort 10808 -State Listen
curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.commacOS 终端
lsof -nP -iTCP:10808 -sTCP:LISTEN
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com这里的 10 秒连接超时与 20 秒总时限是诊断参数，不是实测延迟。监听检查没有结果时，先修复本地入口；提示拒绝连接时，检查端口、进程和入口类型；收到 HTTP 响应说明该次请求已经到达目标并获得响应，但最终走直连还是代理仍要结合路由日志判断。证书错误则还需检查系统时间和信任链，不应直接关闭证书验证。
6. 常见坑：安全提示、端口冲突与退出后断网
Windows 安全软件拦截了，直接放行吗？
不要仅凭文件名认定是误报。打开「Windows 安全中心」→「病毒和威胁防护」→「保护历史记录」，记录具体检测名称与被拦截路径，核对下载来源、包内文件及发布说明。确认前不要关闭整套防护，也不要给整个下载目录添加排除项；判断不清时先停止运行。
macOS 提示无法验证开发者怎么办？
先确认应用来源和系统版本要求。对于系统允许用户确认打开的开发者验证提示，可在尝试启动后前往「系统设置」→「隐私与安全性」，查看是否提供“仍要打开”。若提示包含恶意软件风险，应停止操作并进一步核实，不要把所有安全警告都当成普通首次启动提示。
日志里出现 address already in use？
这是监听地址或端口冲突。Windows 可运行 netstat -ano | findstr :10808，macOS 可运行 lsof -nP -iTCP:10808 -sTCP:LISTEN，再按进程信息确认占用者。先退出重复启动的客户端；如需改端口，保存后重启内核，并同步更新系统代理和应用手动代理。
软件退出了，为什么浏览器反而断网？
系统可能仍指向已停止的回环代理。先重新打开 v2rayN，通过「系统代理」→「清除系统代理」清理其设置；无法启动时，在系统代理页面停用对应的手动代理或 PAC。公司受管理设备先记录原有设置，不要删除组织下发的代理配置。
节点显示延迟，网页还是打不开？
延迟测试只反映测试方法涉及的那一部分链路，不能代替应用访问验证。按前面的显式代理命令复测，再检查活动节点、路由命中、DNS 错误和浏览器代理设置。若多个节点都在同一步失败，优先排查共同的本地配置，而不是连续重装客户端。
7. 保存基线：更新与迁移前留下一份记录
第一次成功连接后，记录可工作的最小配置：客户端与内核版本、系统版本、活动节点所属分组、监听端口、系统代理方式和路由模式。后续升级出现问题时，这些信息比“昨天还能用”更容易帮助定位。跨平台配置应手动导入并复核，不应假设程序目录、权限或系统代理设置会自动同步。
- 更新前：通过当前客户端提供的备份或导出入口保存配置，并把订阅凭据与备份文件放在受控位置。
- 更新后：先复测原有节点和显式代理命令，再启用新功能；遇到异常时保留首次错误日志。
- 反馈时：提供系统架构、内核启动错误和复现步骤，遮盖订阅地址、用户标识及节点凭据。
- 迁移后：重新核对本地端口、内核文件位置、系统代理及防火墙提示，避免照搬另一台设备的路径。
完整的安装验收不是“窗口能打开”，而是内核能够稳定启动、本地入口有监听、显式代理请求可用、浏览器按预期进入代理，以及退出后系统网络恢复正常。需要进一步按错误现象排查时，可前往问题诊断，沿启动、监听、连接、解析与路由几个层次逐项检查。