Перейти к содержимому

Статья 68 из 141

Гайды

Marzban: частые ошибки и как их исправить

Установка панели: Marzban. Здесь разбираем, что ломается после установки.

Что Путь
Переменные окружения (.env) /opt/marzban/.env
docker-compose.yml /opt/marzban/docker-compose.yml
База данных, конфиг Xray, сертификаты /var/lib/marzban/

Почти любая проблема видна в логах:

Окно терминала
marzban logs

Статус и перезапуск:

Окно терминала
marzban status
marzban restart

По умолчанию 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
  1. Порт inbound закрыт. Откройте его в UFW: ufw allow 443/tcp. Порт смотрите в Core Settings.
  2. Порт занят. Если на 443 работает nginx, Xray не запустится. Проверка: ss -tulpn | grep ':443'.
  3. Ошибка в JSON Core Settings. Одна лишняя запятая — и Xray не стартует. В логах будет ошибка разбора конфигурации. Проверяйте JSON перед сохранением.
  4. Пользователь отключён. Истёк срок или закончился трафик: статус виден в списке пользователей.

Ссылка подписки строится из адреса, указанного в .env:

XRAY_SUBSCRIPTION_URL_PREFIX = "https://ваш_домен"

Если там пусто или старый адрес, клиенты получают неверную ссылку. После правки выполните marzban restart и попросите клиентов обновить подписку в приложении.

  1. На ноде запущен контейнер: docker ps.
  2. Сертификат из раздела Nodes панели скопирован на ноду полностью, без лишних пробелов.
  3. Порты ноды (по умолчанию 62050 и 62051) открыты в файрволе только для IP основной панели:
Окно терминала
ufw allow from IP_ПАНЕЛИ to any port 62050 proto tcp
ufw allow from IP_ПАНЕЛИ to any port 62051 proto tcp
  1. Время на обоих серверах синхронизировано: timedatectl.

Marzban работает в Docker и тяжелее, чем 3x-ui. На 1 ГБ RAM с несколькими десятками пользователей сервер может уходить в swap. Проверьте нагрузку:

Окно терминала
free -h
docker stats --no-stream

Если память стабильно занята больше чем на 85%, добавьте swap как временную меру или смените тариф.

Окно терминала
tar -czf /root/marzban-$(date +%F).tar.gz /var/lib/marzban /opt/marzban/.env

Скачайте архив к себе. Подробнее: бэкапы.