Загрузка и установка

Поддержка платформ

Официальные Release поддерживают следующие платформы

Платформа	Архитектуры
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 в golang официально прекращена. Xray использует patched go и публикует отдельные сборки для этой системы; пользователям Windows 7 следует использовать релизы с суффиксом -win7.

Xray активно отслеживает версии golang. Для информации о минимальной поддерживаемой версии ОС, кроме win7, обращайтесь к актуальным release notes go, соответствующим моменту выпуска.

Сборки для amd64 v2/v3 и т. п. не предоставляются, как в некоторых похожих проектах, поскольку тестирование не показало значимого прироста производительности, а во многих ключевых функциях уже используется определение возможностей CPU во время выполнения для автоматического задействования расширенных наборов инструкций.

Загрузка Xray

Предварительно собранные ZIP-архивы с бинарными файлами доступны в Github Releases.

Скачайте архив для своей платформы и распакуйте его, после чего Xray можно использовать.

Проверка установочных пакетов

Xray предоставляет два способа проверки:

SHA1 / SHA256 хэши ZIP-архивов
Воспроизводимая сборка: см. Сборка Xray

Установка в Windows

Скачайте ZIP-архив для Windows из Github Releases. После распаковки вы получите исполняемый файл xray.exe, который затем можно запустить с аргументами командной строки

Установка в macOS

Скачайте ZIP-архив для macOS из Github Releases. После распаковки вы получите исполняемый файл xray, который затем можно запустить с аргументами командной строки
Установите через менеджер пакетов Homebrew: brew install xray
homebrew-xray, спасибо @N4FA

Установка в Linux

Скрипты и проекты для установки

Тип	Проект	Описание
Linux Script	XTLS/Xray-install (Официальный)	Официально поддерживаемый скрипт установки для Linux
Linux Script	tempest	Поддерживает `Systemd` и `OpenRC`
One Click	Xray-REALITY	Решение для установки в один клик
One Click	reality-ezpz	Решение для установки в один клик
One Click	Xray_bash_onekey	Решение для установки в один клик
One Click	v2ray-agent	Решение для установки в один клик
One Click	ProxySU	Решение для установки в один клик
Magisk	Xray4Magisk	Для окружений с Magisk
Magisk	Xray_For_Magisk	Для окружений с Magisk

Менеджеры пакетов и репозитории дистрибутивов

Способ	Проект	Описание
Arch User Repository	AUR helpers	Например, с yay установка выполняется командой `yay -S xray`
Arch Linux CN	репозиторий Arch Linux CN	После добавления репозитория установите через `pacman -S xray` от имени root
Linuxbrew	Homebrew	Использование такое же, как у Homebrew: `brew install xray`
Gentoo Portage	Gentoo-zh	Подходит для систем с Systemd; установка после добавления Overlay через layman или eselect-repository

Установка через Docker

Сейчас доступны Docker-образы двух разных типов:

ghcr.io/xtls/xray-core (Официальный)
Не имеет root-прав, не содержит shell-окружения и поддерживает больше архитектур. Компилируется и собирается из официального репозитория с поддержкой отслеживаемости. Удобство принесено в жертву ради более строгой безопасности.
Структура файлов
- /usr/local/bin/xray: основная программа Xray (владелец: root:root, права на файл: 755)
- /usr/local/etc/xray/: каталог конфигурационных файлов (точка монтирования) (владелец: root:root, права на каталог: 755, права на файлы: 644)
  - 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
  - 99_version.json
- /usr/local/share/xray/: каталог файлов ресурсов с геоданными Loyalsoldier (владелец: 65532:65532, права на каталог: 755, права на файлы: 644)
  - geoip.dat
  - geosite.dat
- /var/log/xray/: каталог логов (точка монтирования) (владелец каталога: root:root, права: 755; владелец файлов: 65532:65532, права: 600)
  - access.log
  - error.log
teddysun/xray
Имеет root-права, shell-окружение и совместим со всеми архитектурами, поддерживаемыми Alpine. Компилируется и собирается на частном сервере dl.lamp.sh. Более удобен в использовании.
Структура файлов
- /usr/bin/xray: основная программа Xray
- /etc/xray/config.json: единый конфигурационный файл (его родительский каталог является точкой монтирования)
- /usr/share/xray/: каталог файлов ресурсов с геоданными v2fly
  - geoip.dat
  - geosite.dat

Сторонние графические клиенты

Платформа	Проект
OpenWrt	PassWall
OpenWrt	PassWall 2
OpenWrt	ShadowSocksR Plus+
OpenWrt	luci-app-xray (openwrt-xray)
Asuswrt-Merlin	XRAYUI
Windows	v2rayA
Windows	v2rayN
Windows	Furious
Windows	Invisible Man - Xray
Windows	AnyPortal
Android	v2rayNG
Android	X-flutter
Android	SaeedDev94/Xray
Android	SimpleXray
Android	AnyPortal
iOS / macOS arm64 / tvOS	Happ (tvOS)
iOS / macOS arm64 / tvOS	FoXray
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	Furious
macOS arm64 / x64	OneXray
macOS arm64 / x64	GoXRay
macOS arm64 / x64	AnyPortal
Linux	v2rayA
Linux	v2rayN
Linux	Furious
Linux	GorzRay
Linux	GoXRay
Linux	AnyPortal