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

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

Официальные 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

Генератор UUID

Сторонний генератор UUID: uuidgenerator.net