Установка панели 3X-UI и команды консоли управления (CLI) #

Установка в одну команду (рекомендуемый способ) #

Самый быстрый и надежный способ установить панель 3X-UI на чистый сервер с Ubuntu, Debian или CentOS — официальный установочный bash-скрипт:

1. Подключитесь к вашему серверу по SSH под пользователем root.
2. Убедитесь, что в системе установлена утилита curl (если нет, установите: apt update && apt install -y curl).
3. Выполните команду установки:

bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)

4. В процессе установки скрипт предложит настроить реквизиты входа:

   • Порт панели (по умолчанию генерируется случайный высокий порт, либо можно указать свой, например 2053).
   • Логин администратора (генерируется случайный или задается вручную).
   • Пароль администратора (генерируется надежный пароль).
   • Секретный базовый путь (Web Base Path) — дополнительный префикс в URL для защиты панели от сканеров (например, /secretpath/).

5. По завершении установки в консоли отобразятся точные реквизиты и готовая ссылка для входа вида:
   http://<IP-вашего-сервера>:<порт>/<базовый-путь>/

Установка через Docker и Docker Compose #

Развертывание в Docker изолирует панель от основной операционной системы и упрощает перенос на другой сервер.

1. Установка Docker и Compose #

Если Docker еще не установлен на сервере:

bash <(curl -sSL https://get.docker.com)

2. Запуск через Docker Compose #

Создайте каталог для файлов панели:

mkdir -p /root/panel && cd /root/panel

Создайте файл docker-compose.yml:

services:
  3xui:
    image: ghcr.io/mhsanaei/3x-ui:latest
    container_name: 3xui_app
    cap_add:
      - NET_ADMIN
      - NET_RAW
    volumes:
      - ./db/:/etc/x-ui/
      - ./cert/:/root/cert/
    environment:
      XRAY_VMESS_AEAD_FORCED: "false"
      XUI_ENABLE_FAIL2BAN: "true"
    tty: true
    network_mode: host
    restart: unless-stopped

docker compose up -d

По умолчанию в контейнере панель слушает порт 2053. Стандартные реквизиты для первого входа:

• 👤 Логин: admin
• 🔑 Пароль: admin
• Ссылка: http://<IP-сервера>:2053/

Обновление контейнера Docker: #

cd /root/panel
docker compose down
docker compose pull
docker compose up -d

3. Быстрый запуск через Docker CLI в одну команду: #

docker run -itd \
  -e XRAY_VMESS_AEAD_FORCED=false \
  -e XUI_ENABLE_FAIL2BAN=true \
  -v /root/panel/db/:/etc/x-ui/ \
  -v /root/panel/cert/:/root/cert/ \
  --cap-add=NET_ADMIN \
  --cap-add=NET_RAW \
  --network=host \
  --restart=unless-stopped \
  --name 3x-ui \
  ghcr.io/mhsanaei/3x-ui:latest

Ручная установка (Manual Installation) #

Для установки панели напрямую из бинарных файлов без использования скрипта автоматической установки:

1. Скачайте архив для архитектуры вашего процессора:

ARCH=$(uname -m)
case "${ARCH}" in
  x86_64 | x64 | amd64) XUI_ARCH="amd64" ;;
  armv8* | armv8 | arm64 | aarch64) XUI_ARCH="arm64" ;;
  *) XUI_ARCH="amd64" ;;
esac

wget https://github.com/MHSanaei/3x-ui/releases/latest/download/x-ui-linux-${XUI_ARCH}.tar.gz

2. Распакуйте файлы и настройте права:

tar zxvf x-ui-linux-${XUI_ARCH}.tar.gz
chmod +x x-ui/x-ui x-ui/bin/xray-linux-* x-ui/x-ui.sh
cp x-ui/x-ui.sh /usr/bin/x-ui
cp -f x-ui/x-ui.service /etc/systemd/system/
mv x-ui/ /usr/local/

3. Запустите и добавьте службу в автозагрузку systemd:

systemctl daemon-reload
systemctl enable x-ui
systemctl restart x-ui

Полный справочник команд консоли (`x-ui`) #

Для управления панелью 3X-UI на сервере используется консольная утилита x-ui.

Прямые команды терминала (CLI) #

Вы можете выполнять команды напрямую из bash без входа в интерактивное меню:

Интерактивное меню консоли (`x-ui`) #

Если выполнить в терминале команду x-ui без аргументов, откроется удобное текстовое меню со всеми операциями:

╔────────────────────────────────────────────────╗
│  3X-UI Panel Management Script                 │
│  0. Exit Script (Выход)                        │
├────────────────────────────────────────────────┤
│  1. Install (Установка)                        │
│  2. Update (Обновление)                        │
│  3. Update to Dev Channel (Dev-канал)          │
│  4. Update Menu (Обновить само меню)           │
│  5. Legacy Version (Устаревшая версия)         │
│  6. Uninstall (Удаление панели)                │
├────────────────────────────────────────────────┤
│  7. Reset Username & Password (Сброс пароля)   │
│  8. Reset Web Base Path (Сброс URL-пути)       │
│  9. Reset Settings (Полный сброс настроек)     │
│  10. Change Port (Сменить порт панели)         │
│  11. View Current Settings (Показать настройки)│
├────────────────────────────────────────────────┤
│  12. Start (Запуск службы)                     │
│  13. Stop (Остановка службы)                   │
│  14. Restart (Перезапуск службы)               │
│  15. Restart Xray (Перезапуск ядра Xray)       │
│  16. Check Status (Проверка статуса)           │
│  17. Logs Management (Просмотр логов)          │
├────────────────────────────────────────────────┤
│  18. Enable Autostart (Включить автозапуск)    │
│  19. Disable Autostart (Выключить автозапуск)  │
├────────────────────────────────────────────────┤
│  20. SSL Certificate Management (Выпуск SSL)   │
│  21. Cloudflare SSL Certificate (SSL через CF) │
│  22. IP Limit Management (Управление Fail2ban) │
│  23. Firewall Management (Настройка UFW)       │
│  24. SSH Port Forwarding (Проброс порта по SSH)│
│  25. PostgreSQL Management (Управление PG)     │
├────────────────────────────────────────────────┤
│  26. Enable BBR (Включение TCP BBR)            │
│  27. Update Geo Files (Обновление геобаз)      │
│  28. Speedtest by Ookla (Тест скорости сети)   │
╚────────────────────────────────────────────────╝

Сброс забытого пароля или порта из консоли #

Если вы забыли логин, пароль или порт панели:

1. Подключитесь к серверу по SSH.
2. Введите x-ui и выберите пункт 7 (Reset Username & Password) — задайте новый логин и пароль (при необходимости подтвердите отключение двухфакторной аутентификации 2FA).
3. Либо выберите пункт 11 (View Current Settings) — скрипт покажет текущие порт, логин, пароль и URL-путь без их изменения.
4. Если панель не открывается из-за сбоя настроек, выберите пункт 9 (Reset Settings) — настройки сбросятся к безопасным значениям по умолчанию (порт 2053, логин admin, пароль admin).