База данных и сеть

Конфигурация хранилища и межсерверной синхронизации находится в database.yml.

Режимы хранения

Параметр storage-mode определяет способ хранения лотов:

HYBRID: Активные лоты хранятся в оперативной памяти Redis (или Dragonfly/KeyDB/Valkey). История сделок, логи и статистика асинхронно записываются в SQL-базу данных.
SQL: Все данные (активные лоты и архив) хранятся исключительно в таблицах реляционной СУБД.

Драйверы баз данных

Параметр driver определяет используемую СУБД:

Драйвер	Применение
`mariadb`	Рекомендуется для большинства серверов и связок BungeeCord/Velocity.
`postgresql`	Альтернатива для крупных проектов с высокими требованиями к транзакциям.
`mysql`	Стандартная реляционная база данных.
`sqlite`	Локальный файл. Подходит только для одного сервера (не поддерживает сеть).

# Идентификатор сервера в сети
server-identifier: "anarchy-1"

# Главный сервер, выполняющий централизованную очистку просроченных предметов.
# В кластере флаг true должен стоять только на одном сервере.
is-head: true

Сетевая синхронизация

Синхронизация лотов между серверами кластера поддерживает следующие транспорты (в порядке приоритета):

direct-tcp — прямое бинарное TCP-соединение между серверами. Минимальная задержка без сторонних сервисов.
redis — публикация событий через Redis Pub/Sub.
bungee — передача сообщений через Plugin Messaging.
none — одиночный сервер без сети.

Настройка Direct TCP

Прямой сокет обеспечивает мгновенную передачу сетевых событий с авторизацией по HMAC-SHA256.

Несколько серверов на одном хосте

При размещении на одной машине используется локальный интерфейс 127.0.0.1:

Сервер 1
Сервер 2

direct-tcp:
  enabled: true
  bind-port: 9090
  nodes:
    - "127.0.0.1:9091"
  allowed-ips: []
  secret-key: "YourSecretKeyChangeMe"

direct-tcp:
  enabled: true
  bind-port: 9091
  nodes:
    - "127.0.0.1:9090"
  allowed-ips: []
  secret-key: "YourSecretKeyChangeMe"

Сервера на разных хостах

Например, Сервер 1 (10.0.0.1) и Сервер 2 (10.0.0.2):

Сервер 1 (10.0.0.1)
Сервер 2 (10.0.0.2)

direct-tcp:
  enabled: true
  bind-port: 9090
  nodes:
    - "10.0.0.2:9090"
  allowed-ips:
    - "10.0.0.2"
  secret-key: "YourSecretKeyChangeMe"

direct-tcp:
  enabled: true
  bind-port: 9090
  nodes:
    - "10.0.0.1:9090"
  allowed-ips:
    - "10.0.0.1"
  secret-key: "YourSecretKeyChangeMe"

Открывайте сокет-порт аукциона в фаерволе только для доверенных IP-адресов других серверов кластера:

# UFW:
sudo ufw allow from 10.0.0.2 to any port 9090 proto tcp

# iptables:
sudo iptables -A INPUT -p tcp -s 10.0.0.2 --dport 9090 -j ACCEPT

Настройка Redis

Используется для Pub/Sub синхронизации или в качестве кэша при storage-mode: HYBRID:

redis:
  enabled: true
  address: "127.0.0.1"
  port: 6379
  user: "default"
  password: "StrongPassword"
  timeout: 10000

Вместо классического Redis поддерживаются Dragonfly, KeyDB и Valkey.

Пул соединений

Параметры пула HikariCP:

pool:
  min_connections: 1
  max_connections: 10
  keepalive: 30 seconds
  timeout: 25 seconds
  idle_timeout: 5 minutes
  max_lifetime: 10 minutes

Резервное копирование

Автоматическое создание дампов базы данных с отправкой в Discord Webhook:

backup:
  enabled: true
  disable-plugin: false # Создавать бэкап при выключении сервера
  interval: 15          # Интервал создания в минутах
  cleanup:
    enabled: true
    keep-days: 7        # Срок хранения дампов в днях

  webhook:
    enabled: true
    url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"
    message: "📦 **Резервная копия базы данных**\nСервер: `{server}`"

Начало работы

Настройка

Основные разделы

Разработчикам

База данных и сеть

Режимы хранения

Драйверы баз данных

Сетевая синхронизация

Настройка Direct TCP

Несколько серверов на одном хосте

Сервера на разных хостах

Настройка Redis

Пул соединений

Резервное копирование

​Режимы хранения

​Драйверы баз данных

​Сетевая синхронизация

​Настройка Direct TCP

​Несколько серверов на одном хосте

​Сервера на разных хостах

​Настройка Redis

​Пул соединений

​Резервное копирование

Режимы хранения

Драйверы баз данных

Сетевая синхронизация

Настройка Direct TCP

Несколько серверов на одном хосте

Сервера на разных хостах

Настройка Redis

Пул соединений

Резервное копирование