Skip to main content

Установка 3X-UI v2.8.11 на Ubuntu

Панель управления Xray (VLESS/VMess/Trojan/Shadowsocks и др.) — MHSanaei/3x-ui. Установка через официальный скрипт с жёсткой фиксацией версии, чтобы скрипт не подтянул latest.

Каждый блок кода ниже рассчитан на копирование целиком.

1. Зависимости

Скрипту нужен curl:

sudo apt update && sudo apt install curl -y

2. Установка панели (фиксированная версия v2.8.11)

Версию нужно передать дважды: один раз в переменную VERSION (подставляется в URL самого скрипта), второй раз — аргументом скрипту (иначе он всё равно спросит версию или возьмёт последнюю):

VERSION=v2.8.11 && bash <(curl -Ls "https://raw.githubusercontent.com/mhsanaei/3x-ui/$VERSION/install.sh") $VERSION

Скрипт интерактивный и спросит:

  • имя пользователя и пароль панели (не оставлять по умолчанию admin/admin);
  • порт панели (лучше нестандартный, не 80/443 — их обычно занимает реверс-прокси);
  • webBasePath — случайный путь вида /a1b2c3d4/, без него панель на голом порту легко просканировать.

Установщик сам поставит x-ui как systemd-сервис и включит автозапуск.

3. Файрвол

Открываем порт панели, который указали на шаге 2 (пример для порта 2053; если ставили из-под UFW из предыдущего гайда по серверу — SSH/80/443 уже открыты):

sudo ufw allow 2053/tcp

Порты самих inbound'ов (VLESS/Trojan и т. п.) открываются отдельно, когда добавляете их в панели — там же видно, какой порт и протокол занят.

4. Проверка

Статус сервиса:

sudo systemctl status x-ui --no-pager

Установленная версия и путь к панели — команда x-ui открывает интерактивное меню:

x-ui

В меню пункт со статусом покажет версию, порт и webBasePath — свериться, что совпадает с тем, что вводили на шаге 2.

Логи, если панель не поднимается:

sudo journalctl -u x-ui -f

5. Управление сервисом

sudo systemctl restart x-ui   # перезапуск
sudo systemctl stop x-ui      # остановка
sudo systemctl enable x-ui    # автозапуск (обычно уже включён установщиком)

6. TLS для панели (опционально)

Если панель смотрит наружу напрямую (без Caddy/nginx перед ней), в меню x-ui есть пункт для выпуска сертификата Let's Encrypt на домен — доступен через тот же интерактивный x-ui, раздел SSL. Домен должен A-записью указывать на сервер до запроса сертификата, как и в шаге с Caddy из общего гайда по серверу.

7. Обновление и удаление

Обновление до другой версии — та же команда установки с новым тегом:

VERSION=vX.Y.Z && bash <(curl -Ls "https://raw.githubusercontent.com/mhsanaei/3x-ui/$VERSION/install.sh") $VERSION

Удаление — через меню:

x-ui
# выбрать пункт uninstall

Что стоит сделать дополнительно

  • Сменить дефолтный порт панели и webBasePath сразу после установки, если пропустили на шаге 2 (доступно в меню x-ui).
  • Не открывать порт панели на 80/443, если эти порты уже заняты Caddy/nginx — конфликт портов уронит один из сервисов.
  • Настроить бэкап /etc/x-ui/x-ui.db — в нём вся конфигурация inbound'ов и клиентов.