mirror of
https://github.com/telemt/telemt.git
synced 2026-11-22 07:16:38 +03:00
Config Apply + Pretty Params Descriptions in Docs
Co-Authored-By: brekotis <93345790+brekotis@users.noreply.github.com>
This commit is contained in:
@@ -1,5 +1,7 @@
|
||||
# Справочник параметров конфигурации Telemt
|
||||
|
||||
[English](CONFIG_PARAMS.en.md) · [Русский](CONFIG_PARAMS.ru.md) · [Deutsch](CONFIG_PARAMS.de.md) · [Terminology](../TERMINOLOGY.md)
|
||||
|
||||
В этом документе перечислены все ключи конфигурации, принимаемые `config.toml`.
|
||||
|
||||
> [!NOTE]
|
||||
@@ -10,7 +12,20 @@
|
||||
>
|
||||
> Параметры конфигурации, подробно описанные в этом документе, предназначены для опытных пользователей и для целей тонкой настройки. Изменение этих параметров без четкого понимания их функции может привести к нестабильности приложения или другому неожиданному поведению. Пожалуйста, действуйте осторожно и на свой страх и риск.
|
||||
|
||||
> `Hot-Reload` показывает, применяет ли config watcher изменение напрямую. `✘` означает, что watcher его не применяет; в зависимости от поля для полного эффекта требуется in-process reload runtime generation либо перезапуск процесса.
|
||||
## Применение изменений конфигурации
|
||||
|
||||
Столбец `Hot-Reload` описывает только автоматическое перечитывание файла: `✔` — новое значение может быть опубликовано, `✘` — сохраняется действующее значение. Команда `telemt reload` посылает SIGHUP тому же обработчику; новое поколение она не создаёт.
|
||||
|
||||
| Способ применения | Настройки и результат |
|
||||
| --- | --- |
|
||||
| Автоматически после изменения файла | Поля с `✔`, например `general.log_level`, `network.dns_overrides` и поддерживаемые лимиты пользователей. Применение асинхронное. В описании поля указано, затрагивает ли оно текущую работу или только новые соединения. |
|
||||
| Перезагрузка поколения | `[censorship]`, `[timeouts]`, `upstreams` и настройки API, принадлежащие поколению. Используйте `POST /v1/system/reload` или PATCH редактируемой конфигурации с `reload=instant` либо `reload=drain`. Дождитесь завершения операции. Сохранение действующих соединений зависит от выбранного режима. |
|
||||
| Перезапуск процесса | `logging`, `general.data_path`, `general.quota_state_path`, `general.disable_colors`, `general.direct_relay_buffer_budget_max_bytes`, `server.metrics_listen`, `server.metrics_port`, `server.max_connections`, `server.conntrack_control`, `server.listen_unix_sock`, `server.listen_unix_sock_perm`, поля API `enabled`/`listen`/`runtime_edge_events_capacity`, `web.limits`, `web.allow_wildcard_hosts` и `web.decoy_fasttrack_mode`. |
|
||||
| Зависит от изменения | Адрес нативного listener можно сменить только в рамках поддерживаемого плана перепривязки. WEB-listeners, параметры сокетов и доверия, а также правила ограничения SYN требуют перезапуска процесса. Изменения обучения и диагностики WEB могут откладываться, если требуют увеличения лимитов процесса. |
|
||||
|
||||
Для полей, доступных через API, `POST /v1/config/validate` до сохранения возвращает `apply.watcher_paths`, `apply.generation_paths` и `apply.process_restart_paths`. После изменения проверьте результат операции, `deferred_process_fields` и `GET /v1/config/state`. Старое поле `restart_required` означает, что изменение выходит за пределы автоматического перечитывания; само по себе оно не требует перезапуска процесса. См. [контракт перезагрузки API](../Architecture/API/API.md#runtime-reload-endpoints) и [команды Telemt](../CLI.ru.md).
|
||||
|
||||
У настроек WEB разные сроки действия: `carrier_method` и случайные задержки повторов закреплены за новыми страницами моста, `conveyor` согласуется для новых сессий, а лимиты процесса сохраняются до перезапуска. Политики существующих страниц и сессий описаны в [руководстве WEB](../WEB/WEB_PROXY.ru.md#lifecycle-и-reload).
|
||||
|
||||
# Содержание
|
||||
- [Ключи верхнего уровня](#ключи-верхнего-уровня)
|
||||
@@ -28,6 +43,7 @@
|
||||
- [web.debug](#webdebug)
|
||||
- [web.limits](#weblimits)
|
||||
- [web.limits.wildcard](#weblimitswildcard)
|
||||
- [web.retry_jitter](#webretry_jitter)
|
||||
- [web.timeouts](#webtimeouts)
|
||||
- [web.vhosts](#webvhosts)
|
||||
- [web.vhosts.decoy](#webvhostsdecoy)
|
||||
@@ -53,7 +69,7 @@
|
||||
| [`beobachten_file`](#beobachten_file) | `String` | `"cache/beobachten.txt"` | `✘` |
|
||||
|
||||
## include
|
||||
- **Ограничения / валидация**: значение должно быть одной строкой в виде `include = "path/to/file.toml"`. Значения параметра обрабатываются перед анализом TOML. Максимальное количество - 10.
|
||||
- **Ограничения / валидация**: значение должно быть одной строкой в виде `include = "path/to/file.toml"`. Значения параметра обрабатываются перед анализом TOML. Максимальная глубина вложенности включаемых файлов — 10.
|
||||
- **Описание**: Включает еще один файл TOML с помощью `include = "relative/or/absolute/path.toml"`; добавленные файлы обрабатываются рекурсивно.
|
||||
- **Пример**:
|
||||
|
||||
@@ -73,7 +89,7 @@
|
||||
# show_link = ["alice", "bob"]
|
||||
```
|
||||
## dc_overrides
|
||||
- **Ограничения / валидация**: значение должно быть положительным целым числом в формате строки (например, `"203"`). Значения разбираются как `SocketAddr` (`ip:port`). Пустые строки игнорируются.
|
||||
- **Ограничения / валидация**: ключ должен быть положительным индексом DC, записанным строкой (например, `"203"`). Значение — адрес или список адресов `SocketAddr` (`ip:port`). Пустые строки игнорируются.
|
||||
- **Описание**: Переопределяет DC эндпоинты для запросов с нестандартными DC; задается в виде строки с индексом DC, значение — один или несколько адресов `ip:port`.
|
||||
- **Пример**:
|
||||
|
||||
@@ -106,7 +122,7 @@
|
||||
|
||||
## logging.destination
|
||||
- **Ограничения / валидация**: Допустимы `stderr`, `syslog` или `file`. `syslog` поддерживается только на Unix. Для `file` требуется `logging.path`.
|
||||
- **Описание**: Выбирает runtime log destination. CLI-флаги имеют приоритет.
|
||||
- **Описание**: Определяет, куда Telemt записывает логи. Параметры командной строки имеют приоритет.
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
@@ -116,7 +132,7 @@
|
||||
```
|
||||
## logging.path
|
||||
- **Ограничения / валидация**: Обязателен при `logging.destination = "file"`; не может быть пустым.
|
||||
- **Описание**: Путь для файлового логирования. При time-based rotation имя файла используется как rolling prefix.
|
||||
- **Описание**: Путь для файлового логирования. При ротации по времени имя файла используется как префикс имён создаваемых файлов.
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
@@ -126,7 +142,7 @@
|
||||
```
|
||||
## logging.rotation
|
||||
- **Ограничения / валидация**: Допустимы `never`, `minutely`, `hourly`, `daily` или `weekly`.
|
||||
- **Описание**: Интервал time-based file rotation. `weekly` выполняет ротацию на границе воскресенья по UTC. `never` пишет точно в `logging.path`, если size rotation не включена.
|
||||
- **Описание**: Интервал ротации файлов по времени. `weekly` выполняет ротацию на границе воскресенья по UTC. `never` пишет точно в `logging.path`, если ротация по размеру выключена.
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
@@ -136,7 +152,7 @@
|
||||
rotation = "daily"
|
||||
```
|
||||
## logging.max_size_bytes
|
||||
- **Ограничения / валидация**: `0` отключает size rotation.
|
||||
- **Ограничения / валидация**: `0` отключает ротацию по размеру.
|
||||
- **Описание**: Ротирует непустой активный файл перед записью следующей целой записи, если она превысит этот предел в байтах.
|
||||
- **Пример**:
|
||||
|
||||
@@ -147,8 +163,8 @@
|
||||
max_size_bytes = 104857600
|
||||
```
|
||||
## logging.max_files
|
||||
- **Ограничения / валидация**: `0` отключает retention по количеству файлов.
|
||||
- **Описание**: Сохраняет не более указанного числа совпадающих log files, включая активный файл и архивы. Активный файл retention cleanup не удаляет.
|
||||
- **Ограничения / валидация**: `0` отключает ограничение числа сохраняемых файлов.
|
||||
- **Описание**: Сохраняет не более указанного числа файлов журнала, соответствующих настроенному имени, включая активный файл и архивы. Активный файл при очистке не удаляется.
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
@@ -159,8 +175,8 @@
|
||||
max_files = 14
|
||||
```
|
||||
## logging.max_age_secs
|
||||
- **Ограничения / валидация**: `0` отключает retention по возрасту.
|
||||
- **Описание**: Удаляет ротированные log files старше указанного числа секунд по времени изменения. Активный файл retention cleanup не удаляет.
|
||||
- **Ограничения / валидация**: `0` отключает удаление архивов по возрасту.
|
||||
- **Описание**: Удаляет архивные файлы журнала старше указанного числа секунд по времени изменения. Активный файл при очистке не удаляется.
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
@@ -410,7 +426,7 @@
|
||||
## proxy_config_v4_url
|
||||
- **Ограничения / валидация**: `String`. Если не указан, используется `"https://core.telegram.org/getProxyConfig"`.
|
||||
- **Описание**: Необязательный URL для получения `getProxyConfig` (IPv4). Telemt при всегда пытается выполнить новую загрузку с этого URL (и если не задан, использует `https://core.telegram.org/getProxyConfig`).
|
||||
- **Example**:
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
[general]
|
||||
@@ -428,7 +444,7 @@
|
||||
## proxy_config_v6_url
|
||||
- **Ограничения / валидация**: `String`. Если не указан, используется `"https://core.telegram.org/getProxyConfigV6"`.
|
||||
- **Описание**: Необязательный URL для получения `getProxyConfigV6` (IPv6). Telemt при всегда пытается выполнить новую загрузку с этого URL (и если не задан, использует `https://core.telegram.org/getProxyConfigV6`).
|
||||
- **Example**:
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
[general]
|
||||
@@ -1136,7 +1152,7 @@
|
||||
## me_route_backpressure_enabled
|
||||
- **Ограничения / валидация**: `bool`.
|
||||
- **Описание**: Включает адаптивные таймауты записи маршрута в зависимости от заполнения канала.
|
||||
- **Example**:
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
[general]
|
||||
@@ -1145,7 +1161,7 @@
|
||||
## me_route_fairshare_enabled
|
||||
- **Ограничения / валидация**: `bool`.
|
||||
- **Описание**: Включает справедливое распределение нагрузки маршрутизации между writer-потоками.
|
||||
- **Example**:
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
[general]
|
||||
@@ -1288,7 +1304,7 @@
|
||||
```
|
||||
## me_reinit_every_secs
|
||||
- **Ограничения / валидация**: Должно быть `> 0` (секунд).
|
||||
- **Описание**: Интервал для выполнения цикла повторной инициализации ME с нулевым временем простоя.
|
||||
- **Описание**: Интервал повторной инициализации ME. Сохранение соединений зависит от политики смены поколения и завершения старых соединений.
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
@@ -1961,7 +1977,7 @@
|
||||
## listen_backlog
|
||||
- **Ограничения / валидация**: `u32`. `0` использует системный backlog по умолчанию.
|
||||
- **Описание**: Значение backlog, передаваемое в `listen(2)` для TCP-сокетов.
|
||||
- **Example**:
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
[server]
|
||||
@@ -2282,7 +2298,7 @@ PATCH объекта server без конкретного редактируем
|
||||
## gray_action
|
||||
- **Ограничения / валидация**: `"drop"`, `"api"` или `"200"`.
|
||||
- **Описание**: Действует только для прямых TCP-клиентов вне `whitelist`: `"drop"` закрывает соединение без HTTP-ответа, `"api"` возвращает структурированный `403 forbidden`, а `"200"` — пустой `200 OK` с `text/html; charset=utf-8`. Этот параметр не разрешает доступ к API. Клиенты из whitelist по-прежнему проходят аутентификацию и проверку режима read-only; пустой ответ не является JSON-подтверждением успеха.
|
||||
- **Example**:
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
[server.api]
|
||||
@@ -2641,6 +2657,8 @@ WEB-режим переносит MTProxy-трафик Telegram Desktop внут
|
||||
| `enabled` | `bool` | `false` | `✔` |
|
||||
| `allow_wildcard_hosts` | `bool` | `false` | `✘` |
|
||||
| `carrier` | `"https"`, `"https-lanes"`, `"websocket"` или `"websocket-lanes"` | `"https"` | `✔` |
|
||||
| [`carrier_method`](#webcarrier_method) | `"post"`, `"put"` | `"post"` | `✔` |
|
||||
| [`conveyor`](#webconveyor) | `bool` | `true` | `✔` |
|
||||
| `carriers` | `false` или непустой массив уникальных carrier | `false` | `✔` |
|
||||
| `carrier_learning` | `bool` | `true` | `✔` |
|
||||
| `carrier_negotiation_aggressiveness` | `"conservative"`, `"balanced"` или `"aggressive"` | `"conservative"` | `✔` |
|
||||
@@ -2661,6 +2679,24 @@ WEB-режим переносит MTProxy-трафик Telegram Desktop внут
|
||||
|
||||
`carrier_learning` действует только при включённом auto-negotiation. Обучение локально для процесса, хранится в памяти, ограничено и учитывает только положительный результат: evidence добавляет лишь carrier, достигший определённого сервером состояния healthy. `conservative` требует наиболее широкой выборки и отключает ранжирование по IP, `balanced` использует умеренные пороги для User-Agent/профиля и допустимый публичный IP только для разрешения равенства, а `aggressive` реагирует на первые ограниченные samples. Сообщённые клиентом ошибки остаются только диагностикой и не создают отрицательный evidence. Reload применяет новую policy к новым цепочкам negotiation и инвалидирует несовместимый сохранённый evidence. Отключение WEB прекращает выдачу новых bridge- и session-credentials; для отзыва активных сессий отдельного пользователя используйте users API.
|
||||
|
||||
## web.carrier_method
|
||||
|
||||
Значение `"post"` (по умолчанию) или `"put"` выбирает HTTP-метод для `/api/v1/up` и `/api/v1/down` в новых страницах моста, включая повторы. Сервер принимает оба метода независимо от настройки. Создание сессии и диагностика используют `POST`, закрытие сессии — `DELETE`, WebSocket Upgrade — `GET`. TLS-терминатор должен пропускать `POST` и `PUT`. Вариант `put` позволяет переиспользовать соединения в реализациях Linux WebKitGTK, которые различают идемпотентные методы; влияние на задержку нужно измерять на целевом клиенте.
|
||||
|
||||
Настройка применяется при автоматическом перечитывании файла. Существующая страница сохраняет свой метод и при восстановлении сессии. Смена метода не заменяет учётные данные и не переносит активные сессии.
|
||||
|
||||
## web.conveyor
|
||||
|
||||
Значение `true` (по умолчанию) разрешает конвейерную отправку ограниченного числа HTTP-запросов для новых сессий `https` и `https-lanes`. Клиент явно предлагает окно от `1` до `4` через `X-Telemt-Up-Window`; сервер подтверждает его в ответе. При `false` или транспорте WebSocket явное предложение получает окно `1`. Клиент без этого заголовка продолжает последовательную отправку и не получает заголовок окна. Формат нативного `WELCOME` не меняется.
|
||||
|
||||
Согласованное окно позволяет отправить DATA до подтверждения OPEN, сохраняя порядок, точное повторение запросов, проверку подтверждений и бюджеты памяти. Автоматическое перечитывание меняет политику новых сессий; действующие сохраняют своё окно. Эта настройка независима от автоматического выбора транспорта.
|
||||
|
||||
```toml
|
||||
[web]
|
||||
carrier_method = "post"
|
||||
conveyor = true
|
||||
```
|
||||
|
||||
# [web.debug]
|
||||
|
||||
Эта hot-reloadable таблица управляет process-owned серверным WEB debug recorder, доступным на API-listener’е как аутентифицированный HTML по `GET /web-status`. Сбор по умолчанию отключён. Сохранённые и находящиеся в обработке записи ограничены значениями из `[web.limits]`, изменение которых требует перезапуска.
|
||||
@@ -2921,8 +2957,8 @@ bootstrap переживает reload только при сохранении
|
||||
```
|
||||
## client_first_byte_idle_secs
|
||||
- **Ограничения / валидация**: `u64` (секунды). `0` отключает проверку простоя до первого байта.
|
||||
- **Описание**: Максимальное время ожидания первого байта полезной нагрузки от клиента после установления сессии.
|
||||
- **Example**:
|
||||
- **Описание**: Максимальное ожидание первого байта клиента до разбора рукопожатия, после обязательного PROXY-заголовка, если он используется. Это отдельный предел от `client_handshake` и таймаутов простоя при передаче данных.
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
[timeouts]
|
||||
@@ -3063,11 +3099,11 @@ bootstrap переживает reload только при сохранении
|
||||
```
|
||||
## unknown_sni_action
|
||||
- **Ограничения / валидация**: `"drop"`, `"mask"`, `"accept"` или `"reject_handshake"`.
|
||||
- **Описание**: Действие для TLS ClientHello с неизвестным/ненастроенным SNI.
|
||||
- `drop` — закрыть соединение без ответа (молчаливый FIN после применения `server_hello_delay`). Поведение, неотличимое по таймингу от Success-ветки, но более «тихое», чем у обычного веб-сервера.
|
||||
- `mask` — прозрачно проксировать соединение на `mask_host:mask_port` (TLS-fronting). Клиент получает настоящий ServerHello от реального бэкенда с его сертификатом. Максимальный камуфляж, но порождает исходящее соединение на каждый чужой запрос.
|
||||
- `accept` — притвориться, что SNI валиден, и продолжить auth-путь. Снижает защиту от активного пробинга; осмысленно только в узких сценариях.
|
||||
- `reject_handshake` — отправить фатальный TLS-alert `unrecognized_name` (RFC 6066, AlertDescription = 112) и закрыть соединение. Поведение, идентичное современному nginx с `ssl_reject_handshake on;` на дефолтном vhost'е: на wire-уровне выглядит как обычный HTTPS-сервер, у которого просто нет такого домена. Рекомендуется, если цель — максимальная похожесть на стоковый веб-сервер, а не tls-fronting. `server_hello_delay` на эту ветку не применяется, чтобы alert улетал «мгновенно», как у эталонного nginx.
|
||||
- **Описание**: Политика для ClientHello с SNI, отсутствующим в `tls_domain` и `tls_domains`.
|
||||
- `drop` — закрыть соединение без ответа после настроенной задержки ServerHello. Это значение по умолчанию; совпадение задержки не доказывает неразличимость по времени ответа.
|
||||
- `mask` — использовать настроенный путь маскировки, если маскировка включена. Доступный TLS-сервер прикрытия может вернуть своё рукопожатие и сертификат; клиент при этом не проходит аутентификацию MTProxy.
|
||||
- `accept` — продолжить аутентификацию MTProxy, несмотря на неизвестный SNI. Допустимый набор имён расширяется, но корректные учётные данные по-прежнему обязательны. Для сохранения выбранных старых ссылок добавьте их домены в `tls_domains`.
|
||||
- `reject_handshake` — отправить фатальный TLS-alert `unrecognized_name` (RFC 6066, AlertDescription = 112) и закрыть соединение. Настроенная задержка ServerHello к этой ветке не применяется. Такой механизм отказа использует nginx с `ssl_reject_handshake on`; полная сетевая неразличимость из этого не следует.
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
@@ -3226,7 +3262,7 @@ bootstrap переживает reload только при сохранении
|
||||
## serverhello_compact
|
||||
- **Ограничения / валидация**: `bool`.
|
||||
- **Описание**: Включает компактный профиль ServerHello/Fake-TLS для снижения сигнатуры размера ответа.
|
||||
- **Example**:
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
[censorship]
|
||||
@@ -3320,7 +3356,7 @@ bootstrap переживает reload только при сохранении
|
||||
## mask_relay_timeout_ms
|
||||
- **Constraints / validation**: Должно быть больше или равно `mask_relay_idle_timeout_ms`.
|
||||
- **Description**: Жёсткий лимит по реальному времени (wall-clock) для полного маскирующего проксирования на fallback-путях без MTProto. Увеличивайте значение, если целевой сервис маскирования является долгоживущим (например, WebSocket-соединение). Значение по умолчанию: 60 000 мс (1 минута).
|
||||
- **Example**:
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
[censorship]
|
||||
@@ -3329,7 +3365,7 @@ bootstrap переживает reload только при сохранении
|
||||
## mask_relay_idle_timeout_ms
|
||||
- **Constraints / validation**: Должно быть меньше или равно `mask_relay_timeout_ms`.
|
||||
- **Description**: Тайм-аут простоя на каждую операцию чтения (per-read idle timeout) в маскирующем прокси и drain-пайплайнах. Ограничивает потребление ресурсов при атаках типа slow-loris и сканировании портов. Если операция чтения блокируется дольше заданного времени, соединение считается заброшенным и закрывается. Значение по умолчанию: 5 000 мс (5 с).
|
||||
- **Example**:
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
[censorship]
|
||||
@@ -3763,7 +3799,7 @@ bootstrap переживает reload только при сохранении
|
||||
## user_rate_limits
|
||||
- **Ограничения / валидация**: Таблица `username -> { up_bps, down_bps }`. Каждое направление должно быть в диапазоне `0..=100000000000`; `0` означает отсутствие лимита в этом направлении, при этом хотя бы одно направление должно быть ненулевым.
|
||||
- **Описание**: Персональные лимиты скорости по пользователям в битах/сек для отправки (`up_bps`) и получения (`down_bps`).
|
||||
- **Example**:
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
[access.user_rate_limits]
|
||||
@@ -3773,7 +3809,7 @@ bootstrap переживает reload только при сохранении
|
||||
- **API**: Поле доступно через `GET/PATCH /v1/access/policy`. Пропуск сохраняет значение; `null` для скаляра восстанавливает значение типа по умолчанию. Для `cidr_rate_limits` объект объединяется по ключам, запись со значением null удаляет правило, а `null` вместо всего объекта очищает правила. Объект скорости заменяет оба направления; единица — бит в секунду. Публикация идёт через watcher; ответ разделяет снимки `desired` и `effective`.
|
||||
- **Ограничения / валидация**: Таблица `CIDR или auto-template -> { up_bps, down_bps }`. Каждое направление должно быть в диапазоне `0..=100000000000`; `0` означает отсутствие лимита в этом направлении, при этом хотя бы одно направление должно быть ненулевым. Explicit CIDR-ключи должны корректно разбираться как `IpNetwork`; auto-template ключи должны иметь вид `*4/N` (`N=0..32`), `*6/N` (`N=0..128`) или `*/N` (`N=0..32`). Дублирующиеся нормализованные auto-template отклоняются.
|
||||
- **Описание**: Лимиты скорости для подсетей источников, применяются поверх пользовательских ограничений. Explicit CIDR-правила используют longest-prefix-wins и имеют приоритет над auto-template. Auto-template создают bucket’ы лениво по matched source subnet: `*4/N` для IPv4, `*6/N` для IPv6, а `*/N` является dual-stack shorthand, где IPv4 использует `/N`, а IPv6 — `/(N * 4)`.
|
||||
- **Example**:
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
[access.cidr_rate_limits]
|
||||
@@ -3842,6 +3878,9 @@ bootstrap переживает reload только при сохранении
|
||||
enabled = false
|
||||
```
|
||||
## scopes
|
||||
|
||||
См. [полный пример выбора апстрима по пользователю](../Advanced_settings/TUNING.ru.md#выбор-апстрима-по-имени-пользователя): формат имени, подмена учётных данных SOCKS и поведение при отсутствии подходящего маршрута.
|
||||
|
||||
- **Ограничения / валидация**: `String`. CСписок, разделенный запятыми; пробелы обрезаются во время сопоставления
|
||||
- **Описание**: Теги области (`scope`), используемые для фильтрации upstream-серверов на уровне запроса. Если в запросе указан `scope`, выбираются только те upstream’ы, у которых поле `scopes` содержит этот тег. Если scope в запросе не указан, допускаются только upstream’ы с пустым scopes.
|
||||
- **Пример**:
|
||||
|
||||
Reference in New Issue
Block a user