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

Переход на БД MySQL

Этот документ представляет собой руководство по настройке и запуску MySQL для использования с Marzban. Рассмотрены различные варианты настройки, включая MariaDB и Percona Server.

MySQL, Percona Server и MariaDB — три популярных системы управления базами данных (СУБД), основанные на открытом коде. Все они происходят от одного и того же исходного кода MySQL, но с течением времени развились в разные направления с уникальными особенностями.

Используемые файлы:

  • Директория/opt/marzban/
    • .env
    • docker-compose.yml

Предварительные требования

Прежде чем начать, убедитесь, что вы добавили себя в группу docker, чтобы избежать необходимости использования sudo при каждом вызове команд Docker:

Окно терминала
sudo addgroup $(whoami) docker

Шаги настройки

Шаг 1: Создание тома для данных MySQL

Окно терминала
docker volume create mysql

Шаг 2: Инициализация базы данных

Для инициализации базы данных необходимо запустить контейнер с MySQL, задав следующие переменные окружения:

ПеременнаяЗначениеОписание
MYSQL_ROOT_PASSWORDsuper-puper-passwordпароль для суперпользователя MySQL
MYSQL_USERmarzbanимя пользователя базы данных для Marzban
MYSQL_PASSWORDsuper-passwordпароль для пользователя базы данных
MYSQL_DATABASEmarzbanимя базы данных для Marzban
MYSQL_ROOT_HOST127.0.0.1адрес хоста, с которого разрешено подключение суперпользователя. Изменять не требуется.

Варианты запуска контейнера:

Рекомендуется использовать LTS версию MariaDB, и стабильные версии других СУБД

Ниже приведены примеры запуска контейнера для каждого из вариантов MySQL, MariaDB и Percona Server.

Окно терминала
docker run -d --rm --name mysql -v mysql:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=super-puper-password -e MYSQL_ROOT_HOST=127.0.0.1 -e MYSQL_DATABASE=marzban -e MYSQL_PASSWORD=super-password -e MYSQL_USER=marzban mysql:8.3 --character_set_server=utf8mb4 --collation_server=utf8mb4_unicode_ci --innodb-redo-log-capacity=134217728 --disable-log-bin --mysqlx=OFF

Шаг 3: Остановка контейнера

После инициализации базы данных контейнер необходимо остановить контейнер, использовав следующую команду, введя пароль суперпользователя по запросу:

Окно терминала
docker exec -it mysql mysqladmin shutdown -u root -p

Шаг 4: Интеграция

Для интеграции MySQL с приложением Marzban через docker-compose, необходимо добавить соответствующие сервисы в docker-compose.yml файл.

Окно терминала
sudo nano /opt/marzban/docker-compose.yml

Ниже приведены примеры конфигураций для каждого из вариантов MySQL, MariaDB и Percona Server.

services:
  marzban:
    image: gozargah/marzban:latest
    env_file: .env
    network_mode: host
    volumes:
      - /var/lib/marzban:/var/lib/marzban
    depends_on:
      - mysql
  mysql:
    image: mysql:8.3
    network_mode: host
    command:
      - --mysqlx=OFF
      - --bind-address=127.0.0.1
      - --character_set_server=utf8mb4
      - --collation_server=utf8mb4_unicode_ci
      - --disable-log-bin
      - --host-cache-size=0
      - --innodb-open-files=1024
      - --innodb-buffer-pool-size=268435456
    volumes:
      - mysql:/var/lib/mysql
volumes:
  mysql:
    external: true
    name: mysql

Здесь мы устанавливаем некоторые параметры, рассмотрим их немного подробнее:

ПараметрОписание
disable-log-binотключает бинарный лог, что может ускорить работу MySQL, так как уменьшается количество операций записи на диск. Важно отметить, что отключение бинарного лога может повлиять на возможности репликации и восстановления данных.
host-cache-size=0отключает кэширование информации о хостах, с которых поступают подключения. Это может ускорить MySQL, уменьшая задержку при новых соединениях, особенно в средах с большим количеством подключений
innodb-open-files=1024увеличивает количество файлов, которые InnoDB может открыть одновременно. Это позволяет более эффективно управлять параллелизмом, ускоряя обработку запросов, особенно при работе с большим количеством таблиц.
innodb-buffer-pool-size=268435456устанавливает размер буфера InnoDB в 256MB (по умолчанию 128MB). Увеличение этого параметра позволяет хранить больше данных и индексов в памяти, что существенно может ускорить чтение и запись, особенно для интенсивных операций. Однако стоит учитывать, что увеличение этого размера на системах с ограниченным объемом RAM может привести к проблемам с производительностью.

Шаг 5: Установка строки подключения к базе данных

В файле .env, необходимом для работы вашего приложения, следует указать строку подключения к базе данных, используя данные, заданные при инициализации контейнера:

Окно терминала
sudo nano /opt/marzban/.env

Перед заполнением строки подключения, убедитесь, что вы используете правильные учетные данные, заданные в шаге 2, при инициализации контейнера MySQL:

SQLALCHEMY_DATABASE_URL = "mysql+pymysql://<имя пользователя для базы Marzban>:<пароль пользователя для базы Marzban>@127.0.0.1:3306/<имя базы Marzban>"
ПеременнаяЗначениеОписание
MYSQL_USERmarzbanимя пользователя базы данных для Marzban
MYSQL_PASSWORDsuper-passwordпароль для пользователя базы данных
MYSQL_ROOT_HOST127.0.0.1адрес хоста
MYSQL_DATABASEmarzbanимя базы данных для Marzban

Эта строка позволит вашему приложению подключаться к базе данных MySQL, настроенной в Docker, обеспечивая безопасное и удобное управление данными.

Перезапускаем контейнер

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

Шаг 6: Перенос данных из SQLite в MySQL

Процедура переноса данных включает создание дампа данных из вашей старой базы данных SQLite, предоставление этого дампа контейнеру MySQL и, наконец, перенос данных из SQLite в MySQL. Ниже представлены шаги и команды для выполнения этих задач.

Создание дампа из старой базы SQLite:

Для выполнения дампа базы данных SQLite, нам потребуется пакет для работы с ней

Окно терминала
sudo apt install sqlite3

Создадим дамп с данными из вашей базы данных SQLite, используя следующую команду:

Окно терминала
sqlite3 /var/lib/marzban/db.sqlite3 '.dump --data-only' | sed "s/INSERT INTO \([^ ]*\)/REPLACE INTO \`\\1\`/g" > /tmp/dump.sql

Эта команда выполняет дамп данных из файла db.sqlite3, находящегося в каталоге /var/lib/marzban, конвертирует инструкции INSERT INTO в REPLACE INTO для обеспечения совместимости с MySQL и сохраняет результат в файл /tmp/dump.sql.

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

Далее, перенесите созданный дамп в контейнер MySQL с помощью команды:

Окно терминала
cd /opt/marzban && docker compose cp /tmp/dump.sql mysql:/dump.sql

Переходите в каталог вашего проекта Marzban /opt/marzban и используйте docker compose cp для копирования файла дампа в контейнер mysql.

Перенос данных из SQLite в MySQL:

Перед выполнением переноса данных, убедитесь, что вы используете правильные учетные данные, заданные в шаге 2, при инициализации контейнера MySQL:

ПеременнаяЗначениеОписание
MYSQL_USERmarzbanимя пользователя базы данных для Marzban
MYSQL_PASSWORDsuper-passwordпароль для пользователя базы данных
MYSQL_ROOT_HOST127.0.0.1адрес хоста
MYSQL_DATABASEmarzbanимя базы данных для Marzban

Теперь вы можете выполнить перенос данных, запустив следующую команду в контейнере MySQL:

Окно терминала
docker compose exec mysql mysql -u <имя пользователя для базы Marzban> -p<пароль пользователя для базы Marzban> -h 127.0.0.1 <имя базы Marzban> -e "SET FOREIGN_KEY_CHECKS = 0; SET NAMES utf8mb4; SOURCE /dump.sql;"

После выполнения команды начнется процесс переноса данных.