From 5d7327380df57d4af2b5799937e2ca4bdf79398c Mon Sep 17 00:00:00 2001 From: iambabyninja Date: Thu, 3 Oct 2024 18:19:34 +0500 Subject: [PATCH] RU Int32Range desc --- docs/ru/config/outbounds/freedom.md | 3 ++- docs/ru/config/transports/splithttp.md | 4 ++-- docs/ru/development/intro/guide.md | 18 ++++++++++++++++++ 3 files changed, 22 insertions(+), 3 deletions(-) diff --git a/docs/ru/config/outbounds/freedom.md b/docs/ru/config/outbounds/freedom.md index 6f2e43e..5fa89fb 100644 --- a/docs/ru/config/outbounds/freedom.md +++ b/docs/ru/config/outbounds/freedom.md @@ -62,6 +62,7 @@ Freedom будет принудительно отправлять все дан > `fragment`: map Несколько пар «ключ-значение», используемых для управления исходящей фрагментацией TCP. В некоторых случаях это может обмануть системы цензуры, например, обойти черные списки SNI. +`"length"` и `"interval"` относятся к типу [Int32Range](../../development/intro/guide.md#int32range) `"packets"`: поддерживаются два режима фрагментации: "1-3" — фрагментация потока TCP, применяется к первым трем операциям записи данных на стороне клиента; "tlshello" — фрагментация пакета TLS-рукопожатия. @@ -85,7 +86,7 @@ UDP-шум, используемый для отправки случайных - Если `type` равен `str`, здесь указывается строка для отправки. - Если `type` равен `base64`, здесь указываются двоичные данные, закодированные в Base64. -`"delay"`: задержка в миллисекундах. После отправки этого пакета шума ядро будет ожидать указанное время, прежде чем отправить следующий пакет шума или реальные данные. По умолчанию ожидание отсутствует. Можно установить целое число, например `100`, или строку с диапазоном значений, например `"50-150"`. +`"delay"`: **задержка**, в миллисекундах. После отправки этого пакета шума ядро будет ждать указанное время, прежде чем отправить следующий пакет шума или реальные данные. По умолчанию ожидание отсутствует. Тип: [Int32Range](../../development/intro/guide.md#int32range) > `proxyProtocol`: number diff --git a/docs/ru/config/transports/splithttp.md b/docs/ru/config/transports/splithttp.md index 9355a5a..5274bc4 100644 --- a/docs/ru/config/transports/splithttp.md +++ b/docs/ru/config/transports/splithttp.md @@ -87,7 +87,7 @@ > `xPaddingBytes`: int | string -Задает размер заполнения для запросов (исходящих) и ответов (входящих), чтобы уменьшить цифровой след запроса. Единица измерения — байты. Значение по умолчанию — `"100-1000"`, каждый раз будет выбираться случайное число из этого диапазона. Также может быть одним числом, например `"200"` или `200`. +Задает размер заполнения для запросов (исходящих) и ответов (входящих), используемый для уменьшения отпечатка запроса. Единица измерения: байты. Значение по умолчанию: `"100-1000"`. При каждом запросе случайным образом выбирается число из этого диапазона. Тип: [Int32Range](../../development/intro/guide.md#int32range) Значение `-1` полностью отключает заполнение. @@ -112,7 +112,7 @@ Объяснение терминов: - Потоки будут мультиплексироваться в физические соединения, например: Соединение 1 (Поток 1, Поток 2, Поток 3) Соединение 2 (Поток 4, Поток 5, Поток 6) ... и так далее. В других источниках вы можете встретить описание "соединение-подключение", это то же самое. -- Все поля, описанные ниже, имеют тип int/string и поддерживают как фиксированные значения (например, `16`), так и диапазоны значений (например, `"8-32"`). +- Все следующие поля имеют тип [Int32Range](../../development/intro/guide.md#int32range): > `maxConcurrency`: int/string diff --git a/docs/ru/development/intro/guide.md b/docs/ru/development/intro/guide.md index 5c2d01d..0738260 100644 --- a/docs/ru/development/intro/guide.md +++ b/docs/ru/development/intro/guide.md @@ -130,6 +130,24 @@ Xray-core - Один файл должен содержать один основной тип и связанные с ним приватные функции. - Тестовые файлы, такие как Mock и другие утилиты, помещайте в подкаталог testing. +#### Int32Range + +**Для конечного пользователя** + +Значение, представляющее собой необязательный диапазон. Возможные варианты записи: + +- Отдельное число или диапазон, заключенные в кавычки: + - `""` (считается как 0). Обратите внимание, что полное отсутствие настройки поля и установка пустого значения могут иметь разное значение. + - `"114"` + - `"114-514"` +- Отдельное целое число (int). В этом случае возможно указать только одно число: + - `114` + +**Для разработчика** + +Если вам нужно использовать диапазон в файле конфигурации, используйте тип `Int32Range`. Для получения значений используйте `.From` и `.To` вместо использования строкового типа (`string`) и последующего ручного разбора. + +Метод `.EnsureOrder()` можно использовать для обмена значений From и To, если From больше, чем To (при необходимости).