Download and Install

Platform Support

  • Xray is available on the following platforms:
    • Windows 7 and later (x86 / amd64 / arm32 / arm64);
      • If you need to use these version (1.8.18 and later marked with win7, 1.8.6, 1.8.4) in Windows 7, operating system update KB4474419 is required. For better Internet security, it is recommended to install KB4490628 to acquire later operating system updates from Windows Update.
    • macOS 10.10 Yosemite and later (amd64 / arm64);
    • 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 subsequent versions, CentOS 7 / 8, Arch Linux, etc.;
    • FreeBSD (x86 / amd64);
    • OpenBSD (x86 / amd64);

Download Xray

Precompiled binaries in ZIP format are available at GitHub Releasesopen in new tag found in.

Download the compressed package of the corresponding platform, and use it after decompression.

Verify the Installation Package

Xray provides two verification methods:

  • SHA1/SHA256 digest of the ZIP archive
  • Reproducible build: Please refer to Compile Xray

Install on Windows

Install on macOS

Install on Linux

Install Script

Arch Linux

Arch User Repository

Need to use AUR helpersopen in new tag, yayopen in new tag as an example, it can be installed via yay -S xray.

Arch Linux CN

First add Arch Linux CNopen in new tag repository, and then use the root user pacman -S xrayto install.

Linuxbrew

The Linuxbrew package manager is used in the same way as Homebrew: brew install xray

Debian WIP

Gentoo

Currently, three third-party Overlays provide Portage installation scripts:

Use layman or eselect-repository to add the Overlay to your local repository, then install.

Install via Docker

Currently two different styles of Docker images are provided:

  • teddysun/xrayopen in new tag: Root privileges, shell environment, compatible with all architectures supported by Alpine. Compiled and built via a private server (dl.lamp.sh). Offers better ease of use
  • ghcr.io/xtls/xray-coreopen in new tag: Rootless, no shell environment, supports more architectures. Compiled from the official repository with build provenance. Sacrifices convenience for extreme security

Docker Image File Structure

teddysun/xray image:

  • /usr/bin/xray: Xray-core executable
  • /etc/xray/config.json: Single configuration file (its directory is the mount point)
  • /usr/share/xray/: Resource directory containing v2fly geodata files
    • geoip.dat
    • geosite.dat

ghcr.io/xtls/xray-core image:

  • /usr/local/bin/xray: Xray-core executable (owner: root:root, permissions: 755)
  • /usr/local/etc/xray/: Configuration directory (mount point). Owner: root:root, directory permissions: 755, file permissions: 644
    • 00_log.json
    • 01_api.json
    • 02_dns.json
    • 03_routing.json
    • 04_policy.json
    • 05_inbounds.json
    • 06_outbounds.json
    • 07_transport.json
    • 08_stats.json
    • 09_reverse.json
  • /usr/local/share/xray/: Resource directory containing Loyalsoldier geodata files (same permissions as above)
    • geoip.dat
    • geosite.dat
  • /var/log/xray/: Log directory (mount point). Directory owner: root:root, permissions: 755. File owner: 65532:65532, permissions: 600
    • access.log
    • error.log

GUI Client

UUID Generator

Third-party UUID generator uuidgenerator.netopen in new tag