Download & Install
V2Ray is available on the following platforms:
- Windows 7 and later (x86 / amd64)
- Mac OS X 10.10 Yosemite and later (amd64)
- Linux 2.6.23 and later (x86 / amd64 / arm / arm64 / mips64 / mips)
- Including but not limited to Debian 7 / 8, Ubuntu 12.04 / 14.04 and later, CentOS 6 / 7, Arch Linux
- FreeBSD (x86 / amd64)
- OpenBSD (x86 / amd64)
- Dragonfly BSD (amd64)
Pre-built packages can be found here:
- Github Release: github.com/v2ray/v2ray-core
- Redistribution: github.com/v2ray/dist
- Homebrew: github.com/v2ray/homebrew-v2ray
- Arch Linux: packages/community/x86_64/v2ray/
- Snapcraft: snapcraft.io/v2ray-core
All packages are in ZIP format. Download and unzip corresponding packages to your system.
There are 2 ways to verify packages.
.zipfile has a corresponding
.dgstfile for SHA digests.
- The GPG signature file for executables (v2ray / v2ray.exe) can be found in v2ray.sig (or v2ray.exe.sig) in the same package. Public key is in the repository.
Install on Windows or Mac OS
Run v2ray / v2ray.exe after unzip the packages.
Install on Linux
We provide a script to install on Linux. This script detects previous installed v2ray and then upgrade or install a new one accordingly. If there is a previous version, the config file in /etc/v2ray will not be overwritten during upgrade.
The following command assumes root permission.
Run the following command to install V2Ray. If yum or apt is available, the script will install unzip and daemon / systemd. They are required to run V2Ray as a service. You need to install them manually if your Linux system doesn't support yum or apt.
curl -Ls https://install.direct/go.sh | sudo bash
The script installs the following files.
/usr/bin/v2ray/v2ray: V2Ray executable
/etc/v2ray/config.json: Config file
/usr/bin/v2ray/geoip.dat: IP data file
/usr/bin/v2ray/geosite.dat: domain data file
This script also configures V2Ray to run as service, if systemd is available.
Configurations are at the following places.
After installation, we will need to:
/etc/v2ray/config.jsonfile for your own scenario.
service v2ray startcommand to start V2Ray.
- Optionally run
service v2ray start|stop|status|reload|restart|force-reloadto control V2Ray service.
go.sh supports the following parameters.
--proxy: Use a proxy to download V2Ray packages. Same as curl format, such as
--force: Force installation. The script will assume V2Ray was not installed at all.
--version: The version to be installed, such as
"v1.13". Default value is the latest stable release.
--local: Use a local package for installation.
- Use SOCKS proxy 127.0.0.1:1080 to install the latest package:
./go.sh -p socks5://127.0.0.1:1080
- Install v1.13 from local file:
./go.sh --version v1.13 --local /path/to/v2ray.zip
V2Ray provides 2 docker images:
- v2ray/official: Contains official releases.
- v2ray/dev: Contains latest code.
The 2 images has the same structure as the Linux installation.