update-uninstall.mdx 8.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101
  1. ---
  2. title: Обновление и удаление
  3. description: Управляйте 3x-ui через меню и CLI x-ui — обновляйте (стабильная, dev- или старая версия), меняйте настройки и удаляйте панель без остатков.
  4. icon: RefreshCw
  5. ---
  6. После установки через скрипт команда `x-ui` становится вашим центром управления.
  7. Запустите её без аргументов, чтобы открыть интерактивное меню, либо передайте
  8. подкоманду для разового действия.
  9. ```bash
  10. x-ui
  11. ```
  12. ## Меню управления `x-ui`
  13. В меню (пункты `0`–`28`) сверху отображается статус панели/Xray, а далее:
  14. | # | Пункт | Что делает |
  15. | ----- | -------------------------------------- | --------------------------------------------------------- |
  16. | 1 | Install | (Пере)установка из удалённого скрипта |
  17. | 2 | Update | Обновление до последнего **стабильного** релиза |
  18. | 3 | Update to Dev Channel (latest commit) | Обновление до скользящей сборки `dev-latest` |
  19. | 4 | Update Menu | Обновление только скрипта меню `x-ui` |
  20. | 5 | Legacy Version | Установка конкретной старой версии (запросит тег) |
  21. | 6 | Uninstall | Удаление 3x-ui (см. ниже) |
  22. | 7 | Reset Username & Password | Задать новые учётные данные; при желании отключить 2FA |
  23. | 8 | Reset Web Base Path | Сгенерировать случайный базовый веб-путь |
  24. | 9 | Reset Settings | Сброс настроек панели (ваша учётная запись сохраняется) |
  25. | 10 | Change Port | Изменить порт панели |
  26. | 11 | View Current Settings | Показать имя пользователя, порт, базовый веб-путь, пути к сертификатам |
  27. | 12–14 | Start / Stop / Restart | Управление службой панели |
  28. | 15 | Restart Xray | Перезапустить только Xray-core |
  29. | 16 | Check Status | Статус службы |
  30. | 17 | Logs Management | Просмотр отладочных логов / очистка логов |
  31. | 18–19 | Enable / Disable Autostart | Включить/выключить автозапуск при загрузке |
  32. | 20 | SSL Certificate Management | Let's Encrypt (домен или IP), пользовательские пути, продление/отзыв |
  33. | 21 | Cloudflare SSL Certificate | Wildcard-сертификат через DNS-01 с помощью Cloudflare |
  34. | 22 | IP Limit Management | Ограничения по IP на клиента на базе Fail2ban |
  35. | 23 | Firewall Management | Установка `ufw` и правила для портов |
  36. | 24 | SSH Port Forwarding Management | Привязать панель к localhost и туннелировать через SSH |
  37. | 25 | PostgreSQL Management | Установка/миграция/управление PostgreSQL |
  38. | 26 | Enable BBR | Переключить sysctl-управление перегрузкой BBR |
  39. | 27 | Update Geo Files | Обновить данные geoip/geosite (Loyalsoldier, IR, RU) |
  40. | 28 | Speedtest by Ookla | Запустить тест скорости Ookla |
  41. | 0 | Exit | — |
  42. Некоторым из этих пунктов посвящены отдельные страницы: [SSL-сертификаты](/docs/config/ssl-certificates)
  43. (пункты 20–21), [Безопасность](/docs/operations/security) (ограничения по IP, фаервол),
  44. [Обратный прокси](/docs/operations/reverse-proxy) и [Настройки панели](/docs/config/panel)
  45. (TLS), а также [База данных](/docs/reference/database) (PostgreSQL).
  46. ## Подкоманды CLI
  47. Для скриптов и быстрых действий `x-ui` также принимает подкоманду напрямую:
  48. | Команда | Действие |
  49. | -------------------------- | --------------------------------------------------- |
  50. | `x-ui start` / `stop` / `restart` | Управление службой |
  51. | `x-ui restart-xray` | Перезапустить только Xray-core |
  52. | `x-ui status` | Показать статус |
  53. | `x-ui settings` | Показать текущие настройки |
  54. | `x-ui enable` / `disable` | Включить/выключить автозапуск при загрузке |
  55. | `x-ui log` | Вывести отладочный лог в реальном времени |
  56. | `x-ui banlog` | Показать лог блокировок Fail2ban |
  57. | `x-ui update` | Обновить до последнего стабильного релиза |
  58. | `x-ui update-dev` | Обновить до скользящей сборки `dev-latest` |
  59. | `x-ui legacy` | Установить конкретную старую версию (с запросом) |
  60. | `x-ui update-all-geofiles` | Обновить все geo-файлы, перезапустить при изменениях |
  61. | `x-ui migrate-db --dsn …` | Миграция SQLite → PostgreSQL (см. [База данных](/docs/reference/database)) |
  62. | `x-ui install` / `uninstall` | Установка / удаление |
  63. ## Обновление
  64. - **Стабильная версия:** пункт меню **2** или `x-ui update`. Повторный запуск
  65. установочного скрипта также обновляет панель на месте.
  66. - **Dev-канал:** пункт меню **3** или `x-ui update-dev` — скользящая сборка
  67. `dev-latest` по каждому коммиту (не стабильный релиз).
  68. - **Конкретная старая версия:** пункт меню **5** (Legacy Version).
  69. Обновление сохраняет вашу базу данных и настройки. Перед переходом на новую
  70. мажорную версию сделайте [резервную копию](/docs/operations/backup-restore).
  71. <Callout type="info">
  72. Пользователи Docker обновляются иначе — нужно скачать новый образ и пересоздать
  73. контейнер (`docker compose pull && docker compose up -d`), а не использовать
  74. команды обновления `x-ui`.
  75. </Callout>
  76. ## Удаление
  77. Пункт меню **6** или `x-ui uninstall`. Команда останавливает и отключает службу,
  78. удаляет юнит службы, а также каталоги `/etc/x-ui/` и папку установки. Если панель
  79. использовала локально установленный PostgreSQL, она предложит удалить и его
  80. (отдельное необратимое подтверждение).
  81. <Callout type="warn">
  82. Удаление стирает базу данных (`/etc/x-ui/x-ui.db`) и вашу конфигурацию.
  83. Сначала сделайте [резервную копию](/docs/operations/backup-restore), если она
  84. может вам понадобиться.
  85. </Callout>