Частые вопросы (FAQ)

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

Установка и вход

Вопрос: какие условия нужны для установки панели?

Один Linux-сервер с публичным IP (рекомендуются Debian / Ubuntu / CentOS и другие популярные дистрибутивы); достаточно 512 МБ памяти для стабильной работы. На управляемых серверах ничего устанавливать не нужно — нужен только доступ по SSH.

Вопрос: какие логин и пароль по умолчанию?

Логин по умолчанию admin, пароль 123456. Сразу после первого входа смените их (значок пользователя в правом верхнем углу панели → настройки пользователя).

Вопрос: забыли пароль для входа — что делать?

Если пароль был изменён и забыт, его можно сбросить на сервере панели. Выполните команды, чтобы вернуть пароль по умолчанию (или задать новый):

# Перейдите в каталог установки панели и сбросьте пароль встроенным скриптом
cd /opt/ssh-everywhere
python3 -c "from app import reset_password; reset_password('<новый-пароль>')"

> Точное имя скрипта может меняться от версии к версии; также можно напрямую отредактировать таблицу users в базе данных data/ssheverywhere.db.

Вопрос: как изменить порт панели (5501)?

Измените Environment=PORT=5501 в сервисе systemd и перезагрузите его:

systemctl edit ssh-everywhere.service
# Добавьте или измените: Environment=PORT=ваш_порт
systemctl daemon-reload && systemctl restart ssh-everywhere.service

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

Вопрос: панель недоступна (порт 5501)?

Проверяйте по порядку:

1. Убедитесь, что сервис панели запущен: systemctl status ssh-everywhere.service

2. Проверьте, открыт ли порт 5501 в облачном брандмауэре или группе безопасности сервера панели (самая частая причина)

3. Убедитесь, что адрес доступа — http://публичный-IP-сервера:5501 (не https, если вы не настроили обратный прокси)

Всё о серверах

Вопрос: сервер отображается как «офлайн», что делать?

«Офлайн» лишь означает, что панель не может подключиться к нему по SSH, и не значит, что сервер упал. Проверяйте по порядку:

1. Убедитесь, что сервер вообще включён: посмотрите состояние питания в консоли провайдера

2. Проверьте доступность SSH-порта: с сервера панели выполните nc -zv <IP-цели> <порт> и посмотрите, отвечает ли порт

3. Проверьте брандмауэр и группу безопасности: открыт ли SSH-порт в облачном брандмауэре/группе безопасности целевого сервера

4. Для NAT-сервера проверьте проброс портов: существует ли ещё проброс портов, верен ли целевой внутренний IP

5. Проверьте белый список исходных IP: некоторые провайдеры ограничивают SSH-порт по исходному IP — нужно добавить IP сервера панели в белый список

6. Сверьте логин и пароль: правильно ли указаны имя пользователя, пароль или приватный ключ

Вопрос: при добавлении сервера не удаётся подключиться?

Убедитесь, что SSH-порт, имя пользователя и пароль верны
Убедитесь, что на целевом сервере работает sshd
Убедитесь, что брандмауэр пропускает SSH-порт
В облаках крупных провайдеров (Tencent Cloud / Alibaba Cloud) вход root по умолчанию запрещён — используйте обычного пользователя (например, ubuntu)

Вопрос: NAT-сервер (не на порту 22) не подключается?

Проброс портов NAT-сервера должен быть доступен из сети, в которой находится сервер панели. Частые причины:

Проброс портов перестал работать (проверьте или пересоздайте его в панели провайдера)
Провайдер ограничил исходные IP белым списком (добавьте IP сервера панели)
Неверно указаны целевой внутренний IP или порт проброса

Проброс и перенаправление портов

Вопрос: проброс портов показывает «офлайн»?

Проброс зависит от того, онлайн ли Agent. Когда Agent офлайн (устройство выключено, сеть пропала, Agent остановлен), проброс прерывается
После перезапуска сервиса панели проброс восстанавливается автоматически при переподключении Agent — просто подождите
Убедитесь, что в облачном брандмауэре сервера панели открыт порт прослушивания

Вопрос: перенаправление не на 22-й порт не действует?

Для перенаправления не-SSH порта (например, 9117) на туннельном сервере нужен Agent новой версии (старая версия поддерживает только 22). Достаточно переустановить Agent.

Вопрос: правило перенаправления портов создано, но не работает?

Традиционное перенаправление портов выполняется на самой машине, имеющей отдельный публичный IP. Проверьте:

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

2. Указан ли в качестве целевого IP реально доступный адрес

3. Не блокирует ли порт прослушивания группа безопасности облака

Вопрос: чем проброс портов отличается от перенаправления портов?

Проброс портов: для устройств без публичного IP, идёт через обратный туннель, публичный порт открывается на сервере панели.
Перенаправление портов: для серверов с публичным IP, идёт через DNAT системного брандмауэра, выполняется на самом целевом сервере.

Подробнее: Проброс портов и Перенаправление портов.

Docker / установка приложений

Вопрос: что делать, если установка из каталога приложений или Docker не удалась?

Панель честно показывает текст ошибки (не сообщает об успехе, которого не было). Частые причины:

1. Устаревший дистрибутив: такие версии, как Fedora 32, уже сняты с поддержки (EOL), репозитории не обновляются, установка завершится таймаутом или ошибкой. Рекомендуется обновить систему.

2. Сеть недоступна: официальный источник Docker (get.docker.com / download.docker.com) в некоторых сетях (например, на NAT-сервере в материковом Китае) может быть недоступен. В этом случае нужно настроить зеркало Docker или переключиться на зеркало Alibaba Cloud функцией «Смена зеркал».

3. Различия в именах пакетов: отдельные приложения (например, ufw, deb.nodesource для Node.js) зависят от конкретного дистрибутива и могут не установиться не на Debian/Ubuntu — в тексте ошибки это будет явно указано.

Вопрос: на сервере в материковом Китае образ Docker загружается очень медленно или с таймаутом?

Это проблема сети, а не панели. Рекомендуется настроить ускоритель зеркал Docker (публичные ускорители, например docker.1ms.run / docker.m.daocloud.io) или сначала выполнить на сервере:

# Для справки: настройка персонального ускорителя Alibaba Cloud (замените на адрес вашего ускорителя)
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{ "registry-mirrors": ["https://адрес-вашего-ускорителя"] }
EOF
sudo systemctl restart docker

Общие приёмы диагностики

1. Сначала проверьте, отвечает ли порт, и только потом логин с паролем: nc -zv <IP> <порт>

2. Сравните с другими серверами: если серверы того же типа подключаются, а этот нет — проблема в чём-то, что есть только у него (брандмауэр/проброс/белый список)

3. Смотрите логи: лог панели — service.log, логи проброса и Agent помогают локализовать проблемы подключения

Документация