Установка
Установите 3x-ui с помощью официального скрипта (стабильная, фиксированная или dev-сборка), в автоматическом режиме / через cloud-init либо в Docker — и выберите SQLite или PostgreSQL.
3x-ui работает на широком спектре дистрибутивов Linux — Ubuntu, Debian, Armbian,
Fedora, CentOS, RHEL, AlmaLinux, Rocky Linux, Oracle Linux, Amazon Linux,
Virtuozzo, Arch, Manjaro, openSUSE (Tumbleweed/Leap), Alpine — а также в Windows,
на архитектурах amd64, 386, arm64, armv7, armv6, armv5 и s390x.
Запускайте установочный скрипт от имени root (или через sudo). Он
устанавливает службу, настраивает команду управления x-ui и включает
автозапуск панели при загрузке.
Официальный скрипт — рекомендуемый способ. В процессе установки он генерирует
случайные имя пользователя, пароль и путь доступа (базовый веб-путь),
настраивает службу и устанавливает команду управления x-ui.
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)Чтобы установить конкретную версию, добавьте её тег:
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh) v3.4.0Чтобы установить скользящую dev-сборку (последний предварительный релиз по
каждому коммиту из main — не стабильный релиз), передайте dev-latest:
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh) dev-latestПо завершении запишите выведенные данные для входа и выполните x-ui, чтобы
открыть меню управления,
а затем переходите к разделу Первый вход.
Сформируйте команду установки
Подстройте команду под свою конфигурацию:
Install command builder
Build the exact install command for your setup. It is assembled in your browser.
bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)Выберите базу данных
Хранилище выбирается на этапе установки:
- SQLite (по умолчанию) — единственный файл по пути
/etc/x-ui/x-ui.db. Без какой-либо настройки. - PostgreSQL — для большого числа клиентов или конфигураций с несколькими узлами. Установщик может развернуть её локально либо использовать предоставленный вами DSN.
Подробности и миграцию SQLite→PostgreSQL см. в разделе База данных.
Автоматическая установка / cloud-init
Установщик также работает в неинтерактивном режиме для автоматизации.
Задайте XUI_NONINTERACTIVE=1 (или запустите без TTY), и он выполнит установку
от начала до конца без единого запроса, сгенерировав случайные учётные данные и
записав их в /etc/x-ui/install-result.env:
XUI_NONINTERACTIVE=1 bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)В каталоге deploy/
репозитория есть готовые cloud-init user-data для автоматической установки в
любом облаке (Hetzner, AWS, DigitalOcean, Vultr, GCP, Azure, Oracle).
Дальнейшие шаги
Знакомство с 3x-ui
Веб-панель для Xray-core — управляйте входящими подключениями, протоколами, клиентами и подписками из браузера, не редактируя JSON вручную.
Первый вход
Найдите сгенерированные учётные данные 3x-ui, откройте панель, включите двухфакторную аутентификацию и защитите её, прежде чем открывать доступ извне.

3x-ui