Qv2ray

# 获取 Qv2ray

要开始使用 Qv2ray，那就得先以某种方式获取到它。

  • 我们提供了许多种方式，您可以根据您的喜好选择。

# 来自软件包管理器

# Linux：Debian、Ubuntu 与它们的衍生版本

# 安装相关工具

sudo apt install gnupg ca-certificates curl

# 为 Debian 安装 Qv2ray 稳定版本

添加 Qv2ray 公钥到你的系统：

导入我们的 GPG 密钥，注意行尾的连字符。

curl https://qv2ray.net/debian/pubkey.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/qv2ray-stable-archive.gpg

您还可以使用 FastGit 导入 GPG 公钥：

curl https://raw.fastgit.org/Qv2ray/debian/master/pubkey.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/qv2ray-stable-archive.gpg
# 主存储库

添加我们的官方 APT 存储库：

Debian 稳定版：

echo "deb [arch=amd64] https://qv2ray.net/debian/ stable main" | sudo tee /etc/apt/sources.list.d/qv2ray.list

如果您使用的是 Debian 不稳定版本，那么您需要改用此命令：

echo "deb [arch=amd64] https://qv2ray.net/debian/ unstable main" | sudo tee /etc/apt/sources.list.d/qv2ray.list

更新 APT 索引：

sudo apt update

您现在可以从 APT 安装 Qv2ray：

sudo apt install qv2ray
# FastGit 镜像（用于加速下载 规避 GitHub 被墙）

添加我们的官方 APT 存储库：

echo "deb [arch=amd64] https://raw.fastgit.org/Qv2ray/debian/master/ stable main" | sudo tee /etc/apt/sources.list.d/qv2ray-fastgit.list

如果您使用的是不稳定版本的 Debian，那么您需要改用此命令：

echo "deb [arch=amd64] https://raw.fastgit.org/Qv2ray/debian/master/ unstable main" | sudo tee /etc/apt/sources.list.d/qv2ray-fastgit.list

更新 APT 索引：

sudo apt update

您现在可以从 APT 安装 Qv2ray：

sudo apt install qv2ray

# 适用于 Ubuntu 的 Qv2ray 稳定版

**注意：**所有的命令都要在bash中运行，如果你使用的是其他 shell，如zsh ， fish ，那么你需要先运行 bash命令。

将 Qv2ray 公钥添加到您的系统：

导入我们的 GPG 密钥，注意行尾的连字符：

curl https://qv2ray.net/debian/pubkey.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/qv2ray-stable-archive.gpg

您还可以使用 FastGit 导入 GPG 公钥：

curl https://raw.fastgit.org/Qv2ray/debian/master/pubkey.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/qv2ray-stable-archive.gpg
# 主存储库

添加我们的官方 APT 存储库：

$ echo "deb [arch=amd64] https://qv2ray.net/debian/ `lsb_releases -cs` main" | sudo tee /etc/apt/sources.list.d/qv2ray.list

更新 APT 索引：

sudo apt update

您现在可以从 APT 安装 Qv2ray：

sudo apt install qv2ray
# FastGit 镜像（用于加速下载 规避 GitHub 被墙）

添加我们的官方 APT 存储库：

$ echo "deb [arch=amd64] https://raw.fastgit.org/Qv2ray/debian/master/ `lsb_release` main" | sudo tee /etc/apt/sources.list.d/qv2ray-fastgit.list

更新 APT 索引：

sudo apt update

您现在可以从 APT 安装 Qv2ray：

sudo apt install qv2ray

注意： 如想要使用 Qv2ray 的开发版本，请阅读https://qv2ray.org/debian-dev (opens new window) ， qv2ray-dev额外提供 Debian 的 arm64 和 mips64el 版本。如果您想使用，您应该将[arch=amd64]更改为您的架构，例如[arch=arm64] 。

# Linux: Arch Linux 或基于 Arch 的发行版

直接从 archlinuxcn 安装

我们已经进入 archlinuxcn 仓库。如果您已在使用它，只需在终端中输入：

（Arch Linux CN 仓库: https://www.archlinuxcn.org/archlinux-cn-repo-and-mirror/ (opens new window)）

sudo pacman -Syy qv2ray # 或 qv2ray-dev-git，见下

然后就完事了。

使用 AUR 助手从 AUR 下载

您可以从 AUR (Arch 用户仓库) 获取官方维护的 PKGBUILD 文件。AUR (en) - Home (opens new window)，它将指导 Qv2ray 的构建过程。

目前所有 Qv2ray 插件都在 AUR。

# Linux: Manjaro

直接从 manjarocn 安装

（Manjaro CN 仓库: https://github.com/manjarocn/repo (opens new window)）

sudo pacman -Syy qv2ray # 或者 qv2ray-dev-git

# Linux: openSUSE / Fedora / CentOS

openSUSE / Fedora / CentOS 上的 Qv2ray 由 @zzndb (opens new window) 于 openSUSE 构建服务 (opens new window)提供。

适用版本

因为 Qt 版本的限制，我们可能无法支持上面所有仍在支持期的发行版，支持的发行版列表请参见下面的 OBS 链接。

类似于 AUR，有两个版本的 Qv2ray 可供使用。您可以根据自己的喜好选择：

或者您可以直接从下面的链接获取更详细的安装指南：

对于 CentOS 用户

在开始从 OBS 安装之前，你需要添加由 Fedora 提供的 EPEL 仓库以获取所需额外依赖，具体请参见 Fedora EPEL Wiki (opens new window)。

插件

以上 OBS 项目 (opens new window) 也提供 Qv2ray 家族的插件。通过项目软件源安装 Qv2ray 之后（不是手动下载 & 安装那种），您可以直接使用包管理器安装插件（插件名字与插件项目名字相同，同时提供带有 -preview 后缀的预览版本插件）。

# Linux / macOS: Homebrew

您可以使用 Homebrew 在 macOS 上安装 Qv2ray (可能 Linux 也行)。如果您还没安装 Homebrew ，可以查看 Homebrew 网站了解更多信息。Homebrew 安装完毕后，您可以使用以下命令安装 Qv2ray

$ brew cask install qv2ray

或者使用新命令

$ brew install --cask qv2ray

更新也很容易，仅需要将 install 替换成 upgrade 即可

如果您想要安装插件和 Qv2ary 的 Beta 版本，请添加 malt Tap：

brew tap kidonng/malt
brew install qv2ray-beta
# Or directly run
brew install kidonng/malt/qv2ray-beta

# Windows: Scoop

Scoop (opens new window) 是一个 Windows 上的基于命令行的软件包管理器。

在 PowerShell 中运行以下命令：

  1. 安装 Scoop (opens new window)：

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser # Allow script execution
iwr -useb get.scoop.sh | iex

  2. 添加 extras bucket：

    scoop bucket add extras

  3. 安装 Qv2ray：

    scoop install qv2ray

  4. 更新也很容易，仅需要将 install 替换成 update 即可

    scoop update qv2ray

  5. (可选的) 如果你想要安装 Qv2Ray 测试版，添加 mochi 仓库：

    scoop bucket add qv2ray https://github.com/qv2ray/mochi
scoop install qv2ray-beta
另请参阅：<https://github.com/kidonng/sushi>

TIP

您可能还需要安装 最新的 Visual C++ 可再发行组件包 (opens new window)。

# Windows: Chocolatey

Chocolatey (opens new window) 是另一个 Windows 的软件包管理器。

请在管理员权限下打开 Powershell 并运行以下命令：

  1. 安装 Chocolatey (opens new window)：
    Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
  2. 安装 Qv2ray:
    choco install qv2ray

# 从 AppStore

# Linux: Snapcraft

按照我们的 Snapcraft 页面 (opens new window) 上的说明操作。

# 要安装软件包：
$ sudo snap install qv2ray
# sudo snap install qv2ray --edge (dev branch)
# 要更新软件包：
$ sudo snap refresh qv2ray

# Linux: Flathub（快被扬了）

已废弃（2020/09/18）

从 Flahub 安装 Qv2ray 是官方 已废弃 的方法，因为维护者不再积极维护该包。如果你有兴趣接手这个包，请告诉我们。

  1. 根据 官方文档 (opens new window) 设置Flatpak环境。
  2. 安装 Qv2ray：
    # 安装：
$ flatpak install com.github.Qv2ray
# 升级：
$ flatpak update

# GitHub Release 二进制文件

从 Qv2ray 发布页面 (opens new window) 下载的版本仅适用于那些***不想使用包管理的用户***。

不过这也适用于部分 Linux 用户，因为 Qv2ray 在他们的发行版中没有正式打包。

跟随下面的指引：

  1. 在浏览器中打开 Qv2ray GitHub Release (opens new window) 页面。
  2. 从 Release 中选择一个版本。或者，您可以选择使用 最新的稳定版发布 (opens new window)。
  3. 根据你的的平台，在 Release Assets 中选择并下载。例如：
    • 对于 Windows 用户：
      • Windows 7/8/8.1/10 x64：Qv2ray.VERSION.Windows-x64.7z（绿色版压缩包）或 Qv2ray.VERSION.win64.exe（安装版安装程序）。
      • Windows 7/8/8.1/10 x86：您可能得自己构建。
      • Windows Vista/2003/XP/2000/ME/98/...：您在开玩笑吗？
    • 对于 64位 Linux 用户：Qv2ray.VERSION.linux-x64.AppImage。
    • 对于 macOS 用户：
      • macOS 10.14 及之后的用户：Qv2ray.VERSION.macOS-x64.dmg；
      • macOS 10.13：qv2ray-legacy.dmg（如果有的话）；
      • macOS 10.12及之前：请升级 macOS。

Linux AppImage 用户的注意事项

虽然我们已将 glibc 和一些基本的 C++ 库打包进 AppImage 来支持一些旧的发行版，但是我们强烈建议您自己升级到最新版本。

给 Windows ARM64 用户的提醒

Windows 10 on ARM 的 building 21277 中已经添加了 x86_64 应用的模拟层，因此用户应该可以使用最新的 Windows 内部预览的 x64 版本。

# GitHub Actions

如果您觉得稳定版本的功能不够看，并愿意尝试开发中的新功能，您可以从 GitHub Actions 下载开发版本：

  1. 在浏览器中打开 Qv2ray GitHub Actions Page (opens new window) 页面。
  2. 选择最近成功的（显示为 ✔️）构建，然后你应该看到 GitHub Build 的详细信息页面。这是一个例子 (opens new window)。
  3. 点击Artifacts下拉菜单来展开它，然后根据您的平台选择二进制文件。

TODO：如何选择分支

TIP

你必须先登录 GitHub 账号才能白嫖 GitHub Actions 中的 Artifacts。

# 从源代码编译

参见 手动构建 Qv2ray 页面。

编辑本页 (opens new window)
上次更新: 2021/8/3 上午11:29:30

⟵ 配置 V2Ray Core ⟶