Вопросы и проблемы

Установка

Порт 80 или 443 занят nginx или Caddy

Установщик не остановится. Протоколы, чей порт занят, получат другие свободные порты. Если указан домен, установщик предложит добавить в nginx или Caddy правило для проверок Let’s Encrypt: конфиг сохраняется, проверяется и при ошибке возвращается. Если порт 80 держит другая программа, например Apache, сертификата Let’s Encrypt не будет, пока порт не освободится. Можно поставить свой сертификат.

Установщик не принимает домен

Он проверяет домен через публичный DNS. Частые причины: A-запись указывает на другой сервер, у домена есть лишняя A-запись или AAAA-запись на чужой адрес, или домен за прокси Cloudflare. Для панели переключите запись в Cloudflare в режим «DNS only» (серое облако).

Установка прервалась

Запустите mikan install ещё раз, она продолжится. Если админ уже создан, пароль установщик не знает: получите новый через mikan reset-password.

Доступ

Потерял ссылку, пароль или 2FA

На сервере: mikan url, mikan reset-password, mikan disable-2fa. Подробнее в разделе Первые шаги.

Браузер ругается на сертификат, Mini App не открывается

Панель работает с самоподписанным сертификатом, потому что не смогла получить Let’s Encrypt. Проверьте, что порт 80 открыт снаружи, в том числе в файрволе хостера, и нажмите «Запросить сейчас» в Настройки → Безопасность → Сертификат панели.

Подключения

Hysteria2 или TUIC не подключаются

Это протоколы на UDP. Некоторые хостеры и сети режут UDP целиком или на отдельных портах. Проверьте, что порт открыт по UDP в файрволе хостера, попробуйте другой порт или диапазон портов для Hysteria2, например 20000-30000. Держите рядом протокол на TCP, например VLESS XHTTP: группа «Авто» в приложении сама выберет работающий.

Приложение не видит протокол

Подписка отдаёт приложению только то, что оно умеет запускать. TUIC и AnyTLS не получат Happ и v2RayTun, а TrustTunnel, Mieru и другие новые протоколы получат только Clash-приложения со свежим ядром. Строка «Получают» в форме подключения показывает, кому оно уходит. См. таблицу.

Поменял порт, а клиенты не подключаются

Приложения обновляют подписку раз в час. Попросите обновить подписку вручную или подождите. Пока они не обновили, Clash-приложения переключаются на работающие подключения сами.

Устройство пишет, что места заняты

Включена привязка к устройствам, и лимит тарифа исчерпан. Отвяжите старое устройство в карточке пользователя, или подписчик сделает это сам на странице подписки или в боте (раз в сутки).

Автоподбор не переносит заблокированный порт

Он ждёт отрезанные устройства минимум из двух разных сетей и 30 минут подтверждения. Не работает для подключений за прокси, диапазонов портов Hysteria2 и протоколов с одним ключом. Подробнее в разделе Автоподбор.

Ноды

Нода в состоянии «Нет связи»

Панель не достучалась до порта API ноды. Проверьте, что нода запущена (mikan status на её сервере) и что порт API открыт в файрволе хостера для адреса панели. Если ключ мог потеряться, выдайте новый кнопкой «Новый ключ» и примите его на ноде командой mikan join.

WARP не проходит проверку

Окно WARP пишет причину. Чаще всего это «нет ответа по UDP»: хостер режет UDP до точки входа Cloudflare. Подключите свой конфиг WireGuard с другой точкой входа. Все причины в разделе WARP.

Обновления

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

Если новая версия поменяла схему базы и не поднялась, панель остаётся остановленной с сохранёнными данными, чтобы ничего не потерять. Запустите mikan update ещё раз. Бэкап перед обновлением лежит в /opt/mikan/backups, его путь есть в сообщении об ошибке.

Где смотреть логи

mikan logs panel и mikan logs node. Если ничего не помогло, откройте issue на GitHub с логами, уберите из них адреса и ключи.