CreeperCLI (Крипер си эл ай)

Плагин для серверов Майнкрафт, который даёт администратору удалённый доступ к файлам, консоли и состоянию сервера через терминал на компьютере. Для работы нужен клиент Node.js, подключающийся к плагину по TCP.

Возможности

• Просмотр папок и содержимого файлов на сервере.
• Редактирование конфигов в локальном редакторе с загрузкой изменений после сохранения.
• Загрузка и скачивание файлов с проверкой контрольной суммы, двусторонняя синхронизация папок.
• Запуск разрешённых консольных команд, просмотр и фильтрация лога.
• Просмотр TPS, использования памяти и диска, времени работы и списка процессов.
• Отдельные сессии для нескольких серверов.
• Пароли хранятся в виде хеша; доступны двухфакторная аутентификация, ограничение частоты команд, привязка сессии к IP и журнал действий.

Команды

Серверные команды:

• /creepercli user add <name> <password> — создать пользователя.
• /creepercli user remove <name> — удалить пользователя.
• /creepercli user list — показать пользователей.
• /creepercli status — показать состояние плагина и заблокированные IP.
• /creepercli reload — перечитать конфиг.

Команды клиента:

• creepercli ls <path> — показать содержимое папки; creepercli cat <path> — открыть файл для просмотра.
• creepercli edit <path> — отредактировать файл; на время работы файл блокируется.
• creepercli cpush <local> <remote> и creepercli cpull <remote> <local> — загрузить или скачать файл.
• creepercli csync <remote> <local> — синхронизировать папки в обоих направлениях; ключ --yes отключает подтверждения.
• creepercli exec <command> — выполнить разрешённую команду консоли.
• creepercli log --grep <pattern> — следить за логом с фильтром.
• creepercli stats, creepercli tps, creepercli top — вывести показатели сервера.
• creepercli repl — открыть интерактивную оболочку с автодополнением и историей команд.
• creepercli passwd, creepercli totp setup, creepercli logout — сменить пароль, включить двухфакторную защиту или завершить сессию.

Настройка

Настройки находятся в plugins/CreeperCLI/config.yml. Ключ network.host задаёт адрес прослушивания, network.port — TCP-порт, auth.session-timeout-minutes — время простоя до завершения сессии, а sandbox.server-root ограничивает доступную клиенту папку сервера.

Список консольных команд для удалённого запуска задаётся в exec.allowlist; лимит команд одной сессии — в limits.commands-per-second. Доступ к файлам ограничен указанной папкой: переходы через .. и символические ссылки за её пределы отклоняются.

Требования

На сервер устанавливается плагин, а на компьютере администратора нужен Node.js и клиент creepercli. TCP-доступ предоставляет права администратора, включая работу с файлами и консолью; сервер рекомендуется запускать от непривилегированного системного пользователя. При подключении через SSH можно указать network.host как 127.0.0.1 и использовать SSH-туннель.