Документация/Подключение/Своя панель/Если что-то не так·4 / 9
Если что-то не так
Начните с двух команд: sudo veli panel покажет состояние панели, sudo veli doctor на сервере узла — почему устройство не подключается.
Панель не открывается
sudo veli panel на её сервере покажет, работает ли она. Откройте порт 443, а с доменом — и 80 в брандмауэре хостера, если он у него свой.
Не выдался сертификат
Домен должен указывать на сервер панели, порт 80 — быть открыт. Последнюю ошибку покажет sudo veli panel. Без домена панель ставится по IP: --host.
Сервер не скачивает команду
Наш сайт из некоторых стран, например из России, может не открываться. Скачайте файл veli на компьютер, скопируйте на сервер — scp veli root@<адрес>:~ — и выполните строку без части с curl. Для узла по SSH — nodes add с --from и --node-from.
nodes add остановилась
Она называет причину словами, а сервер возвращает как был, поэтому повтор безопасен. Нужен root (--ssh root@адрес) и совпавший отпечаток: не совпал — адрес не тот. Скрипту отпечаток даётся заранее — --fingerprint.
Узел молчит или «ещё не отчитывался»
На сервере узла sudo veli panel покажет, когда ушёл последний отчёт. Узлу нужна связь с панелью по её адресу — проверьте curl -I https://panel.example.com и порт 443. Потом запустите ту же nodes add.
Клиент не видит новый узел
Узел приходит со следующим обновлением подписки — обновите её в приложении. Проверьте и группу клиента: узла в ней может не быть.
Потерян токен
Он показывается один раз. Отзовите его — sudo veli token revoke site — и выпустите новый.
Пропал клиент или узел
Верните панель из копии — sudo veli panel restore.
API
Частые ошибки API и вебхуков и что с ними делать.
400 name- Имя пустое, длиннее 40 знаков, с управляющими символами, вида c_ и 12 знаков или это слово API: bulk, find
400 taken- Такое имя уже есть
400 none- Клиента, узла или группы с таким именем нет
400 bad- Значение вне пределов, неизвестная группа или узел. field называет поле, max — предел
400 main- Главный узел мини-панели не отключается и не убирается
401 token- Токена нет, он отозван или истёк. Есть ли он ещё, покажет veli token list на сервере панели
403 rights- У токена нет таких прав: например, удалять клиентов может только «Всё». Права покажет GET me
404 none- Запрошено то, чего нет, или неизвестный вызов
409 idempotency- Этот Idempotency-Key уже был у другого запроса. Ключ — на одно действие: у продления и у заведения ключи разные
411 length- Тело без Content-Length (по частям, chunked) — отправьте его целиком
413 big- Тело запроса больше 1 МБ, max — предел. Разбейте изменение многих на части
429 wait- Больше 300 запросов в минуту по токену или десять неверных токенов с этого адреса за 15 минут. Подождите столько секунд, сколько в Retry-After
500 db- Панель не смогла записать изменения — повторите, с тем же ключом
На любой запрос — «не найдено»
Неверный адрес API: проверьте домен, секретный путь и /api/ — адрес API печатает veli token add вместе с токеном.
В браузере — ошибка CORS
Так и задумано: токен — для ваших серверов, страница в браузере панель не спросит. Пусть страница ходит на ваш сервер, а он — в панель.
Подпись не сходится
Почти всегда — тело уже разобрано и собрано заново. Берите сырые байты: в Express — express.raw, во Flask — request.get_data(). И проверьте, что секрет — этого вебхука: у вебхука, добавленного заново, секрет другой.
Событий нет совсем
Вебхука нет в veli webhook list, нужное событие не названо в --events — или панель не работает: это покажет sudo veli panel на её сервере.