Как вызвать меню 3x-ui по SSH и что делать, если команда не работает

Question

Как вызвать меню панели 3x-ui по SSH и что делать, если команда x-ui перестала работать?

Здравствуйте. У меня возникла проблема с панелью 3x-ui: ранее она корректно работала и через веб-интерфейс, и по SSH, но теперь при попытке вызвать меню командой x-ui по SSH ничего не происходит. Команда не выполняется, как будто я ничего не ввожу. При этом веб-интерфейс панели продолжает работать безупречно. Я уверен, что логин и пароль верны, так как их не менял. Подскажите, пожалуйста, в чем может быть причина и как решить эту проблему? Я только начинаю осваивать Linux, поэтому прошу дать максимально подробные инструкции.

НейроОтветы · Accepted Answer

Основная команда для вызова меню панели 3x-ui по SSH - это x-ui, но если она перестала работать, это может быть связано с проблемами прав доступа, повреждением исполняемого файла или конфликтами файрвола. Для устранения этой проблемы необходимо выполнить пошаговую диагностику, проверить наличие файла и его права, а в крайнем случае выполнить переустановку панели.

Содержание
Основные методы вызова меню 3x-ui по SSH
Причины, по которым команда x-ui может не работать
Пошаговая диагностика и устранение проблемы
Альтернативные способы доступа к панели 3x-ui
Восстановление работоспособности панели 3x-ui: полная переустановка
Источники
Заключение

Основные методы вызова меню 3x-ui по SSH

Стандартный способ доступа к меню панели 3x-ui через SSH - это ввод команды x-ui в консоли после подключения к серверу. Эта команда должна запустить интерактивное текстовое меню, через которое можно управлять панелью. Однако, как вы обнаружили, иногда эта команда перестает работать, в то время как веб-интерфейс продолжает функционировать нормально.

Для начала убедитесь, что вы подключены к серверу по SSH с правами пользователя, под которым установлена панель 3x-ui. Обычно это пользователь root. Если вы используете другого пользователя, попробуйте добавить sudo перед командой:

В большинстве случаев именно эта команда и вызывает меню панели. Если она не работает, проверьте, существует ли исполняемый файл:

Эта команда должна показать путь к исполняемому файлу. Если команда не возвращает результат, значит файл отсутствует, и это объясняет, почему меню не вызывается.

Также стоит проверить, работает ли сам сервис 3x-ui:

Если сервис неактивен, это может быть причиной проблемы. Для запуска сервиса используйте команду:

Иногда проблема может быть связана с правами доступа к файлу. Проверьте права доступа с помощью команды:

Файл должен иметь права на исполнение. Если это не так, вы можете их исправить:

Причины, по которым команда x-ui может не работать

Существует несколько возможных причин, по которым команда x-ui перестала работать, хотя веб-интерфейс продолжает функционировать. Давайте рассмотрим каждую из них подробнее.

Отсутствие или повреждение исполняемого файла

Самая распространенная причина - это отсутствие или повреждение файла x-ui. Панель 3x-ui может быть повреждена во время обновления системы или из-за ошибок в работе файловой системы. Проверить это можно с помощью команды:

Если файл отсутствует или его размер равен 0 байт, это confirms проблему.

Неправильные права доступа

Даже если файл существует, у него могут быть неправильные права доступа, что не позволяет его выполнить. Для проверки используйте:

Файл должен быть исполняемым скриптом. Если вы видите "cannot execute", значит проблема с правами.

Проблемы с работой сервиса

Хотя веб-интерфейс работает, сервис 3x-ui может быть в нерабочем состоянии. Это может произойти, если сервис был остановлен вручную или произошел сбой в его работе. Проверить статус сервиса можно командой:

Обратите внимание, что имя сервиса может быть x-ui.service, а не просто x-ui.

Отсутствие необходимых зависимостей

Для работы панели 3x-ui требуются определенные зависимости: bash, jq, curl, wget, openssl. Если какая-то из этих программ отсутствует или повреждена, команда x-ui может не работать. Проверить наличие этих пакетов можно командой:

Если какая-то программа отсутствует, установите ее. Например, для Ubuntu/Debian:

Проблемы с переменными окружения

Иногда проблемы могут быть связаны с переменными окружения. Попробуйте явно указать интерпретатор bash:

Конфликты файрвола

Хотя это обычно влияет на веб-интерфейс, в некоторых случаях файрвол может блокировать локальные подключения или работу с консолью. Проверьте настройки файрвола и попробуйте временно его отключить для теста:

Пошаговая диагностика и устранение проблемы

Давайте проведем пошаговую диагностику и устранение проблемы с командой x-ui. Следуйте этим инструкциям внимательно, так как некоторые команды требуют прав администратора.

Шаг 1: Проверка существования исполняемого файла

Сначала проверьте, существует ли исполняемый файл x-ui:

Если команда не возвращает путь к файлу, значит он отсутствует. В этом случае вам потребуется переустановить панель 3x-ui (см. раздел 5).

Если команда возвращает путь, например /usr/local/bin/x-ui, проверьте, существует ли файл:

Убедитесь, что размер файла не равен 0 байт.

Шаг 2: Проверка прав доступа к файлу

Проверьте права доступа к файлу:

Файл должен иметь права на исполнение для владельца. Если это не так, исправьте права:

Шаг 3: Проверка статуса сервиса

Проверьте статус сервиса 3x-ui:

Если сервис не активен, запустите его:

Также убедитесь, что сервис настроен на автозапуск при перезагрузке системы:

Шаг 4: Просмотр логов сервиса

Просмотрите последние 50 строк логов сервиса:

Или проверьте лог-файл панели:

Ищите ошибки в логах, которые могут указывать на причину проблемы.

Шаг 5: Попытка запуска с явным указанием пути

Попробуйте запустить панель, явно указав путь к исполняемому файлу:

Если это сработает, значит проблема была связана с путями в переменной окружения.

Шаг 6: Проверка и настройка файрвола

Если предыдущие шаги не помогли, проверьте настройки файрвола. Для UFW (Ubuntu):

Если файрвол активен, попробуйте временно его отключить:

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

Шаг 7: Проверка зависимостей

Убедитесь, что все необходимые зависимости установлены:

Если какая-то программа отсутствует, установите ее. Для Ubuntu/Debian:

Альтернативные способы доступа к панели 3x-ui

Если ни один из предыдущих методов не помог, вы можете использовать альтернативные способы доступа к панели 3x-ui.

SSH-туннелирование

SSH-туннелирование позволяет безопасно перенаправить локальный порт на удаленный сервер. Это полезно, когда прямое подключение к панели по SSH не работает, но веб-интерфейс доступен.
Создайте SSH-туннель в отдельном терминале:
После установки туннеля откройте веб-браузер и перейдите по адресу:

Вы получите доступ к панели 3x-ui через локальный порт, который перенаправляется через SSH на удаленный сервер.

Использование веб-интерфейса

Самый простой способ - использовать веб-интерфейс панели, который продолжает работать. Для этого:
Откройте веб-браузер
Перейдите по адресу: http://вашIPадрес:54321
Введите логин и пароль (обычно admin и admin по умолчанию)

Доступ через порт 54321 напрямую

Если у вас есть прямой доступ к порту 54321, вы можете использовать его для доступа к панели без SSH:

Использование прокси-сервера

Если прямой доступ к панели заблокирован, вы можете настроить прокси-сервер (например, Nginx) для перенаправления запросов на порт 54321.

Восстановление работоспособности панели 3x-ui: полная переустановка

Если ни один из предыдущих методов не помог, остается последний вариант - полная переустановка панели 3x-ui. Это более радикальный метод, но он часто решает проблемы, связанные с повреждением файлов или системными ошибками.

Шаг 1: Резервное копирование конфигурации

Перед переустановкой обязательно сделайте резервную копию конфигурации:

Это сохранит ваши настройки, серверы и пользователей.

Шаг 2: Остановка и удаление текущей установки

Остановите сервис:

Удалите панель:

Шаг 3: Установка заново

Установите панель 3x-ui заново:

Следуйте инструкциям установщика. Он автоматически настроит сервис и создаст необходимые файлы.

Шаг 4: Восстановление конфигурации

После установки восстановите конфигурацию из резервной копии:

Шаг 5: Проверка работы

Проверьте, что панель работает:

И попробуйте вызвать меню через SSH:

Если все прошло успешно, панель должна работать как раньше.

Шаг 6: Удаление резервной копии

После подтверждения, что панель работает корректно, удалите резервную копию:

Источники
3x-ui Configuration Guide — Подробные инструкции по настройке и устранению неполадок панели 3x-ui: https://github.com/MHSanaei/3x-ui/wiki/Configuration
Common Questions and Problems — Частые вопросы и проблемы с панелью 3x-ui и их решения: https://github.com/MHSanaei/3x-ui/wiki/Common-questions-and-problems
3x-ui Command Line Interface — Информация о доступе к панели через SSH и командную строку: https://deepwiki.com/MHSanaei/3x-ui/5.3-command-line-interface
Install 3x-ui on Ubuntu 22.04 — Полное руководство по установке и настройке панели 3x-ui: https://docs.edisglobal.com/advanced-setup-guides/install-3x-ui-on-vps/install-3x-ui-on-ubuntu-2204
3x-ui Documentation — Официальная документация по панели 3x-ui: https://docs.fastvps.hosting/apps/3x-ui/
3x-ui SSH Access — Информация о доступе к панели через SSH для обновления и настройки: https://hostkey.com/documentation/marketplace/security/3x_ui/

Заключение

Проблема с командой x-ui при работающем веб-интерфейсе панели 3x-ui может быть вызвана несколькими причинами: от отсутствия исполняемого файла до проблем с правами доступа. Для начинающих пользователей Linux рекомендуется начать с базовой проверки существования файла и его прав доступа, затем перейти к проверке статуса сервиса и просмотру логов. Если эти методы не помогают, можно попробовать альтернативные способы доступа, такие как SSH-туннелирование или использование веб-интерфейса. В крайнем случае, полная переустановка панели с резервным копированием конфигурации решит большинство проблем. Регулярное резервное копирование конфигурации и проверка работоспособности SSH-доступа помогут избежать подобных ситуаций в будущем.