Download and Install
Platform Support
Official Releases support the following platforms
| Platform | Architectures |
|---|---|
| Windows [1] | x86 / amd64 / arm32 / arm64 |
| macOS | amd64 / arm64 |
| Linux | x86 / amd64 / arm / arm64 / mips64 / mips / ppc64 / s390x / riscv64 |
| FreeBSD | x86 / amd64 |
| OpenBSD | x86 / amd64 |
[1] Windows 7 is no longer officially supported by golang. Xray uses a patched go to provide separately published builds for it; Windows 7 users should use the releases with the -win7 suffix.
Xray actively keeps up with golang versions. For minimum OS version support other than win7, please refer to the latest go release notes corresponding to the time of release.
Builds for amd64 v2/v3 etc. are not provided as some similar projects do, because testing showed no significant performance improvement, and many critical functions already use runtime detection to automatically use extended instruction sets.
Download Xray
Precompiled binary ZIP archives are available in Github Releases.
Download the archive for your platform and extract it to start using Xray.
Verify Installation Packages
Xray provides two verification methods:
- SHA1 / SHA256 digests for ZIP archives
- Reproducible builds: please refer to Compile Xray
Windows Installation
- Download the ZIP archive for Windows from Github Releases. After extracting it, you will get the executable file
xray.exe, which you can then run with command-line arguments
macOS Installation
- Download the ZIP archive for macOS from Github Releases. After extracting it, you will get the executable file
xray, which you can then run with command-line arguments - Install via the Homebrew package manager:
brew install xray - homebrew-xray thanks to @N4FA
Linux Installation
Installation Scripts and Projects
| Type | Project | Description |
|---|---|---|
| Linux Script | XTLS/Xray-install (Official) | Officially maintained Linux installation script |
| Linux Script | tempest | Supports Systemd and OpenRC |
| One Click | Xray-REALITY | One-click installation solution |
| One Click | reality-ezpz | One-click installation solution |
| One Click | Xray_bash_onekey | One-click installation solution |
| One Click | v2ray-agent | One-click installation solution |
| One Click | ProxySU | One-click installation solution |
| Magisk | Xray4Magisk | For Magisk environments |
| Magisk | Xray_For_Magisk | For Magisk environments |
Package Managers and Distribution Repositories
| Method | Project | Description |
|---|---|---|
| Arch User Repository | AUR helpers | Taking yay as an example, install with yay -S xray |
| Arch Linux CN | Arch Linux CN repository | After adding the repository, install with pacman -S xray as root |
| Linuxbrew | Homebrew | Usage is the same as Homebrew: brew install xray |
| Gentoo Portage | Gentoo-zh | Suitable for Systemd systems; install after adding the Overlay with layman or eselect-repository |
Docker Installation
Two different styles of Docker images are currently provided:
ghcr.io/xtls/xray-core (Official)
No root privileges, no shell environment, and support for more architectures. It is compiled and built from the official repository with traceability support. It sacrifices convenience in pursuit of more extreme security.File Structure
/usr/local/bin/xray: Xray main program (owner:root:root, file permissions:755)/usr/local/etc/xray/: Configuration file directory (volume mount point declared byVOLUME) (owner:root:65532, directory permissions:750, file permissions:640)- 00_log.json
- 01_api.json
- 02_dns.json
- 03_routing.json
- 04_policy.json
- 05_inbounds.json
- 06_outbounds.json
- 07_stats.json
- 08_fakedns.json
- 09_metrics.json
- 10_observatory.json
- 11_geodata.json
- 12_env.json
- 99_version.json
/usr/local/share/xray/: Resource file directory containing the full version of GeoIP and the expanded version of GeoSite (owner:65532:65532, directory permissions:755, file permissions:644)- geoip.dat
- geosite.dat
/var/log/xray/: Log file directory (volume mount point declared byVOLUME) (owner:65532:65532, directory permissions:700)
teddysun/xray
Has root privileges, includes a shell environment, and is compatible with all architectures supported by Alpine. It is compiled and built by the private serverdl.lamp.sh. More convenient to use.File Structure
/usr/bin/xray: Xray main program/etc/xray/config.json: Single configuration file (its parent directory is a mount point)/usr/share/xray/: Resource file directory containing Loyalsoldier geolocation data files- geoip.dat
- geosite.dat
Third-Party Graphical Clients
| Platform | Project |
|---|---|
| OpenWrt | PassWall |
| OpenWrt | PassWall 2 |
| OpenWrt | ShadowSocksR Plus+ |
| OpenWrt | luci-app-xray (openwrt-xray) |
| Asuswrt-Merlin | XRAYUI |
| Windows | v2rayA |
| Windows | v2rayN |
| Android | v2rayNG |
| Android | X-flutter |
| Android | SaeedDev94/Xray |
| Android | SimpleXray |
| iOS / macOS arm64 / tvOS | Happ (tvOS) |
| iOS / macOS arm64 / tvOS | Streisand |
| macOS arm64 / x64 | Happ |
| macOS arm64 / x64 | v2rayA |
| macOS arm64 / x64 | v2rayN |
| macOS arm64 / x64 | V2rayU |
| macOS arm64 / x64 | V2RayXS |
| macOS arm64 / x64 | OneXray |
| Linux | v2rayA |
| Linux | v2rayN |
| Linux | GorzRay |
