feat: add Minecraft proxy and refresh dependencies
This commit is contained in:
parent
a4d0880a0a
commit
cfaad47948
47 changed files with 2671 additions and 1005 deletions
28
docs/api.md
28
docs/api.md
|
|
@ -56,7 +56,7 @@ Authorization: Bearer <token>
|
|||
}
|
||||
```
|
||||
|
||||
Redis недоступен → пустой список.
|
||||
Если Redis недоступен, API возвращает `503 Service Unavailable`.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -68,13 +68,16 @@ Redis недоступен → пустой список.
|
|||
{
|
||||
"items": [
|
||||
{"target": "1.2.3.4", "type": "ip", "reason": "manual_ban",
|
||||
"created_at": "...", "expires_at": null}
|
||||
"created_at": "2026-10-16T12:00:00+00:00", "expires_at": "2026-10-16T13:00:00+00:00"}
|
||||
],
|
||||
"total": 42
|
||||
}
|
||||
```
|
||||
|
||||
Источник: Redis set `rampart:blacklist`. Пагинации и фильтров нет.
|
||||
Источник: Redis set `rampart:blacklist` и hash `rampart:blacklist:metadata`.
|
||||
Метаданные содержат причину, время создания и абсолютный срок истечения; API
|
||||
скрывает истёкшие записи. Старые set-записи без метаданных получают один
|
||||
ограниченный срок в пять минут при первом чтении или восстановлении edge.
|
||||
|
||||
### `POST /api/v1/blacklist` 🔒
|
||||
|
||||
|
|
@ -82,10 +85,24 @@ Redis недоступен → пустой список.
|
|||
// Request
|
||||
{"target": "1.2.3.4", "type": "ip", "reason": "manual_ban", "duration_secs": 3600}
|
||||
|
||||
// Response 200/201 — запись добавлена в Redis set
|
||||
// Response 200 — запись и метаданные атомарно сохранены в Redis, а событие
|
||||
// с duration_secs и expires_at_unix опубликовано в rampart:blacklist:events.
|
||||
```
|
||||
|
||||
Edge-ноды подхватывают ban при следующей синхронизации блэклиста.
|
||||
Edge подписывается на Pub/Sub перед загрузкой снимка из Redis. Поэтому события,
|
||||
пришедшие во время загрузки, будут применены после снимка. При старте и после
|
||||
переподключения активные Redis-баны восстанавливаются с оставшимся TTL; новые
|
||||
события используют абсолютный срок и игнорируются, если он уже прошёл. Старый
|
||||
формат события только с `duration_secs` продолжает поддерживаться.
|
||||
|
||||
### `DELETE /api/v1/blacklist` 🔒
|
||||
|
||||
```json
|
||||
{"target": "1.2.3.4"}
|
||||
```
|
||||
|
||||
Удаляет только Redis-бан и его метаданные, затем публикует событие unban.
|
||||
Локальные баны детекторов хранятся отдельно и этим запросом не снимаются.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -110,7 +127,6 @@ Edge-ноды подхватывают ban при следующей синхр
|
|||
|
||||
Честно, на текущий момент в API **нет**:
|
||||
|
||||
- удаления записей blacklist (только add/list);
|
||||
- drain нод через API (есть только CLI `rampart-cli drain`);
|
||||
- webhooks, metrics summary, challenge management;
|
||||
- регистрации нод через `POST /api/v1/nodes`;
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue