# 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.
# apt install gnupg ca-certificates curl
Follow the steps at our debian repo (opens new window)
# apt update; sudo apt install qv2ray
# Linux: Arch Linux-based distros
Install directly from
We have made ourselves into
archlinuxcn repository. If you are already using it, simply type in your terminal:
sudo pacman -Syy qv2ray # or qv2ray-dev-git, see below.
And that shall be done.
Attention to Manjaro Hitchhikers on Arch Linux CN
Manjaro will delay Arch Linux's package changes. When there is a breaking ABI change in upstream, Arch Linux CN will prioritize Arch users instead of those of Manjaro. Manjaro users of Arch Linux CN should always be aware of and bear all consequences caused by the delayed update of its official source, including issues like
symbol lookup error and etc. If you insist on using it, please do not submit it to either Qv2ray or Arch Linux CN as a bug in any way. For those who don't want trouble, please use other versions instead.
This nag will be removed whenever something like "Manjaro CN" is founded and officially takes the workload of packaging Qv2ray for its users.
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: openSUSE / Fedora / CentOS
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).
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
upgrade in the commands.
If you want to install plugins and Qv2ary beta, please add the
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:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser # Allow script execution iwr -useb get.scoop.sh | iex
scoop bucket add extras
scoop install qv2ray
To update, just replace
updatein the commands:
scoop update qv2ray
(Optional) If you want to install plugins and Qv2ray beta, add
scoop bucket add sushi https://github.com/kidonng/sushi # For all apps see https://github.com/kidonng/sushi#qv2ray scoop install qv2ray-beta
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:
- 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'))
- 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)
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.
- Set up Flatpak environment according to the official documentation (opens new window).
- 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:
- Navigate to Qv2ray GitHub Release Page (opens new window) in a web browser.
- Choose a version from the releases. Or, optionally, you may use the Latest Stable Release (opens new window).
- Choose in Assets according to your platform and download it! For example:
- For Windows Users:
- Windows 7/8/8.1/10:
- Windows 2003/XP/2000/ME/98/...: Are you kidding me bro?
- Windows 7/8/8.1/10:
- For Linux 64bit Users:
- For macOS Users:
- macOS 10.14 and later:
- macOS 10.13:
- macOS 10.12 and before: Try Upgrading Your macOS.
- macOS 10.14 and later:
- For Windows Users:
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:
- Open Qv2ray GitHub Actions Page (opens new window) in your web browser.
- 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).
- Click on Artifacts drop-down menu to expand it, and then choose binaries according to your platform.
TODO: Branch Selection Tips
You must login GitHub first to access GitHub Actions.
# Building From Source
Please refer to Manually Build Qv2ray Page.