Скачать и установить клиент 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 wingetEXE и 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 onexrayRPM для 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 onexrayZIP для 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-binFedora
Используйте версию Fedora, которая соответствует всем требованиям к системным библиотекам:
sudo dnf install unzip gtk3 glib2 libstdc++ libepoxy libX11 libXi procps-ng libcapArch 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.
Далее: первое подключение.