v2rayN 首次安装设置:Windows 与 macOS 解压运行、内核与权限常见坑

一、安装包选择：先分系统，再分处理器

v2rayN 是客户端界面，实际代理连接由内核完成。下载一个能打开窗口的主程序，不等于内核已经完整、配置已经可用。首次安装应保留安装包提供的目录结构；不要只把主程序复制到桌面，也不要把不同发行包里的文件混在一起。

Windows 在「设置」→「系统」→「系统信息」中查看“系统类型”；macOS 在苹果菜单→「关于本机」中查看“芯片”或“处理器”。Apple 芯片对应 ARM64，Intel 处理器对应 x64。Windows ARM 设备不要把 x64 包当作原生 ARM64 包，是否能运行还取决于系统的兼容能力。

二、Windows 解压与首次启动：固定目录，完整保留文件

以下步骤针对压缩包分发形式。若下载的是安装程序，应先完成安装，不要将安装程序当作压缩包操作。普通系统代理使用不需要先打开 TUN，也不应把“始终以管理员身份运行”作为所有启动故障的通用处理办法。

1. 完整解压

   右键压缩包→「全部解压缩」，放到当前账户有写入权限的固定目录，例如 D:\Tools\v2rayN。不要在压缩软件的预览窗口中双击主程序；临时解压可能让配置与内核不在同一目录。

2. 运行主程序

   打开解压后的目录，运行 v2rayN.exe。保留同目录的依赖文件和子目录；需要桌面入口时创建快捷方式，而不是移动这个可执行文件。

3. 检查运行库

   若出现要求安装 .NET Desktop Runtime 的对话框，按提示确认所需运行库版本与架构。不同发行包是否自带运行时并不一致，不要看到 .NET 字样就随意安装另一套架构。

4. 导入订阅

   主界面「订阅分组」→「订阅分组设置」中添加分组并填写地址，保存后在「订阅分组」菜单执行更新。界面版本可能使用“添加”或“+”按钮；目标都是订阅分组的地址字段，而非单节点编辑框。

5. 选中服务器

   更新后在服务器列表选择一项，通过右键菜单「设为活动服务器」启用。随后检查主界面的日志区域，确认没有“启动进程失败”“文件不存在”或端口绑定错误，再设置系统代理。

三、macOS 权限放行：区分应用拦截与内核执行失败

应用首次打开时的系统提示，与代理核心启动失败是两件事。前者发生在应用入口，后者通常要在应用日志里看具体文件。应用窗口已经出现，但连接按钮没有效果时，应继续查看日志，而不是反复把整个应用移出再拖回「应用程序」。

1. 先完成复制：将应用放入「应用程序」，推出下载映像，再从访达打开应用。若使用压缩包分发形式，应先解压到稳定位置，不在下载预览中运行。
2. 处理首次拦截：确认下载来源后，在访达中按住 Control 点按应用→「打开」。若系统仍阻止，在「系统设置」→「隐私与安全性」中查看对应提示；仅在确认是本次应用时使用「仍要打开」。不同系统版本的按钮呈现可能不同。
3. 读取内核错误：日志中的 permission denied 指向执行权限或访问权限；bad CPU type in executable 指向架构不匹配。二者不应使用同一种修复方法。
4. 按需要授权：系统代理变更若触发授权提示，核对应用名称后再操作。首次普通代理测试不需要为了排错而授予完全磁盘访问权限。

不要照抄递归删除整个目录安全属性的终端命令，也不要将“应用已损坏”一律理解为需要绕过系统限制。先重新获取对应架构的发行包，再检查系统提示；企业管理设备还可能受组织策略限制，需由管理员确认。

四、内核文件位置：以日志中的启动路径为准

v2rayN 管理服务器与设置，Xray、V2Fly 等内核负责执行对应配置。协议名称和核心名称不是同一层概念。VLESS 配合 REALITY 需要使用支持该组合的内核，不能因为两种内核都能处理部分代理协议，就认为它们可任意互换。

需要核对内核选择时，打开「设置」→「参数设置」，查看当前界面提供的内核相关选项；部分界面将其标为「Core 类型」，也可能按协议分别设置。不要在没有报错的情况下反复换核心。若日志明确显示找不到内核，优先重新完整安装对应发行包，或使用客户端提供的内核更新入口，而不是把任意下载的可执行文件改名后塞进去。

• 文件不存在：对照日志路径查找文件，检查解压是否遗漏、安全软件是否隔离、更新是否被中断。
• 配置解析失败：阅读具体字段名，核对节点协议与核心支持范围；这不是系统代理开关能修复的错误。
• 缺少数据文件：路由规则若引用 geoip.dat 或 geosite.dat，还需确保相关数据文件存在于核心所用资源位置。

五、系统代理与端口：先验证本机入口

核心正常启动后，在主界面的「系统代理」菜单选择「自动配置系统代理」。系统代理决定遵循系统设置的应用是否把请求交给本地代理；路由规则决定请求进入核心后走代理还是直连。选择“全局”路由不会自动接管所有应用，也不能替代系统代理开关。

在「设置」→「参数设置」中核对本地监听端口；对应字段可能位于基础设置页。下面使用 127.0.0.1:10808 作为排查示例，不代表所有安装的默认值。执行前必须换成界面显示的实际端口，并确认它提供 HTTP 或混合代理入口。

检查是否有程序监听

Windows 在 PowerShell 中执行第一条，macOS 在终端中执行第二条。看到监听记录，只能说明端口被某个进程占用，还需核对进程是否属于本次启动的内核。

# Windows PowerShell
Get-NetTCPConnection -State Listen -LocalPort 10808 |
  Select-Object LocalAddress, LocalPort, OwningProcess

# macOS 终端
lsof -nP -iTCP:10808 -sTCP:LISTEN

• 没有监听记录：回到客户端日志，排查核心未启动、端口设置未保存或配置生成失败。
• 日志出现 address already in use：先退出重复运行的客户端，再检查占用进程。确认来源前不要直接结束陌生系统进程。
• 改了监听端口：重新启动核心，并重新应用系统代理设置，避免系统仍指向旧端口。

显式指定代理测试

下面的请求用于确认 HTTP 代理入口能否接受连接。在 Windows 使用 curl.exe，macOS 使用 curl。目标地址仅作连通性示例；若路由把该地址设为直连，成功响应仍不能证明远端代理节点可用。

# Windows
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com/

# macOS
curl --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com/

六、首次安装常见问答与退出恢复

完成首次设置后，保留三项记录即可：程序实际所在目录、当前启用的核心、本地监听地址与端口。下一次故障从这三项和日志开始检查，一次只改一个设置。升级前备份客户端提供的配置数据；不要把包含订阅凭据的完整配置直接发到公开讨论区。