docs: expand node plugins documentation

This commit is contained in:
kastov
2026-03-07 20:03:30 +03:00
parent 8c13e647e5
commit af14e4f61a

View File

@@ -153,6 +153,8 @@ table ip6 remnanode6 {
:::
Torrent Blocker это плагин, который блокирует IP-адрес, с которого был обнаружен Torrent-трафик.
### Конфигурация
```json
@@ -275,7 +277,7 @@ table ip6 remnanode6 {
<details>
<summary>Что придет в вебхуке (`torrent_blocker.report`)</summary>
Вебхук будет содержать полный объект уже знакомые нам объекты `node` и `user`, а так же объект `report`, который содержит всю доступную информацию.
Вебхук будет содержать полный объект уже знакомых нам объектов `node` и `user`, а так же объект `report`, который содержит всю доступную информацию.
```json
{
@@ -315,3 +317,93 @@ table ip6 remnanode6 {
```
</details>
## Blacklist
Blacklist это плагин, который перманентно блокирует IP-адрес, который находится в списке.
### Конфигурация
```json
"blacklist": {
"ip": [],
"enabled": false
}
```
| Field | Type | Description |
| --------- | ------- | ---------------------------------------------------------------------------------------------------------------- |
| `enabled` | boolean | Включает или выключает плагин, по умолчанию выключен |
| `ip` | array | Список IP-адресов, которые будут заблокированы плагином. Можно использовать списки из конфигурации Shared Lists. |
### Принцип работы
IP-адреса, указанные в списке будут заблокированы в `nftables`.
:::danger
Blacklist это очень опасный инструмент. Будьте внимательны и осторжожны при составлении списков.
:::
## Connection Drop
Connection Drop это не полноценный плагин, а небольшая надстройка для того, чтобы была возможность добавлять IP-адреса в whitelist для функционала Connection Drop.
Начиная с версии Remnawave Node **v2.6.0** и при включении директивы `cap_add: NET_ADMIN` Remnawave Node автоматически сбрасывает соединения при удалении пользователя из Xray-Core. В случае использования мостов это могло привести к тому, что мостовое соединение могло быть разорвано в результате работы этой функции.
Начиная с версии Remnawave Node **v2.7.0** вы можете включить whitelist для функционала Connection Drop.
:::note
Функции Connection Drop будут работать **всегда**, здесь настраиваться только включения или выключения белого списка для этого функционала.
:::
### Конфигурация
```json
"connectionDrop": {
"enabled": false,
"whitelistIps": []
}
```
| Field | Type | Description |
| -------------- | ------- | --------------------------------------------------------------------------------------- |
| `enabled` | boolean | Включает или выключает плагин, по умолчанию выключен |
| `whitelistIps` | array | Список IP-адресов, которые будут добавлены в whitelist для функционала Connection Drop. |
## Shared Lists
Shared Lists это список IP-адресов, которые могут быть использованы в других плагинах.
### Конфигурация
```json
"sharedLists": [
{
"name": "ext:my-list",
"type": "ipList",
"items": ["127.0.0.1", "127.0.0.2"]
}
]
```
| Field | Type | Description |
| ------- | ------ | -------------------------------------- |
| `name` | string | Имя списка, должно начинаться с `ext:` |
| `type` | string | Тип списка, должен быть `ipList` |
| `items` | array | Список IP-адресов |
Пример использования в конфигурации Torrent Blocker:
```json
"torrentBlocker": {
"enabled": false,
"ignoreLists": {
"ip": ["ext:my-list"]
},
"blockDuration": 3600
}
```