Параметры протокола XRay
Общая информация
В этой инструкции описаны параметры протокола XRay в AmneziaVPN 5.1.0.6. Помимо Порта и Имени сервера (SNI), в приложении можно менять транспорт, защиту соединения и дополнительные параметры передачи данных. Сам протокол должен быть установлен на сервер из AmneziaVPN 5.0.1.5 или новее.
Изменение параметров может понадобиться, если подключение по протоколу XRay не работает в определённой сети. Если подключение работает, менять пара метры протокола не нужно.
Чтобы перейти в настройки XRay, нажмите на название любого подключения в AmneziaVPN, затем на иконку ⚙️ (шестерёнка) справа от подключения к вашему серверу, в списке установленных протоколов выберите XRay и откройте раздел XRay настройки сервера.

Параметры XRay
Далее будут перечислены параметры XRay в том же порядке, в котором они отображаются или появляются в AmneziaVPN при настройке протокола.
В Transport выбирается способ передачи VPN-трафика, в Security — защита соединения, а во Flow — дополнительная обработка VPN-трафика. От выбранных транспорта и защиты зависят доступные параметры и значения Flow.
При сохранении настроек протокола XRay обращайте внимание на сообщение приложения AmneziaVPN — если оно предупреждает, что ранее выданные ключи для подключения перестанут работать, их потребуется перевыпустить для всех пользователей. Ниже значком 🔑 будут отмечены все параметры или группы параметров, при изменении и сохранении которых старые ключи для подключения по протоколу XRay перестанут работать.
Порт 🔑
Порт, через который устройства подключаются к серверу по протоколу XRay. По умолчанию используется порт 443, но при необходимости его можно поменять на любой другой в диапазоне от 1 до 65535, например, 8443.
Не меняйте работающий порт без необходимости. В случае смены порта убедитесь, что он свободен.
XRay, установленный на сервер через AmneziaVPN, занимает выбранный порт для двух сетевых протоколов — и для TCP, и для UDP. Поэтому, если на сервере установлены другие VPN-протоколы AmneziaWG/WireGuard/OpenVPN или прокси-сервисы для Telegram, выбрать для XRay используемый ими порт не получится.
Transport 🔑
Транспорт определяет способ передачи VPN-трафика между приложением и VPN-сервером. В AmneziaVPN для XRay можно выбрать один из трёх транспортов: RAW (TCP), XHTTP или mKCP.
RAW (TCP)
Транспорт RAW передаёт VPN-трафик по TCP-соединению и не имеет дополнительных параметров.
XHTTP
Транспорт XHTTP передаёт VPN-трафик по TCP-соединению, как и RAW, но дополнительно помещает данные в HTTP-запросы и ответы. Сервер обрабатывает HTTP-запрос и извлекает из него VPN-данные для дальнейшей передачи.
При выборе транспорта XHTTP становятся доступными для настройки параметры Режим, Профиль HTTP, переключатели заголовков, Сессия и последовательность, Управление трафиком и Заполнение и мультиплексирование.
Режим 🔑
Режим определяет, как XHTTP передаёт данные от устройства к серверу и обратно:
- Auto — XRay сам выбирает режим в зависимости от выбранного способа защиты соединения (Security): при TLS или Нет используется Packet-up, а при Reality — Stream-one;
- Packet-up — данные от устройства отправляются отдельными порциями в нескольких HTTP-запросах. Чтобы сервер понимал, что эти запросы относятся к одному подключению, XHTTP добавляет к ним идентификатор сессии, который создаётся автоматически. Каждой порции данных присваивается порядковый номер, чтобы сервер мог собрать их в нужной последовательности. Данные от сервера передаются потоком в отдельном HTTP-ответе;
- Stream-up — данные в обоих направлениях передаются потоками, но для отправки и получения используются отдельные HTTP-запросы. Как и в Packet-up, запросы одного подключения связываются идентификатором сессии;
- Stream-one — отправка и получение данных происходят внутри одного HTTP-запроса и ответа на него. Идентификатор сессии для связи запросов не добавляется. Этот режим устанавливается по умолчанию при выборе транспорта XHTTP.
Где передавать идентификатор сессии и порядковые номера порций, задаётся позже, в параметрах Сессия и последовательность. Размеры порций и паузы между их отправкой настраиваются в параметрах Управление трафиком.
Профиль HTTP
Параметры HTTP-запросов, внутри которых XHTTP передаёт VPN-трафик:
- Хост 🔑 — доменное имя, указанное внутри HTTP-запроса. XRay на сервере проверяет, совпадает ли оно с именем, заданным в его настройках. Хост может, но не обязан совпадать со значением поля Имя сервера (SNI) — по умолчанию AmneziaVPN подставляет в оба параметра адрес
www.googletagmanager.com. Эти параметры используются на разных этапах: SNI — при установлении защищённого соединения, Хост — в HTTP-запросах внутри соединения. - Path 🔑 — путь, по которому XRay на вашем сервере принимает HTTP-запросы с VPN-данными.
Путь — это часть адреса после домена. Например, в
https://example.com/vpnпуть — это/vpn. Создавать страницу или папку по заданному пути не нужно ни на сервере, ни на сайте, указанном в поле Хост — путь задаётся в конфигурации самого XRay. Поле можно оставить пустым: по умолчанию используется корневой путь/, как в адресеhttps://example.com/. - UplinkHTTPMethod — тип HTTP-запроса, с которым устройство отправляет VPN-данные серверу: POST, PUT или PATCH. В самом XHTTP все три типа запроса выполняют одну задачу — передают VPN-данные. Отдельных режимов работы VPN для POST, PUT и PATCH нет. Выбирать PUT или PATCH нужно, если у вас есть промежуточный HTTP-сервис, и он настроен на обработку запросов только по одному из этих двух типов. Промежуточный HTTP-сервис — это, например, отдельно настроенный прокси между приложением и вашим сервером. Если такого сервиса у вас нет, оставьте POST.
Отключить заголовок gRPC 🔑
Отключает заголовок Content-Type: application/grpc в запросах Stream-up и Stream-one. Этот заголовок обозначает передаваемые данные как gRPC — это один из способов обмена данными между программами. В Packet-up этот переключатель не используется.
Отключить заголовок SSE 🔑
Отключает заголовок Content-Type: text/event-stream в ответе сервера. Такой заголовок используется, когда сайт присылает новые данные без перезагрузки страницы. В XHTTP переключатель убирает этот заголовок, но не отключает саму передачу VPN-данных.
Сессия и последовательность 🔑
В Packet-up используются все параметры этого раздела. В Stream-up используются только SessionPlacement и SessionKey, а в Stream-one не используется ни один. Если в Режим выбран Auto, ориентируйтесь на режим, который XRay выбирает для вашего Security, как описано выше.
-
SessionPlacement — в какой части HTTP-запроса передавать идентификатор сессии:
- Path — идентификатор сессии добавляется к пути из Профиль HTTP → Path. Например, при базовом пути
/vpnи условном идентификатореabc123начало пути запроса будет/vpn/abc123; - Header — в HTTP-заголовке, то есть в служебном поле запроса;
- Cookie — в куки, то есть в поле с именем и значением, передаваемом вместе с HTTP-запросом;
- Query — в параметре адреса после
?, например?x_session=abc123; - None — использовать место передачи по умолчанию. Результат такой же, как при Path: идентификатор сессии добавляется к пути запроса, а не отключается.
- Path — идентификатор сессии добавляется к пути из Профиль HTTP → Path. Например, при базовом пути
-
SessionKey — имя поля с идентификатором сессии. Используется только в случае, если в SessionPlacement выбраны Header, Cookie или Query. Например, в заголовке
X-Session: abc123имя поля —X-Session, аabc123— автоматически созданный идентификатор сессии. В SessionKey задаётся только имя, не сам идентификатор.Поле можно оставить пустым. По умолчанию для Header используется имя
X-Session, для Cookie и Query —x_session. Если в SessionPlacement выбраны Path или None, заполнять поле SessionKey не требуется. -
SeqPlacement — в какой части HTTP-запроса передавать номер порции данных в Packet-up. Идентификатор сессии общий для одного подключения, а у каждой порции свой номер: по нему сервер восстанавливает порядок данных. Место переда чи выбирается так же, как в SessionPlacement.
-
SeqKey — имя поля с номером порции. Используется только в случае, если в SeqPlacement выбраны Header, Cookie или Query. Как и в SessionKey, здесь задаётся только имя поля, а не номер порции.
Поле можно оставить пустым. По умолчанию для Header используется имя
X-Seq, для Cookie и Query —x_seq. Если в SeqPlacement выбраны Path или None, заполнять поле SeqKey не требуется. -
UplinkDataPlacement (Где в запросе передаются отправляемые данные) — в какой части HTTP-запроса передавать VPN-данные:
- Body — в теле HTTP-запроса, то есть в его части с передаваемыми данными;
- Auto — сервер принимает данные из тела запроса, заголовков или куки. Устройство с этим значением отправляет данные в теле запроса; автоматического выбора между тремя способами на устройстве нет;
- Header — в HTTP-заголовках;
- Cookie — в куки.
Варианты Header и Cookie применяются только при явно выбранном режиме Packet-up. Если в Режим выбран Auto, оставьте Body, даже если приложение предлагает другие варианты.
-
UplinkDataKey — базовое имя HTTP-заголовков или куки, в которых передаются VPN-данные. XHTTP добавляет к этому имени номера частей данных внутри одного HTTP-запроса: например, при Header из
X-Dataполучаются заголовкиX-Data-0,X-Data-1и так далее.Поле можно оставить пустым. По умолчанию для Header и Auto используется имя
X-Data, для Cookie —x_data. При Auto это имя используется сервером для приёма данных из заголовков или куки. Если в UplinkDataPlacement выбран Body, заполнять поле UplinkDataKey не требуется.
Управление трафиком
Параметры размера и частоты HTTP-запросов, а также очереди данных на сервере. Если в Режим выбран Auto, ориентируйтесь на режим, который XRay выбирает для вашего Security, как описано выше.
В полях Мин и Макс задаются нижняя и верхняя границы диапазона, из которого XRay выбирает значение. Для фиксированного значения укажите одинаковые границы. Заполнять все поля вручную не нужно. При этом пустое поле и 0 не всегда означают отключение — их смысл зависит от параметра.
- UplinkChunkSize — размер отдельной части данных, передаваемой в HTTP-заголовке или куки. Используется только в Packet-up, если в UplinkDataPlacement выбраны Header или Cookie. Задаётся в байтах. Меньший размер означает больше частей данных внутри одного HTTP-запроса. Это позволяет уменьшить отдельные заголовки или куки, например под ограничение промежуточного HTTP-сервиса. Это не размер сетевого пакета и не аналог mtu. При пустом поле или
0XRay использует стандартный диапазон:3000–4000байт для Header и2048–3072байта для Cookie. - scMaxBufferedPosts — сколько порций данных сервер может держать в очереди для одного подключения Packet-up, пока собирает их в нужном порядке. Например, если вторая порция пришла раньше первой, сервер жд ёт недостающую порцию и хранит уже полученную в очереди. Больший лимит позволяет хранить больше таких порций, но увеличивает возможный расход памяти. При переполнении очереди соединение прерывается — увеличивать лимит имеет смысл, если обрывы вызваны именно этим. Пустое поле или
0оставляет стандартный лимит XRay —30. - scMaxEachPostBytes 🔑 — границы размера одной порции данных Packet-up, в байтах. Устройство выбирает из диапазона верхний предел для отправляемой порции, а сервер принимает порции не больше Макс. Это не требование заполнять каждый запрос до указанного размера. При меньшем пределе тот же объём данных может потребовать больше HTTP-запросов. Менять параметр имеет смысл, если нужно изменить размер порций, например под ограничение промежуточного HTTP-сервиса. Для своего диапазона задайте обе границы от
1. Чтобы использовать стандартный предел1000000байт, оставьте оба поля пустыми или укажите0–0. - scStreamUpServerSecs — диапазон интервалов, в секундах, между отправками служебного заполнения сервером в Stream-up. Оно помогает удерживать HTTP-ответ открытым, когда полезные данные в нём не передаются. Меньший интервал означает более частую отправку заполнения и больший расход служебного трафика, больший — более редкую. Настройка может понадобиться, если промежуточный HTTP-сервис закрывает соединения при долгом отсутствии данных. Параметр не ограничивает общую длительность VPN-подключения и не используется в Packet-up или Stream-one.
- scMinPostsIntervalMs — диапазон минимальных пауз между отправками порций данных Packet-up, в миллисекундах. Увеличение пауз делает HTTP-запросы менее частыми, но может уменьшить скорость отправки данных на сервер. Уменьшение допускает более частую отправку, но само по себе не гарантирует ускорения. Это настройка частоты запросов, а не задержки всей сети. В Stream-up и Stream-one она не используется.
После очистки scStreamUpServerSecs или scMinPostsIntervalMs приложение при повторном открытии настроек автоматически заполняет поля своими исходными значениями: 1–100 секунд и 100–800 миллисекунд соответственно. Это не проверка фактически применённых значений. Если параметр отсутствует в конфигурации XRay, используются другие значения: 20–80 секунд и 30–30 миллисекунд. Чтобы задать нужный диапазон без этой неоднозначности, укажите обе границы явно.
Заполнение и мультиплексирование
В этой группе находятся отдельные экраны xPadding и XMux.
xPadding 🔑
Настройки служебного заполнения HTTP-запросов и ответов. XHTTP добавляет к ним строку выбранного размера, которая не содержит ваших данных. Это меняет внешний вид и размеры HTTP-обмена, но не заменяет шифрование.
-
xPaddingBytes — диапазон размера заполнения в байтах. Задаётся на отдельном экране в полях Мин и Макс — нижней и верхней границах, как в Управление трафиком. Для своего диапазона задайте обе границы от
1. Чтобы использовать стандартный диапазон100–1000байт, оставьте оба поля пустыми или укажите0–0. Больший размер добавляет больше служебных данных, а не увеличивает скорость или размер полезных данных; -
xPaddingObfsMode — включает применение заданных вами параметров заполнения. При выключении поля остаются видимыми, но становятся недоступными для редактирования. Пользовательские значения, включая xPaddingBytes, не применяются: XRay использует стандартное заполнение. Само заполнение не отключается;
-
xPaddingKey — текстовое имя cookie или параметра URL с заполнением. Это не секретный ключ. Используется для Cookie, Query и Query in header;
-
xPaddingHeader — текстовое имя HTTP-заголовка с заполнением. Используется для Header и Query in header; в других вариантах размещения это поле не требуется;
-
xPaddingPlacement — место размещения заполнения:
- Cookie — в cookie с именем из xPaddingKey;
- Header — непосредственно в заголовке с именем из xPaddingHeader;
- Query — в параметре URL с именем из xPaddingKey;
- Query in header — в параметре URL, который находится внутри заголовка. Здесь используются оба имени: xPaddingHeader для заголовка и xPaddingKey для параметра URL;
-
xPaddingMethod — способ формирования строки заполнения: Repeat-x повторяет символ
X, а Tokenish создаёт строку из случайных букв и цифр, похожую на токен. Оба варианта — служебное заполнение, а не способ авторизации.
Если оставить xPaddingKey и xPaddingHeader пустыми, AmneziaVPN подставит стандартные имена: x_padding и X-Padding соответственно. Эти же имена используются по умолчанию в XRay. Параметры заполнения должны быть совместимы на устройстве и сервере.
Для xPaddingBytes и scMaxEachPostBytes не задавайте нулевой Мин при ненулевом Макс: такой диапазон может привести к ошибке настройки или неработающему подключению. Задайте обе границы от 1 либо используйте 0–0 для стандартных значений XRay.
XMux
XMux позволяет передавать несколько подключений через общее HTTP-соединение, вместо того чтобы каждый раз создавать новое. Например, обращения разных приложений на вашем устройстве могут использовать одно соединение с VPS. Это называется мультиплексированием; речь не о количестве пользователей сервера. В отличие от Режим, который определяет способ отправки и получения данных, XMux управляет использованием общих соединений для разных подключений.
Переключатель xmux включает или выключает применение заданн ых в этом разделе значений. При его выключении поля остаются на экране, но становятся недоступными для редактирования. XRay использует свои значения по умолчанию: сам механизм XMux не отключается. Эти настройки определяют, как устройство использует соединения с сервером.
- maxConcurrency — сколько подключений может одновременно передаваться внутри одного транспортного соединения. Когда предел достигнут, для новых подключений создаётся другое соединение;
- maxConnections — сколько транспортных соединений создавать параллельно. До достижения предела для новых подключений создаются отдельные соединения, затем используются уже открытые. Нельзя задавать ненулевые ограничения одновременно для maxConnections и maxConcurrency — выбирается один из двух способов;
- cMaxReuseTimes — сколько раз транспортное соединение можно использовать для подключений. После достижения предела новые подключения в него не добавляются;
- hMaxRequestTimes — сколько HTTP-запросов суммарно может пройти через соединение. В отличие от maxConcurrency, считаются запросы за всё время, а не подключения, активные одновременно;
- hMaxReusableSecs — сколько секунд соединение можно использовать для новых HTTP-запросов. После этого срока новые запросы направляются в другое соединение; текущие не обрываются только из-за истечения срока;
- hKeepAlivePeriod — интервал служебных сообщений, проверяющих неактивное HTTP/2-соединение, в секундах. При HTTP/1.1 эта настройка не используется. Отрицательное значение, например
-1, отключает эти сообщения. Пустое поле или0оставляет стандартный интервал XRay —45секунд.
Для первых пяти параметров задаются границы диапазона Мин и Макс, как в Управление трафиком, а для hKeepAlivePeriod — одно число. Когда все параметры XMux пустые или нулевые, XRay использует стандартный набор: maxConnections — 3, hMaxRequestTimes — 600–900, hMaxReusableSecs — 1800–3000 секунд. Ограничения maxConcurrency и cMaxReuseTimes при этом не заданы.
Если задать хотя бы один ненулевой параметр, этот стандартный набор уже не подставляется целиком. Например, при заданном только maxConcurrency пустые hMaxRequestTimes и hMaxReusableSecs не сохраняют ограничения 600–900 запросов и 1800–3000 секунд. Поэтому параметры XMux нужно подбирать как единый набор, а не менять одно число в расчёте на то, что остальные стандартные ограничения сохранятся.
mKCP
mKCP обеспечивает передачу данных поверх UDP. Он может уменьшить задержку в нестабильной сети, но обычно расходует больше трафика, чем TCP.
Настройки mKCP
- TTI — интервал отправки пакетов mKCP в миллисекундах. Допустимы значения от
10до100. Меньшее значение позволяет чаще отправлять данные и подтверждения, что может уменьшить ожидание передачи, но увеличивает частоту служебного обмена и работы ядра. Это не гарантирует увеличения скорости: слишком частая отправка создаёт дополнительную нагрузку на устройство и VPS. - uplinkCapacity — пропускная способность отправки, на которую ориентируется mKCP, в МБ/с — мегабайтах в секунду, а не мегабитах. Для пересчёта из Мбит/с ориентируйтесь на соотношение: примерно
8Мбит/с на1МБ/с. Например,40Мбит/с — это примерно5МБ/с. XRay использует это число при расчёте количества пакетов, которые можно отправить, не дожидаясь подтверждения. Если задаёте значение вручную, ориентируйтесь на доступную скорость канала отправки, а не на желаемую скорость VPN. Слишком маленькое значение может ограничить передачу; завышенное не увеличит физическую пропускную способность канала. - downlinkCapacity — пропускная способность приёма, на которую ориентируется mKCP. Задаётся в МБ/с, как и uplinkCapacity, но учитывает принимающую сторону: сколько пакетов она готова принять до подтверждения. Для ручной настройки ориентируйтесь на доступную скорость приёма. Фактическая передача зависит и от отправителя, и от получателя — увеличение только одного значения не гарантирует ускорения.
- mtu — максимальный размер передаваемого пакета mKCP в байтах. Допустимы значения от
576до1460, по умолчанию используется1350. Если крупные UDP-пакеты не проходят через сеть без потерь, уменьшение mtu может помочь восстановить стабильную передачу. Но меньшие пакеты означают больше пакетов и служебных данных для передачи того же объёма. Меняйте mtu постепенно и проверяйте подключение после каждого изменения: универсального значения для всех сетей нет. - cwndMultiplier — множитель окна передачи: влияет на количество отправленных пакетов, для которых ещё не получено подтверждение. Минимальное значение —
1. Увеличение допускает больше таких пакетов одновременно, но не гарантирует ускорения. - maxSendingWindow — максимальный объём отправленных, но ещё не подтверждённых данных, в байтах. Это не общий лимит трафика за сеанс. Значение не должно быть меньше mtu. Если оставить поле пустым, XRay использует
2097152байта —2МиБ.
При выборе mKCP вариант Reality в разделе Security недоступен, а Flow отображается как Пусто.