Qv2ray macOS 安装配置超详细教程 (含插件与核心)

作者：

neutemu

在

Qv2ray 是一款非常出色的跨平台代理客户端，它能够支持多种流行的代理协议，并在各大主流操作系统上均有不俗表现。特别值得一提的是，在 macOS 平台上，Qv2ray 不仅运行流畅，还对 Xray 核心提供了良好支持，因此深受广大 Xray用户的喜爱。 尽管由于种种原因，Qv2ray 项目目前已停止更新，但在出现更佳的替代方案之前，它仍是 Mac 用户使用 Xray 协议的重要选择之一。

Qv2ray 支持 Shadowsocks、ShadowsocksR、Trojan、Trojan-Go、VMess、NaiveProxy 等多种代理协议。它不仅全面兼容 Windows、macOS 和 Linux 三大桌面平台，还能直观显示实时网速、延迟以及已用流量等信息。要体验其完整功能，通常需要根据需求下载并安装相应的插件。

对于 macOS 用户而言，通过 Qv2ray 配置和使用代理服务的流程相当直观。下面，我们将为您详细拆解为三大步骤：

第一步：下载 Qv2ray 软件及核心资源

Qv2ray 当前最新的官方发行版本为 v2.7.0。您可以从项目的 GitHub 发布页面获取。Mac 用户在下载时，请务必选择适用于 macOS 的 .dmg 安装包文件。

Qv2ray 官方下载地址：https://github.com/Qv2ray/Qv2ray/releases
如果您无法直接访问 GitHub，可以使用以下备用链接：
百度网盘备份：https://pan.baidu.com/s/1z0fkhMY3FH716w_3uRRiWQ?pwd=3g97 (提取码: 3g97)

Qv2ray GitHub 发布页面截图

Qv2ray GitHub 发布页面

第二步：安装 Qv2ray

下载完成后，双击您下载的 .dmg 文件。此时，系统会弹出一个窗口，提示您将 Qv2ray 图标拖动到“应用程序”(Applications) 文件夹中，以此完成安装过程。

macOS 安装 Qv2ray 拖拽示意图

将 Qv2ray 拖入应用程序文件夹

安装完毕后，您可以在“应用程序”文件夹中找到 Qv2ray 应用图标，双击即可运行。

第三步：首次启动与环境配置

语言设置

如果 Qv2ray 首次启动时默认界面语言是英文，您可以点击主界面上的 “Preference” (偏好设置) 按钮进入设置菜单。

Qv2ray 偏好设置入口

Qv2ray 主界面与“Preference”按钮

在设置窗口中，找到 “Language” (语言) 选项，并将其设置为 “zh_CN”，即可将软件界面切换为中文，方便后续操作。

安装 Qv2ray 插件 (按需)

Qv2ray 的插件系统 (QvPlugin) 默认仅内置了对 V2ray 和 Shadowsocks (SS) 协议的支持。如果您需要使用 ShadowsocksR (SSR) 或 Trojan 等其他协议，则需要额外安装相应的插件。

  • Trojan 协议支持：下载 QvPlugin-Trojan 插件。
  • SSR 协议支持：下载 QvPlugin-SSR 插件 (v3.0.0)。
  • 若需使用 V2ray 协议 (VMess 等)，除了 Qv2ray 本体外，还需额外准备 V2ray 核心文件。

建议： 为应对不同场景，您可以考虑将常用协议的插件和核心文件一并下载备用。

插件包备用下载 (含常用插件)：https://pan.baidu.com/s/1BD8opMmajwZSsFRB6CTtRg?pwd=sr1e (提取码: sr1e)
V2ray 核心文件备用下载：https://pan.baidu.com/s/1VunU7Alxc7YdXDFx8byPJQ?pwd=f4sq (提取码: f4sq)

插件安装步骤：

  1. 点击 Qv2ray 软件主界面顶部的“插件”按钮。 Qv2ray 插件管理入口
  2. 在弹出的插件管理窗口中，点击“打开本地插件目录”按钮。系统会自动打开存放插件文件的文件夹。 Qv2ray 打开本地插件目录示意图
  3. 将您下载好并解压（如果需要）的插件文件 (通常是 .qvplugin 后缀) 完整地拷贝到这个打开的插件目录中。
  4. 关闭并重新启动 Qv2ray 客户端，使新安装的插件生效。

配置 V2ray 核心文件 (若使用 V2ray 相关协议)

如果您计划使用 VMess 等基于 V2ray 核心的协议，请先解压您下载好的 V2ray 核心文件压缩包，并将其中的所有文件（特别是 v2ray 或 xray 可执行文件以及 geoip.dat, geosite.dat 等资源文件）保存在一个易于查找的位置，例如您的“用户目录/文稿/Qv2ray_Core” (可自定义)。

然后，在 Qv2ray 的“偏好设置 (Preference)”中，切换到“内核设置”选项卡，准确设置以下两个路径：

  • V2ray 核心可执行文件路径 (V2ray Core Executable Path)： 指向您解压目录中 v2ray (或 xray) 程序文件。
  • V2ray 资源目录 (V2ray Assets Directory)： 指向包含 geoip.dat、geosite.dat 等资源文件的文件夹路径 (通常是核心文件解压后的整个文件夹)。
Qv2ray 内核设置路径配置

正确设置核心可执行文件路径

Qv2ray 内核资源目录配置

正确设置 V2ray 资源目录

检查核心配置：

在内核设置界面，点击“检查 V2ray 核心设置”按钮。如果一切配置无误，系统会提示检查通过。

Qv2ray 内核检查通过提示

核心检查通过

第四步：导入节点与连接

  1. 导入单个节点链接： 点击主界面上方的“导入”按钮，将您获取到的 V2ray/SS 等协议的分享链接粘贴进去即可。 Qv2ray 导入分享链接
  2. 导入订阅链接： 在主界面点击“分组”，然后可以“新建分组”并为此分组“编辑订阅设置”。粘贴您的订阅链接，并可以设置自动更新间隔。 Qv2ray 添加订阅链接
  3. 更新订阅获取节点： 配置好订阅后，回到 Qv2ray 主界面，在对应分组上右键点击，选择“更新此订阅的节点”。 Qv2ray 更新订阅节点
  4. 选择并连接节点： 更新成功后，展开分组即可看到所有可用节点。选择您需要的线路节点，右键点击并选择“连接到此服务器”即可开始使用。 Qv2ray 选择并连接节点

第五步：选择代理模式与开始使用

成功连接节点后，Qv2ray 通常会自动为您设置系统代理。您可以通过右键点击 macOS 菜单栏（或系统托盘）中的 Qv2ray 图标来选择不同的“系统代理模式”，常见的有：

  • 绕过大陆 (Bypass Mainland China)： 中国大陆的流量直连，海外流量走代理。
  • 全局代理/禁止绕过 (Global / Disable Bypass)： 所有网络流量均通过代理服务器。
Qv2ray 系统代理模式选择

选择适合您的代理模式

设置完成后，打开您的浏览器，即可开始通过 Qv2ray 代理畅游网络了！

评论

发表回复

更多文章