Installation
Supported OS Platforms
The following platforms are supported by V2Ray:
- Windows 7 and later(x86 / amd64 / arm32)
- macOS 10.10 Yosemite and later(amd64)
- Linux 2.6.23 and later(x86 / amd64 / arm / arm64 / mips64 / mips / ppc64 / s390x / riscv64)
- including but not limited to Debian 7 / 8, Ubuntu 12.04 / 14.04 and later, CentOS 6 / 7 and Arch Linux
- FreeBSD (x86 / amd64)
- OpenBSD (x86 / amd64)
- Dragonfly BSD (amd64)
Download V2Ray
Compiled binary packages can be found via the following links.
- Github Release: github.com/v2fly/v2ray-core
- Arch Linux: packages/community/x86_64/v2ray/
All packages are in the .zip format. Look for the file matching your platform and unzip it to get started.
Package Integrity
The integrity of V2Ray can be validated in two ways:
- The SHA1 / SHA256 digest information can be found in the corresponding
.dgst
files. - Run
v2ctl verify --sig=Release example-file
Windows Installation
- Download and unpack the zip file, you will get an executable
v2ray.exe
. - Install via Scoop package manager:
scoop install v2ray
- Install via Chocolatey package manager:
choco install v2ray
Then run V2Ray in command line.
macOS Installation
- Download and unpack the zip file, you will get an executable
v2ray
. - Install via Homebrew package manager:
brew install v2ray
w- You can continue using
v2ray/v2ray
Tap, however this is not recommended.
- You can continue using
Then run V2Ray in command line.
Linux Distro Repository
Some distros may have included V2Ray to their repositories. It is recommended to use these repositories for better compatibility before using any installation script.
- Debian: golang-v2ray-core.
Installing on Linux by Script
The original installation script is deprecated and replaced by fhs-install-v2ray.
Go to #2328 for related discussions.
What's new?
- Changed Installation Path V2Ray to comply with FHS.
- Stopped supporting stone age platforms, such as CentOS 6.
- Stopped supporting System V.
- Changed the service user from root to nobody.
FAQ (In Chinese)
- Install without updating geoip.dat and geosite.dat
- Insufficient permissions when using certificates
- Migrate from the old installation script
- Move .dat files from
lib
toshare
directory - Use the VLESS Protocol
Docker
The V2Ray Docker Image is also available:
- v2fly/v2fly-core: The
latest
tag will be updated following v2fly's latest release. Other versions will be released using the version's tag, e.g.4.27.0
.
The Structure of Docker Image:
/etc/v2ray/config.json
: Config File/usr/bin/v2ray/v2ray
: V2Ray Main Process/usr/bin/v2ray/v2ctl
: V2Ctl Commandline Tools/usr/bin/v2ray/geoip.dat
: GeoIP Data/usr/bin/v2ray/geosite.dat
: GeoSite Data