Конфигурация
Файл задаётся при запуске: --config mirror.toml. Команды и сервисы из панели сохраняются в [web].state_file; относительный путь считается от каталога TOML. Если state-файл уже существует, топология загружается из него.
Подключение ForcAD
В начало TOML, перед секциями, добавьте IP своей команды. Затем добавьте секцию scoreboard:
main_team_ip = "192.0.2.10"
[scoreboard]
kind = "forcad"
url = "http://scoreboard.example:8080"
poll_interval_ms = 3000
stale_after_ms = 15000
Адрес замените на URL вашей игры. Имена команд и сервисов должны совпадать с scoreboard. После правки TOML перезапустите процесс. Настройки маршрутов из панели применяются сразу.
Подмена флагов — опционально
В настройках сервиса включается отдельно, по умолчанию выключена. Входящий флаг заменяется токеном той же длины; известный токен в ответе восстанавливается. Кеш хранится зашифрованным, ключ — только в окружении процесса.
[flags]
database = "data/flags.sqlite3"
key_env = "MIRROR_FLAG_KEY"
prefix = ""
alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
payload_length = 31
suffix = "="
ttl_seconds = 86400
max_entries = 10000
partial_timeout_ms = 5000
Ключ: 32 случайных байта в виде 64 hex-символов. Храните его отдельно от базы и используйте после рестарта. Без прежнего ключа кеш не откроется. TTL должен превышать срок жизни флагов и максимальную задержку ответов. Формат — буквальный prefix + payload из alphabet + буквальный suffix, не произвольный regex.
Подходит для открытого несжатого TCP с совместимым протоколом. Незаконченный возможный флаг удерживается до продолжения или EOF; по тайм-ауту соединение закрывается с ошибкой. Изменение длины, подписанные сообщения, TLS и сжатие не поддерживаются. Ответы восстанавливаются всем клиентам, поэтому это не защита от эксплуатации сервиса через прокси.
Управление маршрутами
Кружок выбирает primary, строка — реплику. Робот включает автоматический выбор из назначенных реплик. Новые соединения используют новый маршрут; открытые остаются на прежнем.
Название сервиса открывает настройки портов и режима реплик. При isolate медленная реплика отключается; при strict общий поток ждёт её.