Как установить Marzban на VPS

Marzban (с персидского «пограничник») — это современная система управления прокси‑серверами на базе Xray‑core с удобным веб‑интерфейсом. Подходит для развёртывания V2Ray-прокси с множеством пользователей, с гибкими ограничениями по трафику и срокам.

Возможности Marzban

  • Web‑интерфейс на React
  • REST API бэкенд
  • Масштабируемость с несколькими узлами
  • Поддержка протоколов: VLESS, VMess, Trojan, Shadowsocks
  • Ограничения по трафику и сроку действия
  • Ссылки-подписки для V2RayNG, Clash, Nekoray и других
  • Автогенерация ссылок и QR-кодов
  • Мониторинг нагрузки и трафика
  • Поддержка TLS и REALITY
  • Встроенный Telegram-бот и CLI
  • Многоязычный интерфейс, поддержка нескольких администраторов (в процессе)

Подготовка

Перед установкой убедитесь, что вы подключились к серверу по SSH.

Если вы не знаете, как это сделать — воспользуйтесь нашей инструкцией: Как подключиться к серверу по SSH.

Установка Marzban

Выполните одну из команд в зависимости от нужной базы данных:

С SQLite (по умолчанию):

sudo bash -c "$(curl -sL https://github.com/Gozargah/Marzban-scripts/raw/master/marzban.sh)" @ installCode language: JavaScript (javascript)

С MySQL:

sudo bash -c "$(curl -sL https://github.com/Gozargah/Marzban-scripts/raw/master/marzban.sh)" @ install --database mysqlCode language: JavaScript (javascript)

С MariaDB:

sudo bash -c "$(curl -sL https://github.com/Gozargah/Marzban-scripts/raw/master/marzban.sh)" @ install --database mariadbCode language: JavaScript (javascript)

Что происходит после установки

  • Файлы панели будут расположены в /opt/marzban
  • Конфигурация — в /opt/marzban/.env
  • Файлы данных и сертификатов — в /var/lib/marzban
  • Логи появятся в терминале — можно остановить Ctrl+C

Как получить доступ к панели

По умолчанию Marzban не работает по IP — доступ возможен только через домен с SSL-сертификатом.

  • Пример адреса: https://yourdomain.com:8000/dashboard/
  • Замените yourdomain.com на ваш настоящий домен
  • Убедитесь, что порт 8000 открыт в firewall

Если у вас нет домена, можно временно использовать туннель по SSH:

ssh -L 8000:localhost:8000 user@your-server-ipCode language: CSS (css)

После этого в браузере откройте http://localhost:8000/dashboard/. Доступ будет работать, пока открыт SSH-сеанс.

Создание администратора

После установки создайте пользователя с правами администратора:

sudo marzban cli admin create --sudo

После этого можно авторизоваться в панели по логину и паролю.

Дополнительно

  • Справка по командам: marzban --help
  • Перезапуск панели: sudo marzban restart
  • Изменение конфигурации: nano /opt/marzban/.env

Вы также можете указать параметры HTTPS и настроить панель на стандартный порт 443, изменив переменные в .env:

UVICORN_SSL_CERTFILE="/var/lib/marzban/certs/fullchain.pem"
UVICORN_SSL_KEYFILE="/var/lib/marzban/certs/key.pem"
UVICORN_PORT=443Code language: JavaScript (javascript)