Плагин для серверов Майнкрафт, открывающий REST API для работы с разрешёнными файлами сервера. Через API можно читать, создавать, изменять и удалять файлы, а доступ защищён токеном и белым списком путей.
Возможности
- Чтение файлов и содержимого разрешённых каталогов.
- Создание и перезапись файлов через
PUT /files?path=<path>. - Удаление файлов через
DELETE /files?path=<path>. - Проверка доступности API через
GET /healthбез авторизации. - Пути нормализуются, выход через
..и символьные ссылки за пределы корневой папки сервера блокируются. - Токены хранятся в виде SHA-256-хешей, а максимальный размер файла можно ограничить.
Команды
/filed generate <name>— создать токен доступа. Команда требует прав оператора; токен показывается только один раз.
В запросах передавайте токен в заголовке Authorization в виде Bearer <token>.
Настройка
Настройки находятся в plugins/Filed/config.yml. Пути указываются относительно корневой папки сервера.
port— HTTP-порт API.maximum_allowed_file_size— предельный размер файла в байтах.auth_token_file— файл с хешами токенов.allowed.files— точные пути к доступным файлам.allowed.directories— доступные каталоги и их содержимое.
Для чтения используется GET /files?path=<path>&content=<true|false>; значение content=false исключает содержимое файлов из ответа.
