mirror of
https://github.com/telemt/telemt.git
synced 2026-11-22 07:16:38 +03:00
feat(client_mss): chunk only the start of the initial server response
With client_mss_bulk the whole authenticated FakeTLS response (ServerHello, CCS, emulated certificate records, tickets - typically ~4 KiB) was written in client_mss-sized chunks: about 50 segments at `tspu`. With ~2% loss at least one segment is lost in ~64% of handshakes, and the burst takes several RTTs to pass the initial congestion window. - New server.client_mss_prefix (Linux, requires client_mss_bulk): `full` (default, current behavior), `server-hello` (through the end of the first TLS record, capped at 2048 bytes, falls back to `full` on unexpected input) or a byte count. Only that prefix is written in MSG_EOR chunks; the rest goes out in one write at the bulk MSS. - Chunk payload accounts for TCP timestamps and never exceeds tcpi_snd_mss. - Removed TcpMaxSegmentGuard: TCP_MAXSEG on an established socket does not change the MSS of outgoing segments on Linux, and its getsockopt/setsockopt failures no longer abort the handshake. TCP_NODELAY is set once. - Docs (en/ru/de), API discovery metadata, strict keys, reload diff.
This commit is contained in:
@@ -1935,6 +1935,7 @@
|
||||
| [`listen_tcp`](#listen_tcp) | `bool` | — (auto) | `✘` |
|
||||
| [`client_mss`](#client_mss) | `String` | `""` | `✘` |
|
||||
| [`client_mss_bulk`](#client_mss_bulk) | `String` | `""` | `✘` |
|
||||
| [`client_mss_prefix`](#client_mss_prefix) | `String` | `""` | `✘` |
|
||||
| [`proxy_protocol`](#proxy_protocol) | `bool` | `false` | `✘` |
|
||||
| [`proxy_protocol_header_timeout_ms`](#proxy_protocol_header_timeout_ms) | `u64` | `500` | `✘` |
|
||||
| [`proxy_protocol_trusted_cidrs`](#proxy_protocol_trusted_cidrs) | `IpNetwork[]` | `[]` | `✘` |
|
||||
@@ -2019,7 +2020,7 @@
|
||||
```
|
||||
## client_mss
|
||||
- **Ограничения / валидация**: `String`. Пустое значение или отсутствие параметра означает, что Telemt не изменяет MSS, выбранный ядром. Поддерживаемые presets: `"extreme-low"` = `88`, `"tspu"` = `92`, `"2in8"` = `256`. Пользовательское десятичное значение должно быть строкой в диапазоне `88..=4096`.
|
||||
- **Описание**: Управляет размером сегментов в клиентских соединениях. По умолчанию значение применяется к TCP listener и действует в течение всего соединения. Если в Linux также задан `client_mss_bulk`, Telemt временно ограничивает `TCP_MAXSEG` принятого socket значением `client_mss` на время отправки начального аутентифицированного FakeTLS-ответа (`ServerHello`), а затем восстанавливает bulk MSS при успехе, ошибке записи или отмене задачи. Настройка не влияет на API, metrics, Unix sockets, Telegram upstreams, ME sockets и mask backend connections. Изменение требует перезапуска или повторного создания listener.
|
||||
- **Описание**: Управляет размером сегментов в клиентских соединениях. По умолчанию значение применяется к TCP listener и действует в течение всего соединения. Если в Linux также задан `client_mss_bulk`, listener работает на bulk MSS, а Telemt пишет начальный аутентифицированный FakeTLS-ответ (`ServerHello`) или выбранную [`client_mss_prefix`](#client_mss_prefix) его часть кусками из user space, каждый из которых помещается в один сегмент при `client_mss`. Настройка не влияет на API, metrics, Unix sockets, Telegram upstreams, ME sockets и mask backend connections. Изменение требует перезапуска или повторного создания listener.
|
||||
- **Operator note**: Two-tier `synlimit` profile больше не требует автоматического отключения MSS внутри Telemt. Оператор должен сам решить, оставлять MSS shaping для handshake fragmentation или отключать его ради более высокой скорости media.
|
||||
- **Performance note**: Низкий MSS предсказуемо увеличивает количество TCP-сегментов. Приблизительный multiplier: `ceil(1460 / client_mss)`.
|
||||
- **Пример**:
|
||||
@@ -2030,7 +2031,7 @@
|
||||
```
|
||||
## client_mss_bulk
|
||||
- **Ограничения / валидация**: Только Linux, тип `String`. Грамматика совпадает с [`client_mss`](#client_mss): пустое/отсутствующее значение, пресеты `"extreme-low"`/`"tspu"`/`"2in8"` или десятичное число в диапазоне `88..=4096`. Непустое значение требует хотя бы одного listener с эффективным `client_mss` и должно быть больше handshake-значения каждого участвующего listener. Listener может задать `client_mss = ""` для явного отказа от профиля.
|
||||
- **Описание**: Включает экспериментальный профиль с двумя размерами. Listener использует `client_mss_bulk` с самого начала соединения, включая получение `ClientHello`. При отправке начального аутентифицированного FakeTLS-ответа (`ServerHello`) Telemt временно ограничивает `TCP_MAXSEG` принятого socket значением `client_mss` и использует записи не больше этого значения, затем восстанавливает прежний MSS до обычного MTProto-трафика. Восстановление выполняется при успехе, ошибке записи и отмене задачи. TCP является потоком байтов: `MSG_EOR`, TCP offloads, потери и ретрансляции могут менять наблюдаемые границы capture, поэтому packet-capture release gate остаётся определяющим. Если параметр пуст или отсутствует, `client_mss` остаётся kernel MSS для всего соединения. Изменение требует restart/rebind listener.
|
||||
- **Описание**: Включает экспериментальный профиль с двумя размерами. Listener использует `client_mss_bulk` с самого начала соединения, включая получение `ClientHello`. Начальный аутентифицированный FakeTLS-ответ (`ServerHello`) или выбранная [`client_mss_prefix`](#client_mss_prefix) его часть отправляется записями с `MSG_EOR`, каждая из которых помещается в один сегмент при `client_mss` (за вычетом опции TCP timestamps, если она согласована, и не больше текущего send MSS соединения); остаток пишется на bulk MSS. MSS сокета не меняется: на установленном Linux-сокете `TCP_MAXSEG` не влияет на исходящие сегменты. TCP является потоком байтов: `MSG_EOR`, TCP offloads, потери и ретрансляции могут менять наблюдаемые границы capture, поэтому packet-capture release gate остаётся определяющим. Если параметр пуст или отсутствует, `client_mss` остаётся kernel MSS для всего соединения. Изменение требует restart/rebind listener.
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
@@ -2038,6 +2039,17 @@
|
||||
client_mss = "tspu"
|
||||
client_mss_bulk = "1400"
|
||||
```
|
||||
## client_mss_prefix
|
||||
- **Ограничения / валидация**: Только Linux, тип `String`, используется только вместе с [`client_mss_bulk`](#client_mss_bulk). Пустое или отсутствующее значение означает `"full"`. Значения: `"full"`, `"server-hello"` или десятичное число байт в диапазоне `1..=65535`. Непустое значение без `client_mss_bulk` отклоняется.
|
||||
- **Описание**: Выбирает начальную часть аутентифицированного FakeTLS-ответа, которая пишется кусками по `client_mss`. `"full"` режет весь ответ (`ServerHello`, `ChangeCipherSpec`, записи эмулированного сертификата и тикеты). `"server-hello"` режет только первую TLS-запись (`ServerHello`, не больше 2048 байт), остаток пишется на bulk MSS; если ответ не начинается с полной handshake-записи, режется весь ответ. Число задаёт количество начальных байт. `MSG_EOR` на последнем куске не даёт bulk-остатку склеиться с мелким хвостом. Чем меньше префикс, тем меньше сегментов: при потерях около 2% ответ 4 КиБ сегментами по 80 байт теряет хотя бы один сегмент примерно в 64% рукопожатий, три сегмента - примерно в 6%; кроме того, меньшее число пакетов быстрее выходит из начального окна перегрузки. Изменение требует restart/rebind listener.
|
||||
- **Пример**:
|
||||
|
||||
```toml
|
||||
[server]
|
||||
client_mss = "tspu"
|
||||
client_mss_bulk = "1400"
|
||||
client_mss_prefix = "server-hello"
|
||||
```
|
||||
## proxy_protocol
|
||||
- **Ограничения / валидация**: `bool`.
|
||||
- **Описание**: Включает поддержку разбора PROXY protocol от HAProxy (v1/v2) на входящих соединениях. При включении исходный IP клиента берётся из PROXY-заголовка.
|
||||
|
||||
Reference in New Issue
Block a user