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

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

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

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

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

```bash
sudo apt update && sudo apt install curl -y

```

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

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

```bash
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 уже открыты):

```bash
sudo ufw allow 2053/tcp

```

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

## 4. Проверка

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

```bash
sudo systemctl status x-ui --no-pager

```

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

```bash
x-ui

```

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

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

```bash
sudo journalctl -u x-ui -f

```

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

```bash
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. Обновление и удаление

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

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

```

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

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

```

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

- Сменить дефолтный порт панели и webBasePath сразу после установки, если пропустили на шаге 2 (доступно в меню `x-ui`).
- Не открывать порт панели на 80/443, если эти порты уже заняты Caddy/nginx — конфликт портов уронит один из сервисов.
- Настроить бэкап `/etc/x-ui/x-ui.db` — в нём вся конфигурация inbound'ов и клиентов.
- Официальный install-скрипт вызывает не флаг `-webBasePath` в кавычках без слешей, а напрямую бинарник, лежащий в `/usr/local/x-ui/`:
    
    <div><div aria-label="bash code" role="group" tabindex="0"><div><div>  
    </div></div><div>bash</div><div></div></div></div>
    
    ```bash
    /usr/local/x-ui/x-ui setting -webBasePath ваш-путь
    ```