Config Apply + Pretty Params Descriptions in Docs

Co-Authored-By: brekotis <93345790+brekotis@users.noreply.github.com>
This commit is contained in:
Alexey
2026-11-11 23:52:56 +03:00
parent 691051cad6
commit cec30d01e8
3 changed files with 167 additions and 50 deletions
+52 -13
View File
@@ -1,5 +1,7 @@
# Telemt-Referenz der Konfigurationsparameter
[English](CONFIG_PARAMS.en.md) · [Русский](CONFIG_PARAMS.ru.md) · [Deutsch](CONFIG_PARAMS.de.md) · [Terminology](../TERMINOLOGY.md)
Dieses Dokument listet alle Konfigurationsschlüssel auf, die `config.toml` akzeptiert.
> [!NOTE]
@@ -10,7 +12,20 @@ Dieses Dokument listet alle Konfigurationsschlüssel auf, die `config.toml` akze
>
> Die in diesem Dokument beschriebenen Konfigurationsparameter richten sich an erfahrene Nutzer und dienen dem Feintuning. Änderungen ohne klares Verständnis der jeweiligen Funktion können zu Instabilität oder anderem unerwarteten Verhalten führen. Gehen Sie entsprechend vorsichtig und auf eigenes Risiko vor.
> `Hot-Reload` zeigt an, ob der Config-Watcher einen geänderten Wert direkt übernimmt. `✘` bedeutet, dass der Watcher ihn nicht anwendet; je nach Feld ist für die vollständige Wirkung ein prozessinterner Runtime-Generation-Reload oder ein Prozessneustart erforderlich.
## Konfigurationsänderungen anwenden
`Hot-Reload` beschreibt nur die Dateiüberwachung: `✔` bedeutet, dass sie den neuen Wert übernehmen kann; bei `✘` bleibt der aktive Wert erhalten. `telemt reload` sendet SIGHUP an dieselbe Dateiüberwachung und erzeugt keine neue Laufzeitgeneration.
| Verfahren | Einstellungen und Wirkung |
| --- | --- |
| Automatisches Neuladen der Datei | Mit `✔` markierte Felder, etwa `general.log_level`, `network.dns_overrides` und unterstützte Benutzerlimits. Die Übernahme erfolgt asynchron. Die Feldbeschreibung erläutert, ob laufende Vorgänge oder nur neue Verbindungen betroffen sind. |
| Expliziter Generationswechsel | `[censorship]`, `[timeouts]`, `upstreams` und die von der Generation verwalteten API-Einstellungen. Verwenden Sie `POST /v1/system/reload` oder einen zulässigen Konfigurations-PATCH mit `reload=instant` bzw. `reload=drain`. Warten Sie auf den Abschluss der Operation. Ob bestehende Verbindungen erhalten bleiben, hängt vom Modus ab. |
| Prozessneustart | `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`, die API-Felder `enabled`/`listen`/`runtime_edge_events_capacity`, `web.limits`, `web.allow_wildcard_hosts` und `web.decoy_fasttrack_mode`. |
| Bedingt anwendbar | Adressänderungen nativer Listener sind nur im unterstützten Rebind-Verfahren möglich. WEB-Listener, Socket- und Vertrauensregeln sowie SYN-Regeln erfordern einen Prozessneustart. WEB-Lern- und Diagnoseeinstellungen können zurückgestellt werden, wenn sie größere Prozesslimits voraussetzen. |
Für über die API bearbeitbare Felder zeigt `POST /v1/config/validate` vor dem Speichern `apply.watcher_paths`, `apply.generation_paths` und `apply.process_restart_paths`. Prüfen Sie danach das Operationsergebnis, `deferred_process_fields` und `GET /v1/config/state`. Das ältere Feld `restart_required` bedeutet, dass die Änderung außerhalb der Dateiüberwachung liegt; daraus folgt allein noch kein Prozessneustart. Siehe [API-Vertrag zum Neuladen](../Architecture/API/API.md#runtime-reload-endpoints) und [CLI-Referenz](../CLI.de.md).
WEB-Einstellungen haben unterschiedliche Lebensdauern: `carrier_method` und Retry-Jitter gelten für neu erzeugte Bridge-Seiten, `conveyor` wird für neue Sitzungen ausgehandelt, und Prozesslimits bleiben bis zum Neustart fest. Bestehende Seiten und Sitzungen behalten die im [WEB-Leitfaden](../WEB/WEB_PROXY.de.md) beschriebenen Regeln.
# Inhaltsverzeichnis
- [Schlüssel auf oberster Ebene](#schlüssel-auf-oberster-ebene)
@@ -28,6 +43,7 @@ Dieses Dokument listet alle Konfigurationsschlüssel auf, die `config.toml` akze
- [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)
@@ -42,7 +58,7 @@ Dieses Dokument listet alle Konfigurationsschlüssel auf, die `config.toml` akze
| Schlüssel | Typ | Default | Hot-Reload |
| --- | --- | --- | --- |
| [`include`](#include) | `String` (Proberdirektive) | — | `✔` |
| [`include`](#include) | `String` (Include-Anweisung) | — | `✔` |
| [`show_link`](#show_link) | `"*"` oder `String[]` | `[]` (`ShowLink::None`) | `✘` |
| [`logging`](#logging) | Tabelle | Default-Werte | `✘` |
| [`dc_overrides`](#dc_overrides) | `Map<String, String or String[]>` | `{}` | `✘` |
@@ -106,7 +122,7 @@ Dieses Dokument listet alle Konfigurationsschlüssel auf, die `config.toml` akze
## logging.destination
- **Einschränkungen / Validierung**: Muss `stderr`, `syslog` oder `file` sein. `syslog` wird nur auf Unix-Plattformen unterstützt. `file` erfordert `logging.path`.
- **Beschreibung**: Wählt das Runtime-Log-Ziel aus. CLI-Flags überschreiben diesen Wert.
- **Beschreibung**: Legt fest, wohin Telemt Protokollmeldungen schreibt. Kommandozeilenoptionen haben Vorrang.
- **Beispiel**:
```toml
@@ -116,7 +132,7 @@ Dieses Dokument listet alle Konfigurationsschlüssel auf, die `config.toml` akze
```
## logging.path
- **Einschränkungen / Validierung**: Erforderlich, wenn `logging.destination = "file"`; darf nicht leer sein.
- **Beschreibung**: Dateipfad, der für die File-Logging verwendet wird. Bei der Zeitrotation wird der Dateiname als rollierendes Präfix verwendet.
- **Beschreibung**: Pfad für die Protokolldatei. Bei zeitgesteuerter Rotation dient der Dateiname als Präfix der erzeugten Dateien.
- **Beispiel**:
```toml
@@ -2638,6 +2654,8 @@ Der WEB-Modus transportiert MTProxy-Datenverkehr von Telegram Desktop über HTTP
| `enabled` | `bool` | `false` | `✔` |
| `allow_wildcard_hosts` | `bool` | `false` | `✘` |
| `carrier` | `"https"`, `"https-lanes"`, `"websocket"` oder `"websocket-lanes"` | `"https"` | `✔` |
| [`carrier_method`](#webcarrier_method) | `"post"`, `"put"` | `"post"` | `✔` |
| [`conveyor`](#webconveyor) | `bool` | `true` | `✔` |
| `carriers` | `false` oder ein nicht leeres Array eindeutiger Carrier | `false` | `✔` |
| `carrier_learning` | `bool` | `true` | `✔` |
| `carrier_negotiation_aggressiveness` | `"conservative"`, `"balanced"` oder `"aggressive"` | `"conservative"` | `✔` |
@@ -2658,6 +2676,24 @@ Fehlt `carriers` oder ist es `false`, sind Auto-Negotiation und Lernen deaktivie
`carrier_learning` wirkt nur bei aktivierter Negotiation. Das Lernen ist prozesslokal, speicherresident, begrenzt und ausschließlich positiv: Nur ein Carrier, der den serverdefinierten Zustand healthy erreicht, liefert Evidenz. `conservative` erfordert die breiteste Evidenz und deaktiviert IP-Ranking, `balanced` verwendet mittlere User-Agent-/Profil-Schwellen sowie geeignete öffentliche IPs nur als Tie-Breaker, und `aggressive` reagiert auf die ersten begrenzten Samples. Vom Client gemeldete Fehler bleiben rein diagnostisch und erzeugen keine negative Evidenz. Ein Reload wendet die Richtlinie auf neue Negotiation-Ketten an und verwirft inkompatible gespeicherte Evidenz. Das Deaktivieren von WEB beendet die Ausgabe neuer Bridge- und Session-Zugangsdaten; zum Widerrufen aktiver Sitzungen eines einzelnen Benutzers verwenden Sie die Users-API.
## web.carrier_method
`"post"` (Standard) oder `"put"` bestimmt die HTTP-Methode neu erzeugter Bridge-Seiten für `/api/v1/up` und `/api/v1/down`, einschließlich Wiederholungen. Der Server akzeptiert unabhängig davon beide Methoden. Sitzungserstellung und Diagnose verwenden weiterhin `POST`, das Schließen einer Sitzung `DELETE` und WebSocket Upgrade `GET`. Der TLS-Terminator muss `POST` und `PUT` durchlassen. `put` ermöglicht die Wiederverwendung von Verbindungen in Linux-WebKitGTK-Implementierungen, die idempotente Methoden unterscheiden; eine geringere Latenz muss am jeweiligen Client gemessen werden.
Die Dateiüberwachung übernimmt diese Einstellung. Bestehende Seiten behalten ihre Methode auch bei der Wiederherstellung einer Sitzung. Zugangsdaten werden dadurch nicht rotiert und aktive Sitzungen nicht verschoben.
## web.conveyor
`true` (Standard) erlaubt HTTP-Uplink-Pipelining mit einem begrenzten Fenster für neue `https`- und `https-lanes`-Sitzungen. Der Client bietet über `X-Telemt-Up-Window` ausdrücklich einen Wert von `1` bis `4` an; der Server bestätigt das Fenster. Bei `false` oder einem WebSocket-Transport wird ein ausdrückliches Angebot mit Fenster `1` beantwortet. Ohne diesen Header bleiben Anfragen sequenziell, und die Antwort enthält keinen Fenster-Header. Das native `WELCOME`-Format bleibt unverändert.
Das ausgehandelte Fenster erlaubt DATA vor der OPEN-Bestätigung. Reihenfolge, identische Wiederholungen, Bestätigungsprüfungen und Speicherbudgets bleiben erhalten. Die Dateiüberwachung ändert die Regel für neue Sitzungen; bestehende Sitzungen behalten ihr Fenster. Diese Einstellung ist unabhängig von der automatischen Transportauswahl.
```toml
[web]
carrier_method = "post"
conveyor = true
```
# [web.debug]
Diese hot-reload-fähige Tabelle steuert den prozesseigenen serverseitigen WEB-Debug-Recorder, der am API-Listener als authentifiziertes HTML unter `GET /web-status` bereitgestellt wird. Die Erfassung ist standardmäßig deaktiviert. Gespeicherte und in Verarbeitung befindliche Datensätze bleiben durch die nur nach einem Neustart änderbaren Werte in `[web.limits]` begrenzt.
@@ -2918,8 +2954,8 @@ Vor dem Hinzufügen von Mustern über die API muss `web.allow_wildcard_hosts` im
client_handshake = 30
```
## client_first_byte_idle_secs
- **Einschränkungen / Validierung**: `u64` (Sekunden). `0` deaktiviert die Erzwingung des Leerlaufs im ersten Byte.
- **Beschreibung**: Maximale Leerlaufzeit zum Warten auf das erste Client-Payloadbyte nach dem Sitzungsaufbau.
- **Einschränkungen / Validierung**: `u64` (Sekunden). `0` deaktiviert das Zeitlimit für das Warten auf das erste Client-Byte.
- **Beschreibung**: Maximale Wartezeit auf das erste Client-Byte vor der Verarbeitung des Handshakes, nach einem gegebenenfalls erforderlichen PROXY-Header. Dieses Limit ist von `client_handshake` und den Leerlaufzeiten der Datenübertragung getrennt.
- **Beispiel**:
```toml
@@ -3043,7 +3079,7 @@ Vor dem Hinzufügen von Mustern über die API muss `web.allow_wildcard_hosts` im
## tls_domain
- **Einschränkungen / Validierung**: Muss ein nicht leerer Domainname sein. Darf keine Leerzeichen und kein `/` enthalten.
- **Beschreibung**: Primäre Domäne, die für das Fake-TLS-Masking-/Fronting-Profil verwendet wird und als Standard-SNI-Domäne für Clients angezeigt wird.
Dieser Wert wird Teil der generierten `ee`-Links; eine Änderung macht zuvor generierte Links ungültig.
Dieser Wert wird Teil der erzeugten `ee`-Links. Um alte Links bei einem Domainwechsel zu erhalten, behalten Sie die bisherige Domain in `tls_domains` und wenden Sie die Konfiguration an.
- **Beispiel**:
```toml
@@ -3062,11 +3098,11 @@ Vor dem Hinzufügen von Mustern über die API muss `web.allow_wildcard_hosts` im
```
## unknown_sni_action
- **Einschränkungen / Validierung**: `"drop"`, `"mask"`, `"accept"` oder `"reject_handshake"`.
- **Beschreibung**: Aktion für TLS ClientHello mit unbekanntem/nicht konfiguriertem SNI.
- `drop` — schließt die Verbindung ohne Antwort (stilles FIN nach Anwendung von `server_hello_delay`). Timing-identisch zum Success-Zweig, aber auf dem Wire leiser als ein echter Webserver.
- `mask` — proxyt die Verbindung transparent zu `mask_host:mask_port` (TLS-Fronting). Der Client erhält ein echtes ServerHello vom Backend mit dessen echtem Zertifikat. Maximale Tarnung, öffnet aber für jede fehlgeleitete Anfrage eine ausgehende Verbindung.
- `accept` — behandelt SNI so, als wäre es gültig, und fährt im Auth-Pfad fort. Schwächt die Resistenz gegen aktives Probing; nur in engen Szenarien sinnvoll.
- `reject_handshake` — sendet einen fatalen TLS-Alert `unrecognized_name` (RFC 6066, AlertDescription = 112) und schließt die Verbindung. Auf dem Wire identisch zu einem modernen nginx mit `ssl_reject_handshake on;` im Default-vhost: wirkt wie ein gewöhnlicher HTTPS-Server, der den angefragten Namen schlicht nicht hostet. Empfohlen, wenn maximale Parität mit einem Standard-Webserver wichtiger ist als TLS-Fronting. `server_hello_delay` wird absichtlich **nicht** auf diesen Zweig angewendet, sodass der Alert wie bei Referenz-nginx „sofort“ gesendet wird.
- **Beschreibung**: Regel für ein ClientHello, dessen SNI weder in `tls_domain` noch in `tls_domains` enthalten ist.
- `drop` — Verbindung nach der konfigurierten ServerHello-Verzögerung ohne Antwort schließen. Dies ist der Standard; eine gleiche Verzögerung belegt keine zeitliche Ununterscheidbarkeit.
- `mask` — den konfigurierten Masking-Pfad verwenden, sofern Masking aktiviert ist. Ein erreichbarer TLS-Zielserver kann seinen eigenen Handshake und sein Zertifikat liefern; der Client wird dabei nicht für MTProxy authentifiziert.
- `accept` — MTProxy-Authentifizierung trotz unbekanntem SNI fortsetzen. Damit werden mehr Namen zugelassen; gültige Zugangsdaten bleiben erforderlich. Um bestimmte alte Links zu erhalten, tragen Sie deren Domains in `tls_domains` ein.
- `reject_handshake` — einen fatalen TLS-Alert `unrecognized_name` (RFC 6066, AlertDescription = 112) senden und schließen. Die ServerHello-Verzögerung wird hier nicht angewendet. Dieser Ablehnungsmechanismus wird auch von nginx mit `ssl_reject_handshake on` verwendet; vollständige Ununterscheidbarkeit im Netz ist damit nicht belegt.
- **Beispiel**:
```toml
@@ -3148,7 +3184,7 @@ Vor dem Hinzufügen von Mustern über die API muss `web.allow_wildcard_hosts` im
- Darf nicht leer sein, wenn gesetzt.
- Nur Unix; auf Nicht-Unix-Plattformen abgelehnt.
- Auf Unix muss der Pfad \(\le 107\) Bytes lang sein.
- Mutually exclusive mit `mask_host`.
- Kann nicht zusammen mit `mask_host` verwendet werden.
- **Beschreibung**: Unix-Socket-Pfad für das Mask-Backend statt TCP `mask_host`/`mask_port`.
- **Beispiel**:
@@ -3839,6 +3875,9 @@ Wenn Backend oder Netzwerk stark bandbreitenbeschränkt sind, reduzieren Sie zue
enabled = false
```
## scopes
Das [vollständige Direct-Beispiel](../Advanced_settings/TUNING.de.md#upstream-anhand-des-benutzernamens-auswählen) erläutert Benutzernamen, den Ersatz von SOCKS-Zugangsdaten und das Verhalten ohne passenden Upstream.
- **Einschränkungen / Validierung**: `String`. Durch Kommas getrennte Liste; Leerzeichen werden beim Abgleich entfernt.
- **Beschreibung**: Scope-Tags, die für die Upstream-Filterung auf Anfrageebene verwendet werden. Wenn eine Anfrage einen Bereich angibt, können nur Upstreams ausgewählt werden, deren `scopes` dieses Tag enthält. Wenn eine Anfrage keinen Bereich angibt, sind nur Upstreams mit leerem `scopes` berechtigt.
- **Beispiel**:
+46 -7
View File
@@ -1,5 +1,7 @@
# Telemt Config Parameters Reference
[English](CONFIG_PARAMS.en.md) · [Русский](CONFIG_PARAMS.ru.md) · [Deutsch](CONFIG_PARAMS.de.md) · [Terminology](../TERMINOLOGY.md)
This document lists all configuration keys accepted by `config.toml`.
> [!NOTE]
@@ -10,7 +12,20 @@ This document lists all configuration keys accepted by `config.toml`.
>
> The configuration parameters detailed in this document are intended for advanced users and fine-tuning purposes. Modifying these settings without a clear understanding of their function may lead to application instability or other unexpected behavior. Please proceed with caution and at your own risk.
> `Hot-Reload` marks whether a changed value is applied directly by the config watcher. `✘` means the watcher does not apply it; depending on the field, full effect requires an in-process runtime-generation reload or a process restart.
## Applying configuration changes
`Hot-Reload` describes the file watcher only: `✔` means it can publish the setting, `✘` means it retains the active value. `telemt reload` sends SIGHUP to this same watcher; it does not create a runtime generation.
| Application path | Settings and effect |
| --- | --- |
| Automatic file reload | Fields marked `✔`; examples include `general.log_level`, `network.dns_overrides` and supported user limits. Publication is asynchronous. Each field's description determines whether existing work or only new connections see it. |
| Explicit generation reload | `[censorship]`, `[timeouts]`, `upstreams` and generation-owned API settings. Use `POST /v1/system/reload` or an editable config PATCH with `reload=instant` or `reload=drain`. Follow the returned operation to completion. Connection survival depends on the selected mode. |
| Process restart | `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`, and `web.decoy_fasttrack_mode`. |
| Conditional | Native listener address changes can use only the supported rebind plan; WEB listeners, listener socket/trust policy and SYN rules require process restart. WEB learning/debug changes depending on larger process limits can also be deferred. |
For API-editable fields, `POST /v1/config/validate` reports `apply.watcher_paths`, `apply.generation_paths` and `apply.process_restart_paths` before saving. After an update, inspect the reload result, `deferred_process_fields` and `GET /v1/config/state`. The legacy `restart_required` flag means “outside the watcher subset”; it does not by itself require a process restart. See the [API reload contract](../Architecture/API/API.md#runtime-reload-endpoints) and [CLI reference](../CLI.en.md).
WEB settings have separate lifetimes: `carrier_method` and retry jitter belong to newly rendered bridge pages, `conveyor` is negotiated for new sessions, and process limits stay fixed until restart. Existing pages and sessions retain the policies described in the [WEB guide](../WEB/WEB_PROXY.en.md#lifecycle-and-reload-behavior).
# Table of contents
- [Top-level keys](#top-level-keys)
@@ -28,6 +43,7 @@ This document lists all configuration keys accepted by `config.toml`.
- [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)
@@ -2632,6 +2648,8 @@ WEB mode carries Telegram Desktop MTProxy traffic through HTTPS terminated by an
| `enabled` | `bool` | `false` | `✔` |
| `allow_wildcard_hosts` | `bool` | `false` | `✘` |
| `carrier` | `"https"`, `"https-lanes"`, `"websocket"`, or `"websocket-lanes"` | `"https"` | `✔` |
| [`carrier_method`](#webcarrier_method) | `"post"`, `"put"` | `"post"` | `✔` |
| [`conveyor`](#webconveyor) | `bool` | `true` | `✔` |
| `carriers` | `false` or a non-empty array of unique carriers | `false` | `✔` |
| `carrier_learning` | `bool` | `true` | `✔` |
| `carrier_negotiation_aggressiveness` | `"conservative"`, `"balanced"`, or `"aggressive"` | `"conservative"` | `✔` |
@@ -2652,6 +2670,24 @@ When `carriers` is missing or `false`, auto-negotiation and learning are disable
`carrier_learning` applies only while negotiation is enabled. Learning is process-local, in-memory, bounded, and positive-only: only a carrier that reaches the server-defined healthy state contributes evidence. `conservative` requires the broadest evidence and disables IP ranking, `balanced` admits moderate User-Agent/profile evidence plus eligible public-IP tie breaking, and `aggressive` reacts to the first bounded samples. Reported client failures remain diagnostic and never create negative evidence. Reload preserves evidence across a generation change only when enabled state, aggressiveness, evidence lifetime, and health window are identical; any semantic change advances the evidence epoch and fences stale outcomes. Because `[web.limits]` is process-owned, a reload that enables learning or negotiation using only a desired larger `max_carrier_learning_entries` atomically defers the dependent learning/carrier field rather than publishing an invalid effective combination. Disabling WEB stops issuance of new bridge and session credentials after reload; use the users API to revoke one user's active sessions.
## web.carrier_method
`"post"` (default) or `"put"` selects the HTTP method emitted by new bridge pages for `/api/v1/up` and `/api/v1/down`, including retries. The server accepts both methods independently of this setting. Session creation and diagnostics remain `POST`, session closure remains `DELETE`, and WebSocket Upgrade remains `GET`. Allow both `POST` and `PUT` through the TLS terminator. `put` supports connection reuse by Linux WebKitGTK implementations that distinguish idempotent methods; measure the actual client before assuming a latency improvement.
The watcher can apply this setting. Existing pages keep their method during session recovery; it does not rotate credentials or move established sessions.
## web.conveyor
`true` (default) permits bounded HTTP uplink pipelining for new `https` and `https-lanes` sessions. The client explicitly offers `X-Telemt-Up-Window: 1` through `4`; the reply confirms the window. With `false` or a WebSocket carrier, an explicit offer receives window `1`. A client without this header remains on the serialized path and receives no window header. Native `WELCOME` framing is unchanged.
The negotiated window allows DATA to be sent before the OPEN acknowledgment while preserving ordering, exact retries, acknowledgment checks and memory budgets. The watcher changes the policy for new sessions; existing sessions keep their negotiated window. This is independent of carrier auto-negotiation.
```toml
[web]
carrier_method = "post"
conveyor = true
```
# [web.debug]
This hot-reloadable table controls the process-owned server-side WEB debug recorder exposed as authenticated HTML at `GET /web-status` on the API listener. Collection is disabled by default. Retained and in-flight records remain bounded by restart-only values in `[web.limits]`.
@@ -2896,7 +2932,7 @@ The process must already have `web.allow_wildcard_hosts` enabled before a patch
```
## client_first_byte_idle_secs
- **Constraints / validation**: `u64` (seconds). `0` disables first-byte idle enforcement.
- **Description**: Maximum idle time to wait for the first client payload byte after session setup.
- **Description**: Maximum wait for the first client byte before parsing the client handshake, after any required PROXY header. This is separate from `client_handshake` and relay idle timeouts.
- **Example**:
```toml
@@ -3039,11 +3075,11 @@ The process must already have `web.allow_wildcard_hosts` enabled before a patch
```
## unknown_sni_action
- **Constraints / validation**: `"drop"`, `"mask"`, `"accept"` or `"reject_handshake"`.
- **Description**: Action for TLS ClientHello with unknown / non-configured SNI.
- `drop` — close the connection without any response (silent FIN after `server_hello_delay` is applied). Timing-indistinguishable from the Success branch, but wire-quieter than what a real web server would do.
- `mask` — transparently proxy the connection to `mask_host:mask_port` (TLS fronting). The client receives a real ServerHello from the backend with its real certificate. Maximum camouflage, but opens an outbound connection for every misdirected request.
- `accept` — pretend the SNI is valid and continue on the auth path. Weakens active-probing resistance; only meaningful in narrow scenarios.
- `reject_handshake` — emit a fatal TLS `unrecognized_name` alert (RFC 6066, AlertDescription = 112) and close the connection. Identical on the wire to a modern nginx with `ssl_reject_handshake on;` on its default vhost: looks like an ordinary HTTPS server that simply does not host the requested name. Recommended when the goal is maximal parity with a stock web server rather than TLS fronting. `server_hello_delay` is intentionally **not** applied to this branch, so the alert is emitted "instantly" the way a reference nginx would.
- **Description**: Policy for a ClientHello whose SNI is outside `tls_domain` and `tls_domains`.
- `drop` — close without a response after the configured ServerHello delay. This is the default; matching a delay does not establish timing indistinguishability.
- `mask` — use the configured masking path when masking is enabled. A reachable TLS fallback can return its own handshake and certificate; this does not authenticate the client to MTProxy.
- `accept` — continue MTProxy authentication despite the unknown SNI. It broadens the accepted names and still requires valid credentials. To preserve selected old links, add their domains to `tls_domains` instead.
- `reject_handshake` — send a fatal TLS `unrecognized_name` alert (RFC 6066, AlertDescription = 112) and close. The configured ServerHello delay is not applied to this branch. This matches a rejection mechanism used by nginx with `ssl_reject_handshake on`, not a claim of full network indistinguishability.
- **Example**:
```toml
@@ -3816,6 +3852,9 @@ If your backend or network is very bandwidth-constrained, reduce cap first. If p
enabled = false
```
## scopes
See the [complete Direct user-scope example](../Advanced_settings/TUNING.en.md#selecting-an-upstream-by-user-scope) for user naming, SOCKS credential replacement and behavior when no upstream matches.
- **Constraints / validation**: `String`. Comma-separated list; whitespace is trimmed during matching.
- **Description**: Scope tags used for request-level upstream filtering. If a request specifies a scope, only upstreams whose `scopes` contains that tag can be selected. If a request does not specify a scope, only upstreams with empty `scopes` are eligible.
- **Example**:
+69 -30
View File
@@ -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.
- **Пример**: