Перейти к содержимому
Установка OneXray

Скачать и установить клиент Xray-core OneXray

OneXray — клиент Xray-core с открытым кодом для компьютеров и мобильных устройств. Приложение не предоставляет серверы или подписку: перед подключением получите совместимую конфигурацию у своего провайдера. Отдельно устанавливать консольный Xray-core не нужно.

После установки добавьте серверы или создайте конфигурацию с ИИ. При ошибках сначала проверьте совместимость формата, затем настройки платформы.

Перед загрузкой проверьте системные требования, особенно дистрибутив и версии библиотек Linux.

Выберите платформу

Платформа Требования Загрузка
iPhone / iPad iOS / iPadOS 16+ App Store · IPA
Mac App Store macOS 13+, Apple silicon или Intel App Store
Mac — OneXraySE macOS 13+, Apple silicon или Intel Homebrew · Universal ZIP
Android, телефоны и планшеты Android 10+ (API 29), arm64-v8a или x86_64 Google Play · APK
Windows x64 Windows 10 20H2 (19042)+ Microsoft Store · EXE (winget) · ZIP
Windows ARM64 Windows 11 Microsoft Store · EXE (winget) · ZIP
Linux x86_64 glibc 2.39+, GLib 2.80+, GTK 3, ядро 5.3+ DEB · RPM · pacman · ZIP
Linux arm64 glibc 2.39+, GLib 2.80+, GTK 3, ядро 5.3+ DEB · RPM · pacman · ZIP

Полный список файлов и изменений — в Releases. 32-битный ARM на Android не поддерживается.

Windows

Microsoft Store

Установите приложение из Microsoft Store или через winget, указав источник магазина:

winget install --id 9NJ0MVHW215D --source msstore

Эта версия использует MSIX и системный VPN Windows, без UAC для Core. Microsoft Store выбирает архитектуру и устанавливает обновления.

Отдельные EXE / ZIP

Установите самостоятельную EXE-версию из источника сообщества winget:

winget install --id YuanDevLLC.OneXray -e --source winget

EXE и ZIP используют нативный TUN. При запуске VPN требуется подтверждение UAC для Core; само приложение работает без прав администратора. ZIP нужно распаковать целиком. Он не регистрирует ссылки и не создаёт ярлыки автоматически.

EXE/ZIP и MSIX хранят данные раздельно; смена канала не переносит их автоматически. Обе версии требуют выбора исходящего интерфейса Xray. Подробнее о Windows.

Все пакеты Windows включают Microsoft Visual C++ Runtime нужной архитектуры. Для интерфейса приложения не нужна отдельная установка среды выполнения.

macOS

Версия Mac App Store использует Packet Tunnel. OneXraySE использует System Extension:

brew install --cask onexrayse

Для ZIP сначала перенесите OneXraySE.app в /Applications. После Setup войдите в основной интерфейс и разрешите VPN и сетевое расширение. macOS может открыть раздел расширений/объектов входа или конфиденциальности и безопасности; выполните запрос на перезагрузку, если он появится.

Для обновления ZIP закройте приложение, замените его в /Applications и подтвердите обновление расширения, если потребуется. См. руководство Apple.

iOS IPA

Проще всего установить приложение из App Store. Для самостоятельной установки IPA нужно переподписать приложение и Packet Tunnel с профилями, разрешающими Network Extension. Бесплатная Personal Team этой возможности не предоставляет. См. возможности Apple Developer.

Linux

Сначала проверьте системные требования Linux: пакетам DEB, RPM, pacman (.pkg.tar.zst) и ZIP нужны Ubuntu 24.04 LTS или совместимый дистрибутив с glibc 2.39+, GLib 2.80+ и GTK 3. Ubuntu 22.04 несовместима.

Для наблюдения за процессом Core требуется ядро Linux 5.3+ с поддержкой pidfd. На Linux ARM64 китайский, японский и корейский сейчас отображаются на английском без изменения сохранённого предпочтения; см. языковые настройки.

На странице GitHub Releases выберите нужный выпуск и скачайте пакет для своего дистрибутива и архитектуры из списка файлов. Используйте формат, который фактически доступен в выбранном выпуске. Если подходящего нативного пакета нет, используйте ZIP.

Перед установкой, обновлением или удалением пакета остановите VPN и закройте OneXray. Нативные пакеты устанавливают зависимости и автоматически выдают Core права cap_net_admin и cap_net_raw при первой установке и обновлении. Запускайте графическое приложение от обычного пользователя рабочего стола; sudo нужен только для управления пакетами, а не для запуска всего приложения. В выводе проверок getcap ниже должны присутствовать cap_net_admin,cap_net_raw=eip.

Установка локального файла не добавляет репозиторий обновлений OneXray. Для обновления скачайте пакет нового выпуска и повторите соответствующую команду установки ниже.

DEB для Debian / Ubuntu

В выбранном выпуске скачайте OneXray-linux-x86_64.deb для x86_64 или OneXray-linux-aarch64.deb для arm64. На совместимой системе Debian/Ubuntu откройте терминал в каталоге с загруженным файлом и установите его:

sudo apt install ./OneXray-linux-x86_64.deb

Для arm64 замените имя файла на OneXray-linux-aarch64.deb. Core установлен в /opt/OneXray/OneXrayCore. Проверьте capabilities и запустите приложение от обычного пользователя:

getcap /opt/OneXray/OneXrayCore
OneXray

Для обновления остановите VPN, закройте OneXray и повторите команду apt install с файлом нового выпуска. Пакет снова выдаст capabilities новому Core. Для удаления приложения с сохранением личных данных:

sudo apt remove onexray

RPM для Fedora

В выбранном выпуске скачайте OneXray-linux-x86_64.rpm для x86_64 или OneXray-linux-aarch64.rpm для arm64. Используйте версию Fedora, которая соответствует всем требованиям к системным библиотекам. Откройте терминал в каталоге с загруженным файлом:

sudo dnf install ./OneXray-linux-x86_64.rpm

Для arm64 замените имя файла на OneXray-linux-aarch64.rpm. Core установлен в /usr/share/onexray/OneXrayCore. Проверьте capabilities и запустите приложение от обычного пользователя:

getcap /usr/share/onexray/OneXrayCore
onexray

Для обновления остановите VPN, закройте OneXray и повторите команду dnf install с файлом нового выпуска. Пакет снова выдаст capabilities новому Core. Для удаления приложения с сохранением личных данных:

sudo dnf remove onexray

Пакет pacman для Arch Linux

Для стандартного Arch Linux x86_64 скачайте OneXray-linux-x86_64.pkg.tar.zst из выбранного выпуска. Откройте терминал в каталоге с загруженным файлом:

sudo pacman -Syu
sudo pacman -U ./OneXray-linux-x86_64.pkg.tar.zst

Файл OneXray-linux-aarch64.pkg.tar.zst предназначен для совместимого дистрибутива ARM64 с pacman, который соответствует всем системным требованиям; стандартный Arch Linux поддерживает x86_64. Для такой системы замените имя файла в команде.

Core установлен в /opt/OneXray/OneXrayCore. Проверьте capabilities и запустите приложение от обычного пользователя; команда запуска начинается с заглавной буквы:

getcap /opt/OneXray/OneXrayCore
OneXray

Для обновления остановите VPN, закройте OneXray и повторите команду pacman -U с файлом нового выпуска. Пакет снова выдаст capabilities новому Core. Для удаления приложения с сохранением личных данных:

sudo pacman -R onexray

ZIP для Ubuntu, Fedora и Arch Linux

Для ZIP нужно вручную установить библиотеки и выдать Core сетевые capabilities. Сначала выполните команды для своего дистрибутива, затем общие шаги распаковки и запуска. Эти команды не меняют минимальные версии библиотек в системных требованиях.

Ubuntu 24.04 LTS

sudo apt install -y unzip libgtk-3-0t64 libglib2.0-0t64 libstdc++6 libepoxy0 libx11-6 libxi6 procps libcap2-bin

Fedora

Используйте версию Fedora, которая соответствует всем требованиям к системным библиотекам:

sudo dnf install unzip gtk3 glib2 libstdc++ libepoxy libX11 libXi procps-ng libcap

Arch Linux

На Arch Linux x86_64 обновите систему и установите зависимости одной командой:

sudo pacman -Syu --needed unzip gtk3 libstdc++ procps-ng libcap

Распаковка, права Core и запуск

Загрузите ZIP для своей архитектуры из таблицы выше. Пример для x86_64 сохраняет весь пакет в $HOME/Applications/OneXray; для arm64 замените имя архива на OneXray-linux-aarch64.zip. Если браузер сохранил файл в другом месте, измените путь загрузки.

mkdir -p "$HOME/Applications/OneXray"
unzip "$HOME/Downloads/OneXray-linux-x86_64.zip" -d "$HOME/Applications/OneXray"
cd "$HOME/Applications/OneXray"
chmod +x ./OneXray ./OneXrayCore
sudo setcap cap_net_admin,cap_net_raw+eip ./OneXrayCore
getcap ./OneXrayCore
./OneXray

Исполняемые файлы находятся прямо в корне ZIP; команда распаковки создаёт для них отдельный каталог. OneXrayCore находится рядом с OneXray в $HOME/Applications/OneXray. Сохраните в нём lib/, data/ и остальные файлы пакета. Запускайте графическое приложение от обычного пользователя рабочего стола; sudo выше нужен только для установки зависимостей и выдачи прав Core.

Для обновления остановите VPN и закройте OneXray, замените распакованный пакет целиком и повторите chmod и setcap для новых файлов перед запуском. При замене Core файловые capabilities не сохраняются. ZIP не регистрирует ссылки onexray://. Для трея GNOME может понадобиться AppIndicator.

Далее: первое подключение.

Последнее обновление