Статья 68 из 141
Гайды
Marzban: частые ошибки и как их исправить
Установка панели: Marzban. Здесь разбираем, что ломается после установки.
Где что лежит
Заголовок раздела «Где что лежит»| Что | Путь |
|---|---|
Переменные окружения (.env) |
/opt/marzban/.env |
docker-compose.yml |
/opt/marzban/docker-compose.yml |
| База данных, конфиг Xray, сертификаты | /var/lib/marzban/ |
Почти любая проблема видна в логах:
marzban logsСтатус и перезапуск:
marzban statusmarzban restartПанель не открывается по IP
Заголовок раздела «Панель не открывается по IP»По умолчанию Marzban отдаёт панель только на localhost, если не настроен SSL. Это сделано, чтобы пароль администратора не ходил по сети открытым текстом.
Есть два правильных способа открыть панель.
SSH-туннель (быстро, без домена). На своём компьютере:
ssh -L 8000:localhost:8000 root@IP_СЕРВЕРАИ откройте в браузере http://localhost:8000/dashboard/.
Домен и сертификат. Получите сертификат (Let’s Encrypt) и укажите пути в /opt/marzban/.env:
UVICORN_SSL_CERTFILE = "/var/lib/marzban/certs/fullchain.pem"UVICORN_SSL_KEYFILE = "/var/lib/marzban/certs/key.pem"После правки .env:
marzban restartСертификаты должны лежать внутри /var/lib/marzban/, потому что именно этот каталог доступен контейнеру.
Забыли пароль администратора
Заголовок раздела «Забыли пароль администратора»Создайте нового администратора с правами sudo:
marzban cli admin create --sudoСписок администраторов:
marzban cli admin listПользователи не подключаются
Заголовок раздела «Пользователи не подключаются»- Порт inbound закрыт. Откройте его в UFW:
ufw allow 443/tcp. Порт смотрите в Core Settings. - Порт занят. Если на 443 работает nginx, Xray не запустится. Проверка:
ss -tulpn | grep ':443'. - Ошибка в JSON Core Settings. Одна лишняя запятая — и Xray не стартует. В логах будет ошибка разбора конфигурации. Проверяйте JSON перед сохранением.
- Пользователь отключён. Истёк срок или закончился трафик: статус виден в списке пользователей.
Подписка не обновляется у клиентов
Заголовок раздела «Подписка не обновляется у клиентов»Ссылка подписки строится из адреса, указанного в .env:
XRAY_SUBSCRIPTION_URL_PREFIX = "https://ваш_домен"Если там пусто или старый адрес, клиенты получают неверную ссылку. После правки выполните marzban restart и попросите клиентов обновить подписку в приложении.
Нода не подключается
Заголовок раздела «Нода не подключается»- На ноде запущен контейнер:
docker ps. - Сертификат из раздела Nodes панели скопирован на ноду полностью, без лишних пробелов.
- Порты ноды (по умолчанию 62050 и 62051) открыты в файрволе только для IP основной панели:
ufw allow from IP_ПАНЕЛИ to any port 62050 proto tcpufw allow from IP_ПАНЕЛИ to any port 62051 proto tcp- Время на обоих серверах синхронизировано:
timedatectl.
Высокое потребление памяти
Заголовок раздела «Высокое потребление памяти»Marzban работает в Docker и тяжелее, чем 3x-ui. На 1 ГБ RAM с несколькими десятками пользователей сервер может уходить в swap. Проверьте нагрузку:
free -hdocker stats --no-streamЕсли память стабильно занята больше чем на 85%, добавьте swap как временную меру или смените тариф.
Бэкап перед любыми правками
Заголовок раздела «Бэкап перед любыми правками»tar -czf /root/marzban-$(date +%F).tar.gz /var/lib/marzban /opt/marzban/.envСкачайте архив к себе. Подробнее: бэкапы.