Merge pull request #972 from AndreyOsipuk/fix/client-mss-prefix

client_mss: chunk only the start of the initial server response
This commit is contained in:
Alexey
2026-11-15 13:31:31 +03:00
committed by GitHub
25 changed files with 777 additions and 155 deletions
+14 -2
View File
@@ -1951,6 +1951,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[]` | `[]` | `✘` |
@@ -2035,7 +2036,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)`.
- **Пример**:
@@ -2046,7 +2047,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
@@ -2054,6 +2055,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-заголовка.