3x-uiОбновление и удаление
Управляйте 3x-ui через меню и CLI x-ui — обновляйте (стабильная, dev- или старая версия), меняйте настройки и удаляйте панель без остатков.
После установки через скрипт команда x-ui становится вашим центром управления.
Запустите её без аргументов, чтобы открыть интерактивное меню, либо передайте
подкоманду для разового действия.
x-uiМеню управления x-ui
В меню (пункты 0–28) сверху отображается статус панели/Xray, а далее:
| # | Пункт | Что делает |
|---|---|---|
| 1 | Install | (Пере)установка из удалённого скрипта |
| 2 | Update | Обновление до последнего стабильного релиза |
| 3 | Update to Dev Channel (latest commit) | Обновление до скользящей сборки dev-latest |
| 4 | Update Menu | Обновление только скрипта меню x-ui |
| 5 | Legacy Version | Установка конкретной старой версии (запросит тег) |
| 6 | Uninstall | Удаление 3x-ui (см. ниже) |
| 7 | Reset Username & Password | Задать новые учётные данные; при желании отключить 2FA |
| 8 | Reset Web Base Path | Сгенерировать случайный базовый веб-путь |
| 9 | Reset Settings | Сброс настроек панели (ваша учётная запись сохраняется) |
| 10 | Change Port | Изменить порт панели |
| 11 | View Current Settings | Показать имя пользователя, порт, базовый веб-путь, пути к сертификатам |
| 12–14 | Start / Stop / Restart | Управление службой панели |
| 15 | Restart Xray | Перезапустить только Xray-core |
| 16 | Check Status | Статус службы |
| 17 | Logs Management | Просмотр отладочных логов / очистка логов |
| 18–19 | Enable / Disable Autostart | Включить/выключить автозапуск при загрузке |
| 20 | SSL Certificate Management | Let's Encrypt (домен или IP), пользовательские пути, продление/отзыв |
| 21 | Cloudflare SSL Certificate | Wildcard-сертификат через DNS-01 с помощью Cloudflare |
| 22 | IP Limit Management | Ограничения по IP на клиента на базе Fail2ban |
| 23 | Firewall Management | Установка ufw и правила для портов |
| 24 | SSH Port Forwarding Management | Привязать панель к localhost и туннелировать через SSH |
| 25 | PostgreSQL Management | Установка/миграция/управление PostgreSQL |
| 26 | Enable BBR | Переключить sysctl-управление перегрузкой BBR |
| 27 | Update Geo Files | Обновить данные geoip/geosite (Loyalsoldier, IR, RU) |
| 28 | Speedtest by Ookla | Запустить тест скорости Ookla |
| 0 | Exit | — |
Некоторым из этих пунктов посвящены отдельные страницы: SSL-сертификаты (пункты 20–21), Безопасность (ограничения по IP, фаервол), Обратный прокси и Настройки панели (TLS), а также База данных (PostgreSQL).
Подкоманды CLI
Для скриптов и быстрых действий x-ui также принимает подкоманду напрямую:
| Команда | Действие |
|---|---|
x-ui start / stop / restart | Управление службой |
x-ui restart-xray | Перезапустить только Xray-core |
x-ui status | Показать статус |
x-ui settings | Показать текущие настройки |
x-ui enable / disable | Включить/выключить автозапуск при загрузке |
x-ui log | Вывести отладочный лог в реальном времени |
x-ui banlog | Показать лог блокировок Fail2ban |
x-ui update | Обновить до последнего стабильного релиза |
x-ui update-dev | Обновить до скользящей сборки dev-latest |
x-ui legacy | Установить конкретную старую версию (с запросом) |
x-ui update-all-geofiles | Обновить все geo-файлы, перезапустить при изменениях |
x-ui migrate-db --dsn … | Миграция SQLite → PostgreSQL (см. База данных) |
x-ui install / uninstall | Установка / удаление |
Обновление
- Стабильная версия: пункт меню 2 или
x-ui update. Повторный запуск установочного скрипта также обновляет панель на месте. - Dev-канал: пункт меню 3 или
x-ui update-dev— скользящая сборкаdev-latestпо каждому коммиту (не стабильный релиз). - Конкретная старая версия: пункт меню 5 (Legacy Version).
Обновление сохраняет вашу базу данных и настройки. Перед переходом на новую мажорную версию сделайте резервную копию.
Пользователи Docker обновляются иначе — нужно скачать новый образ и пересоздать
контейнер (docker compose pull && docker compose up -d), а не использовать
команды обновления x-ui.
Удаление
Пункт меню 6 или x-ui uninstall. Команда останавливает и отключает службу,
удаляет юнит службы, а также каталоги /etc/x-ui/ и папку установки. Если панель
использовала локально установленный PostgreSQL, она предложит удалить и его
(отдельное необратимое подтверждение).
Удаление стирает базу данных (/etc/x-ui/x-ui.db) и вашу конфигурацию.
Сначала сделайте резервную копию, если она
может вам понадобиться.
Первый вход
Найдите сгенерированные учётные данные 3x-ui, откройте панель, включите двухфакторную аутентификацию и защитите её, прежде чем открывать доступ извне.
Настройки панели
Все настройки панели 3x-ui — веб-сервер, TLS, отображение, безопасность и уведомления — со значениями по умолчанию из исходного кода.