Qv2ray

# Step 1: Obtaining Qv2ray

To get started with Qv2ray, you should first obtain it (Why not?).

  • We offer many distribution methods, you can choose according to your preference.

# From a Package Manager

# Linux: Debian, Ubuntu and their derivatives

# Install the relevant tools

sudo apt install gnupg ca-certificates curl

# Debian with Qv2ray stable release

Add Qv2ray public keys to your system:

Import our GPG key. Notice the hyphen at the end of line.

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

You can also import GPG public keys by using FastGit:

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

Add the our official APT repository:

Debian stable version:

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

If you are using Debian unstable version, you should use this command instead:

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

Update the APT index:

sudo apt update

You can install Qv2ray from APT now:

sudo apt install qv2ray
# FastGit Mirror (in case GitHub is blocked in China)

Add the our official APT repository:

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

If you are using unstable version Debian, you should use this command instead:

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

Update the APT index:

sudo apt update

You can install Qv2ray from APT now:

sudo apt install qv2ray

# Ubuntu with Qv2ray stable release

Notice： All of commands should run on bash, if you are using other shells such as zsh, fish, run bash command at first.

Add Qv2ray public keys to your system:

Import our GPG key. Notice the hyphen at the end of line:

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

You can also import GPG public keys by using FastGit:

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

Add the our official APT repository:

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

Update the APT index:

sudo apt update

You can install Qv2ray from APT now:

sudo apt install qv2ray
# FastGit Mirror (in case GitHub is blocked in China)

Add the our official APT repository:

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

Update the APT index:

sudo apt update

You can install Qv2ray from APT now:

sudo apt install qv2ray

Notice: For development version of Qv2ray, you should read https://qv2ray.org/debian-dev (opens new window), and qv2ray-dev has arm64 and mips64el version for Debian. If you wanna use you should change [arch=amd64] to your architecture, such as [arch=arm64].

# Linux: Arch Linux and distros using Arch Linux's repo directly

Install directly from archlinuxcn

We have made ourselves into archlinuxcn repository. If you are already using it, simply type in your terminal:

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

sudo pacman -Syy qv2ray # or qv2ray-dev-git, see below.

And that shall be done.

Download from AUR, using an AUR Helper

You may acquire officially maintained PKGBUILD file from AUR (Arch User Repository, AUR (en) - Home (opens new window)), which will instruct the build process of Qv2ray.

All Qv2ray plugins are currently in AUR.

# Linux: Manjaro

Install directly from manjarocn

Manjaro CN Repo: https://github.com/manjarocn/repo (opens new window)

sudo pacman -Syy qv2ray # or qv2ray-dev-git, see below.

# Linux: openSUSE / Fedora / CentOS

Qv2ray is made available for openSUSE / Fedora / CentOS users from openSUSE Build Service (opens new window) by @zzndb (opens new window).

Applicable Versions

Because of the limit of Qt version, we may not be able to support all on-lifetime distro above, the detail of supported distro please check the OBS link below.

Similar to AUR, there are two versions of Qv2ray available. You can choose according to your own flavor:

Or you can get more detailed installation guide directly from the links below:

For CentOS user

Before you install Qv2ray from above OBS project, you need to add the EPEL repository which provided by Fedora for extra needed dependencies. For more info please check the Fedora EPEL Wiki (opens new window).

Plugins

The above OBS project (opens new window) also provide the plugins of Qv2ray family. After installing Qv2ray through project's repository (not download & install by hand), you can directly install plugins (with the same name of the plugin's project name, also provide the preview version plugin with -preview postfix) using your package manager.

# Linux / macOS: Homebrew

You can use Homebrew to install Qv2ray on macOS (and Linux, maybe). If you haven't installed Homebrew yet, you can check the Homebrew website for more details about how to install it. Once Homebrew is installed, you can install Qv2ray using the following command:

$ brew cask install qv2ray

Or with the new command

$ brew install --cask qv2ray

Upgrading is also easy, just replace install with upgrade in the commands.

If you want to install plugins and Qv2ary beta, please add the 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) is a command-line-based software packages manager for Windows.

Run the following commands in PowerShell:

  1. Install Scoop (opens new window):

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

  2. Add extras bucket:

    scoop bucket add extras

  3. Install Qv2ray:

    scoop install qv2ray

  4. To update, just replace install with update in the commands:

    scoop update qv2ray

  5. (Optional) If you want to install plugins and Qv2ray beta, add sushi bucket:

    scoop bucket add sushi https://github.com/kidonng/sushi
# For all apps see https://github.com/kidonng/sushi#qv2ray
scoop install qv2ray-beta

TIP

You may also need to install the latest Visual C++ Redistributable (opens new window).

# Windows: Chocolatey

Chocolatey (opens new window) is another software packages manager for Windows.

Please open Powershell with administrator permission and run the following commands:

  1. Install 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. Install Qv2ray：
    choco install qv2ray

# From AppStore

# Linux: Snapcraft

Follow the instructions on our Snapcraft page (opens new window).

# To install the package:
$ sudo snap install qv2ray
# sudo snap install qv2ray --edge (dev branch)
# To update the package:
$ sudo snap refresh qv2ray

# Linux: Flathub (Deprecated)

Deprecated (2020/09/18)

Installation of Qv2ray from Flathub is officially deprecated, since the maintainer is no longer actively maintaining the package. If you are interested in adopting this, please open an issue and let us know.

  1. Set up Flatpak environment according to the official documentation (opens new window).
  2. Install Qv2ray:
    # To install the package:
$ flatpak install com.github.Qv2ray
# To update the package:
$ flatpak update

# GitHub Releases Binary

Downloading the release from Qv2ray Release Page (opens new window) is favored for someone who does not want to use Package Managers.

This is also suitable for Linux users where Qv2ray is not officially packaged in their distros.

Do as the follows:

  1. Navigate to Qv2ray GitHub Release Page (opens new window) in a web browser.
  2. Choose a version from the releases. Or, optionally, you may use the Latest Stable Release (opens new window).
  3. Choose in Assets according to your platform and download it! For example:
    • For Windows Users:
      • Windows 7/8/8.1/10 x64: Qv2ray.VERSION.Windows-x64.7z (Archive) or Qv2ray.VERSION.win64.exe (Installer).
      • Windows 7/8/8.1/10 x86: You may try to build Qv2ray yourself.
      • Windows Vista/2003/XP/2000/ME/98/...: Are you kidding me bro?
    • For Linux x64 Users: Qv2ray.VERSION.linux-x64.AppImage.
    • For macOS Users:
      • macOS 10.14 and later: Qv2ray.VERSION.macOS-x64.dmg;
      • macOS 10.13: qv2ray-legacy.dmg (if any);
      • macOS 10.12 and before: Try Upgrading Your macOS or installing Linux on your Apple device(s).

Notes for Linux AppImage users

Although we have bundled glibc and some basic C++ libraries into the AppImage package to support some old but supported distros, moving yourself to a newer version of Distro/OS is strongly recommended.

Notes for Windows ARM64 users

Windows 10 on ARM added an emulation layer for x86_64 apps in build 21277, users can use the x64 version with the latest Windows Insider Preview.

# GitHub Actions

If you are fed up with the functionalities of stable versions and willing to try out new features in development, you may download artifacts from GitHub Actions:

  1. Open Qv2ray GitHub Actions Page (opens new window) in your web browser.
  2. Choose a recent and successful (displayed as ✔️) build and click on it. You should be taken to the detail page of that GitHub Build. Here's an example (opens new window).
  3. Click on Artifacts drop-down menu to expand it, and then choose binaries according to your platform.

TODO: Branch Selection Tips

TIP

You must login GitHub first to access GitHub Actions.

# Building From Source

Please refer to Manually Build Qv2ray Page.

⟵ Configuring V2Ray Core ⟶