首次使用 v2rayN 7.x,先按系统和处理器架构选包,再导入配置、激活一个节点并验证本地代理。Windows 与 macOS 的安装和权限入口不同,连接检查顺序相同。确认应用能通过代理访问后,再设置登录自启;出错时按安装、订阅、内核和应用四个环节定位,不必一上来就重装。
选包与首次运行:先核对系统和架构
能打开主窗口,只说明客户端界面已经启动,不代表处理连接的内核也能运行。下载时除系统和架构外,还要看包说明是否包含内核。首次配置可优先选明确标注包含所需内核的发行包,避免导入节点后才发现缺少对应的可执行文件。
Windows 选包
- 查看架构
- 「设置」→「系统」→「关于」→「系统类型」
- 包标记
- 基于 x64 的处理器对应 x64;ARM 设备选与系统匹配的 arm64 包
- 压缩包
- 完整解压到当前账户可写、之后不会移动的目录
- 首次启动
- 压缩包从解压目录运行
v2rayN.exe;安装包按提示安装
不要在压缩软件的预览窗口里直接双击主程序,否则相邻的内核文件可能没有一同解压。
macOS 选包
- 查看架构
- 苹果菜单 →「关于本机」,查看「芯片」或「处理器」
- 包标记
- Apple 芯片选 arm64;Intel 处理器选 x64
- 应用位置
- 按包说明解包或打开磁盘映像,将应用放入「应用程序」
- 首次启动
- 从「应用程序」打开,不把磁盘映像当作长期运行位置
安装后先手动打开一次。这样登录项需要引用应用时,路径不会指向临时挂载位置。
- Windows 提示缺少运行时:先看报错列出的运行时名称和主版本,再对照发行包说明。若使用的是依赖系统运行时的包,按提示补齐对应架构的 .NET 桌面运行时;管理员权限不能代替运行时。
- macOS 提示无法验证开发者:先确认包来源和架构。若是开发者验证提示,且确认信任该应用,可在一次启动尝试后到「系统设置」→「隐私与安全性」查看是否提供「仍要打开」。若系统报告应用会损坏电脑,不要继续运行,也不要关闭系统的全局安全防护。
订阅导入:保存、更新、激活是三步
订阅地址用于拉取一组节点,保存地址不会立刻生成可用连接。以 v2rayN 7.x 中文界面为例,下文按菜单功能给出路径;小版本的菜单措辞可能略有差异。若拿到的是以 vmess:// 或 vless:// 开头的单节点分享链接,应使用剪贴板导入服务器的功能,而不是填入订阅地址一栏。
创建订阅分组
打开「订阅分组」→「订阅分组设置」,添加一条记录。填写便于识别的别名和完整订阅地址,保存后返回主界面。地址可能带访问令牌,不要贴到公开截图或日志里。
更新订阅列表
选中新建分组,从「订阅分组」菜单执行「更新当前订阅(不通过代理)」。初次安装还没有可用节点,不要先选通过代理更新。更新结束后确认节点出现在该分组,而不是只看分组名称是否创建成功。
设为活动节点
在列表中选中一个确认可用的节点,右键执行「设为活动服务器」。只单击一行是选中它,不等于已切换连接。切换后查看主界面的活动项及日志,确认内核没有立即退出。
验证应用连接
先验证本地代理端口,再从托盘或菜单栏图标的「系统代理」菜单选择「自动配置系统代理」。关闭浏览器内会覆盖系统设置的独立代理规则,打开一个已知可访问的 HTTPS 页面,检查浏览器是否能正常加载。
内核选择:先验证现有配置,再改内核映射
节点保存的是协议、远端地址和传输等连接参数,内核负责执行这些参数。进入「设置」→「参数设置」→「Core 类型」(部分版本标为「Core 类型设置」),可查看内置节点协议对应的内核选项。这个设置不是用来把 VMess 节点改成 VLESS 的;带完整配置的自定义节点也不宜套用这里的通用判断。
保留节点当前的内核
推荐先保留客户端当前的协议映射,激活节点后看日志。若服务端给的是 VLESS + REALITY,而且当前使用的 Xray 能正确加载配置,就不要为了调试再同时更换内核、传输方式和安全参数。
适合:首次安装、已有可导入的标准订阅
按服务端要求调整内核
只有在服务端明确给出兼容要求,或日志指出当前内核不识别配置字段时,再选择支持该组合的已安装内核。保存后重新激活同一个节点,比较变更前后的日志;不要同时换服务器,否则无法判断哪项改动有效。
适合:迁移已知配置、排查明确的字段兼容问题
若日志说找不到内核文件,先核对包内容和平台架构。若内核已启动,但连接日志出现 TLS 或认证错误,回查订阅里的地址、服务器名称和认证参数是否来自同一份配置。不要用关闭证书验证来掩盖参数不一致。
本地监听和系统代理:分开验收
在「设置」→「参数设置」中查看本地监听端口。下面以混合入站端口 10808 为例,它支持以 HTTP 代理方式发起这次检查。如果界面显示的是独立 SOCKS 与 HTTP 端口,命令中的端口要换成 HTTP 入站端口。系统代理可以暂时不启用,因为命令会显式连接本机代理。
curl -I --max-time 10 --proxy http://127.0.0.1:10808 https://example.com/
Windows PowerShell 中可将开头的 curl 改为 curl.exe。命令最长等待 10 秒。判断时看目标站点最终返回的 HTTP 状态行,而不是只看代理建立隧道时可能出现的 200 Connection established。这条命令仅用于验证该应用到该目标的路径,不是速度测试。
| 看到的现象 | 下一项检查 |
|---|---|
连接 127.0.0.1:10808 被拒绝 | 确认内核还在运行、端口与入站类型填对,再查日志中是否有监听失败或端口被占用的提示。 |
| 有隧道建立提示,但随后超时或报 TLS 错误 | 本地端口已接收请求。结合内核日志检查当前出站、服务端可达性和 TLS 参数,不要先改浏览器设置。 |
| 命令取得目标站点响应,浏览器却失败 | 检查浏览器是否采用系统代理,是否有扩展或应用内代理覆盖。重开浏览器后用同一地址复测。 |
系统代理把遵循系统设置的应用指向本地监听;路由规则决定已进入内核的连接走代理出站还是直连。命令成功只能说明请求经过了本地入站并得到响应。若还要确认这次请求选中了代理出站,需对照当前路由规则及可用的连接日志,不能仅凭页面打开判断。
登录自启与常见故障
浏览器验收通过后,再配置自启。自启通常发生在用户登录时,不是系统尚未登录时就运行。客户端自动打开和系统代理恢复也是两件事,配置完要分别验证。
- Windows:从「设置」→「参数设置」查看「开机自动启动」选项。设置前固定程序目录;如果之后移动压缩版目录,应重新设置自启,避免登录时仍引用旧路径。
- macOS:可在「系统设置」→「通用」→「登录项」中,将「应用程序」里的 v2rayN 添加到登录时打开列表;部分系统版本把该页面称作「登录项与扩展」。若已配置客户端自启,不要再重复添加同一个应用。
- 退出再登录验收:先确认客户端已打开,再确认活动节点、内核日志和系统代理状态。若决定停止使用,在退出客户端之前先清除系统代理,避免应用继续向已关闭的本地端口发送请求。
订阅分组有名字,怎么还是空的?
选中该分组,手动执行一次「更新当前订阅(不通过代理)」,再看更新日志。如果日志有 HTTP 401 或 403,核对地址是否完整、访问令牌是否仍有效。若是连接超时,先检查本机是否能访问订阅服务;只有已有可用代理时,才适合尝试通过代理更新。
节点测速有数字,为什么网页还是打不开?
测速结果不等于浏览器已经使用该节点。先确认该节点是活动服务器,再用显式指定本地代理的命令验证同一个目标。若命令成功而浏览器失败,优先检查浏览器的代理设置,而不是按延迟排序再换一个节点。
关闭窗口后,代理怎么还在工作?
查看托盘或菜单栏是否还保留 v2rayN 图标。在启用关闭窗口后留驻的情况下,窗口消失不代表客户端退出。需要停止时,先在「系统代理」菜单清除系统代理,再通过客户端菜单执行「退出」。
登录后客户端开了,终端怎么没走代理?
不少命令行程序不继承桌面系统代理。先用该工具的代理参数测试,例如用上文的 curl --proxy 指定本地入站。只有确实需要长期配置时,再按工具文档设置其支持的代理参数或环境变量;不用为了让一条命令走代理就改全局设置。