Решение проблем
Бот не отвечает
docker compose ps # что вообще запущено
docker compose logs -f bot # что говорит бот
docker compose config # не сломан ли compose и .envЕсли контейнер перезапускается по кругу — смотрите первые строки логов, там будет причина: обычно не заполнена обязательная переменная.
Бот отвечает «отказано в доступе»
Ваш Telegram ID должен быть в ADMINS. Узнать его: @userinfobot. После правки .env нужен docker compose up -d, чтобы контейнер перечитал переменные.
Не работает связь с панелью Remnawave
API_BASE_URLиAPI_TOKEN— актуальны? Токен в панели можно перевыпустить- Сеть на месте:
docker network ls | grep remnawave-network - Если панель в другой сети или на другом сервере, адрес должен быть доступен из контейнера:
docker exec -it <бот> wget -qO- $API_BASE_URL/api/system/health
Потерян доступ к панели
Пароль сбрасывается CLI-утилитой — она ходит прямо в PostgreSQL и не требует работающей веб-панели.
# сгенерировать новый пароль
docker exec -it <контейнер> python3 scripts/admin_cli.py reset-password
# для конкретного администратора
docker exec -it <контейнер> python3 scripts/admin_cli.py reset-password --username myadmin
# со своим паролем
docker exec -it <контейнер> python3 scripts/admin_cli.py reset-password --password "MyNew$ecure1"
# завести нового суперадмина
docker exec -it <контейнер> python3 scripts/admin_cli.py create-superadmin --username newadmin
# посмотреть, кто вообще есть
docker exec -it <контейнер> python3 scripts/admin_cli.py list-adminsВход через Telegram не работает
TELEGRAM_BOT_USERNAME— без символа@- Домен панели прописан в BotFather:
/mybots→ бот → Bot Settings → Domain - Сайт открывается по HTTPS — виджет не работает по HTTP
Установка агента падает с 429:: command not found
GitHub ограничивает частоту скачиваний с raw.githubusercontent.com и на превышении отвечает 429 Too Many Requests. Если установщик запускали конвейером (curl … | bash), в интерпретатор попадал текст этой ошибки — отсюда странные строки вроде 429:: command not found и syntax error near unexpected token.
Команда из панели скачивает установщик в файл и проверяет результат, поэтому теперь такое не выполнится. Если скачать всё же не удалось, подождите минуту и повторите — лимит снимается сам.
Проверить, в лимите ли вы:
curl -sI https://raw.githubusercontent.com/Case211/remnawave-admin/main/node-agent/install.sh | head -1HTTP/2 200 — всё в порядке, HTTP/2 429 — лимит ещё держится.
Агент ноды не подключается
server rejected WebSocket connection: HTTP 404 — reverse proxy не пропускает /api/v2/agent/ws. Пример правильного конфига: Веб-панель и reverse proxy.
Прочие случаи разобраны в разделе Node Agent.
Не приходят уведомления от панели
Проверьте настройку webhook: чаще всего дело в несовпадении секретов или в https:// там, где нужен http://.
Ошибка подключения к базе
DATABASE_URL должен совпадать с POSTGRES_USER и POSTGRES_PASSWORD — это три разных места, где легко разъехаться. Проверьте также, поднялся ли контейнер базы: docker compose logs remnawave-admin-db.
Панель ругается на версию плагина
Плагин требует панель свежее, чем у вас. Обновите панель — как — либо поставьте версию плагина постарше.
Логи
Двухуровневые: файлы хранят всё, консоль — только предупреждения и ошибки.
| Файл | Уровень | Что внутри |
|---|---|---|
adminbot_INFO.log | INFO+ | вызовы API, синхронизация, действия |
adminbot_WARNING.log | WARNING+ | таймауты и ошибки |
web_INFO.log | INFO+ | веб-бэкенд |
web_WARNING.log | WARNING+ | проблемы веб-бэкенда |
Ротация: 50 МБ на файл, пять архивов в gzip. Лежат в ./logs/.
docker compose logs -f bot
tail -100 ./logs/adminbot_INFO.logУровень логирования, размер файлов и ротация меняются из настроек панели, без перезапуска.
Куда идти дальше
Если ничего из перечисленного не подошло — issues на GitHub или чат в Telegram. К вопросу сразу приложите версию панели, кусок логов и то, что уже пробовали: это экономит один круг переписки.