ServerConfigCleaner — защита конфигурационных файлов сервера

Опасность синхронизации конфигураций

И NeoForge, и MinecraftForge автоматически синхронизируют все содержимое server configs с клиентами. Проблема в том, что многие разработчики не до конца понимают эту особенность и иногда сохраняют в таких конфигурациях конфиденциальные данные — например, токены Discord-ботов или другие секретные значения. Это означает, что любой игрок, подключившийся к вашему серверу, может получить доступ к этим данным. Мод ServerConfigCleaner решает эту проблему, удаляя чувствительные значения перед отправкой конфигурации клиентам.

Совместимость с версиями Minecraft и загрузчиками

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

Как работает защита

Мод функционирует в два этапа:

Первый этап: обнаружение потенциально опасных настроек

Во время запуска ServerConfigCleaner анализирует все конфигурационные опции на предмет содержания потенциально опасной информации. Поскольку этот процесс основан на эвристических алгоритмах, обнаруженные настройки требуют ручной классификации в файле конфигурации config/serverconfigcleaner-common.toml:

• Ложные срабатывания: большинство обнаруженных опций являются безобидными настройками, которые просто совпали с шаблонами поиска. Например, параметр logistics.seatHostileMobs из мода Create может быть ошибочно идентифицирован как опасный из-за присутствия подстроки Host. Такие значения нужно добавлять в список falsePositives.

• Чувствительные настройки: реально опасные опции, содержащие конфиденциальные данные, должны быть добавлены в список doNotSync. Например: doNotSync = ["mymod:discord.token"].

Второй этап: фильтрация при синхронизации

На сервере мод перехватывает процесс синхронизации конфигураций. Если опция была помечена как конфиденциальная на первом этапе, её значение заменяется на значение по умолчанию перед отправкой клиентам. Поскольку для таких опций стандартное значение обычно представляет собой безобидную константу вроде INSERT BOT TOKEN HERE, это позволяет безопасно передавать структуру конфигурации без раскрытия секретных данных.

Важная информация

Мод поставляется с предустановленными списками известных проблем и безопасных опций, поэтому в большинстве случаев вам не потребуется выполнять дополнительные настройки вручную.