Qv2ray 使用教程:Windows/macOS/Linux 全平台配置指南
Qv2ray 是一款开源、跨平台的代理客户端软件,支持 Windows、macOS 和 Linux 操作系统。它提供了一个用户友好的图形界面,用于管理和连接各种代理协议,包括 V2Ray、Shadowsocks 等,旨在增强用户的在线隐私和安全性。
本教程将详细介绍如何在 Windows、macOS 和 Linux 上安装和配置 Qv2ray。
1. 核心概念与准备
Qv2ray 本身不包含 V2Ray 核心程序。因此,您需要单独下载 V2Ray 核心,并将其配置到 Qv2ray 中。
准备工作
- 下载 Qv2ray 客户端: 访问 Qv2ray 的 GitHub 发布页面或官方网站,下载对应您操作系统的最新版本。
- 下载 V2Ray 核心: 访问 V2Fly V2Ray 核心的 GitHub 发布页面 (
v2fly/v2ray-core),下载与您操作系统匹配的最新 V2Ray 核心压缩包 (例如v2ray-windows-64.zip,v2ray-macos-64.zip,v2ray-linux-64.zip)。
2. Qv2ray 客户端安装
Windows
- 下载: 从 Qv2ray 发布页面下载 Windows 版本的压缩包。
- 解压: 将下载的压缩包解压到一个您希望安装的文件夹(例如
C:\Program Files\Qv2ray)。 - 运行: 进入解压后的文件夹,找到
qv2ray.exe文件并运行。
macOS
- 下载: 从 Qv2ray 发布页面下载 macOS 版本的
.dmg或压缩包。 - 安装:
- 如果下载的是
.dmg文件,双击打开,然后将 Qv2ray 应用程序拖放到“应用程序”文件夹中。 - 如果下载的是压缩包,解压后将 Qv2ray 应用程序拖放到“应用程序”文件夹中。
- 如果下载的是
- 运行: 在“应用程序”文件夹中找到 Qv2ray 并运行。
Linux
对于 Linux 用户,推荐使用 AppImage 方式安装,因为它兼容大多数发行版。
- 下载 AppImage: 从 Qv2ray 发布页面下载最新版本的
.AppImage文件。 - 添加执行权限: 打开终端,导航到下载文件所在的目录,然后运行以下命令赋予执行权限:
bash
chmod +x Qv2ray-*.AppImage -
运行:
- 双击 AppImage 文件即可运行。
- 或者在终端中运行:
./Qv2ray-*.AppImage
-
Snap (不推荐): 尽管 Qv2ray 可能通过 Snap 提供,但有时可能会遇到 V2Ray 核心权限问题。如果遇到此类问题,建议卸载 Snap 版本并使用 AppImage。
3. 配置 V2Ray 核心
这是 Qv2ray 正常工作的关键一步。
- 解压 V2Ray 核心: 将您之前下载的 V2Ray 核心压缩包解压到一个固定路径。建议解压到一个容易找到的目录,例如在 Qv2ray 配置文件目录下创建一个
vcore文件夹,或直接在 Qv2ray 客户端的同级目录中。- 确保
v2ray(或v2ray.exe)、v2ctl(或v2ctl.exe)、geoip.dat和geosite.dat文件直接位于此解压目录中。
- 确保
- 打开 Qv2ray 设置: 启动 Qv2ray,点击菜单栏的
首选项(或Preferences) ->内核设置(或Kernel Settings)。 - 配置核心路径:
- V2Ray 核心可执行文件路径 (Core Executable Path): 浏览并选择您解压后的 V2Ray 核心目录中的
v2ray(Windows 为v2ray.exe) 可执行文件。 - V2Ray 资源文件目录 (V2Ray Assets Directory): 浏览并选择包含
geoip.dat和geosite.dat文件的目录 (即您解压 V2Ray 核心的目录)。
- V2Ray 核心可执行文件路径 (Core Executable Path): 浏览并选择您解压后的 V2Ray 核心目录中的
- 验证配置: 点击
检查 V2Ray 核心设置(Check V2Ray Core Settings) 按钮,确保所有路径都已正确配置,并且 Qv2ray 能够识别 V2Ray 核心。
Linux/macOS 权限提示
对于 Linux 和 macOS,请确保 v2ray 和 v2ctl 这两个文件具有执行权限。如果没有,请使用终端命令 chmod +x 赋予它们执行权限,例如:
bash
chmod +x /path/to/your/vcore/v2ray
chmod +x /path/to/your/vcore/v2ctl
4. 导入服务器配置
Qv2ray 需要服务器(节点)配置才能连接代理服务。
方式一:从分享链接导入
- 在 Qv2ray 主界面,点击左侧导航栏的
导入(Import) 选项。 - 粘贴您的 V2Ray 或 Shadowsocks 等代理服务的分享链接(通常以
vmess://,ss://等开头)。 - 点击
导入,Qv2ray 将自动解析并添加服务器节点。
方式二:订阅服务器
如果您有订阅链接,可以批量导入和更新节点。
- 在 Qv2ray 主界面,点击左侧导航栏的
订阅(Subscriptions) 按钮。 - 点击
添加(Add) 按钮,输入订阅名称,并在订阅地址(Subscription Address) 字段中粘贴您的订阅链接。 - 您可以设置
更新间隔(Update Interval) 以便 Qv2ray 自动更新节点列表。 - 点击
更新订阅(Update subscription) 来加载节点配置。 - 订阅成功后,这些节点将显示在主界面的节点列表中。
连接服务器
双击主界面节点列表中您想要连接的服务器节点,即可启用代理。
5. 配置应用程序使用 Qv2ray
方式一:设置系统代理
Qv2ray 支持在 Windows、macOS 和 Linux (GNOME/KDE 桌面环境) 上自动设置系统代理。
- 通过托盘图标: 右键点击系统托盘区的 Qv2ray 图标,选择
系统代理(System Proxy) ->启用/禁用系统代理(Enable/Disable System Proxy)。 -
通过 Qv2ray 设置: 打开 Qv2ray 的
首选项->入站设置(Inbound Settings),勾选设置系统代理(Set System Proxy) 选项,然后点击确定。 -
Windows UWP 应用提示: 对于部分 Windows UWP 应用可能无法通过系统代理连接。您可以在管理员权限的命令提示符中运行以下命令来解决:
cmd
FOR /F "tokens=11 delims=\" %p IN ('REG QUERY "HKCU\Software\Classes\Local Settings\Software\Microsoft\Windows\CurrentVersion\AppContainer\Mappings"') DO CheckNetIsolation.exe LoopbackExempt -a -n=%p
方式二:手动配置应用程序代理
对于不遵循系统代理设置的应用程序,或者需要更精细控制的情况,您需要手动配置它们的代理。
Qv2ray 默认通常会在本地监听一个端口 (例如 1080 或 8889) 作为 SOCKS5 或 HTTP 代理。您可以在 首选项 -> 入站设置 中查看或修改这些端口。
-
Web 浏览器 (以 Firefox 为例):
- 打开 Firefox,进入
设置->通用->网络设置(Network Settings)。 - 点击
设置(Settings) 按钮,选择手动代理配置(Manual Proxy Configuration)。 - 根据 Qv2ray 的
入站设置,填写SOCKS 主机(SOCKS Host) 为127.0.0.1,端口为 Qv2ray 提供的 SOCKS 端口 (例如1080)。 - 勾选
为所有协议使用此代理服务器或单独设置 HTTP/HTTPS 代理。
- 打开 Firefox,进入
-
Telegram:
- 打开 Telegram,进入
设置(Settings) ->高级(Advanced) ->网络与代理(Network and proxy)。 - 点击
连接类型(Connection type),然后选择添加代理(Add Proxy)。 - 选择
SOCKS5或HTTP代理,并根据 Qv2ray 的入站设置填写服务器(127.0.0.1) 和端口。
- 打开 Telegram,进入
-
Linux 终端:
如果您需要在终端中使用代理(例如wget或curl命令),可以设置环境变量:
bash
export http_proxy=http://127.0.0.1:8889
export https_proxy=http://127.0.0.1:8889
export all_proxy=socks5://127.0.0.1:1080
请根据 Qv2ray 的实际监听端口调整8889和1080。
结语
通过以上步骤,您应该能够在 Windows、macOS 或 Linux 系统上成功安装、配置 Qv2ray 并开始使用代理服务。请记住,网络环境复杂多变,遇到问题时,查阅 Qv2ray 的官方文档或社区论坛通常能找到解决方案。