Переменные среды

Xray может читать несколько переменных среды для настройки путей к ресурсам, поведения загрузки конфигурации и некоторых низкоуровневых переключателей.

Для каждой опции Xray принимает оба варианта имени:

• с точками: например xray.location.asset
• в верхнем регистре с подчёркиваниями: например XRAY_LOCATION_ASSET

Путь к ресурсам (geoip/geosite и т.п.)

• Название: xray.location.asset или XRAY_LOCATION_ASSET
• По умолчанию: каталог исполняемого файла Xray

Задаёт каталог с ресурсными файлами (например geoip.dat и geosite.dat).

На не-Windows системах, если файл ресурсов не найден в каталоге выше, Xray также попробует (по порядку):

• /usr/local/share/xray/
• /usr/share/xray/
• /opt/share/xray/

Каталог конфигурации (config.json)

• Название: xray.location.config или XRAY_LOCATION_CONFIG
• По умолчанию: каталог исполняемого файла Xray

Задаёт каталог, в котором Xray ищет config.json.

TIP

Если xray run запущен без -c/-config, сначала проверяется рабочий каталог на config.json/jsonc/toml/yaml/yml, затем config.json в этом каталоге, и только потом читается STDIN. См. Параметры командной строки.

Каталог с несколькими конфигами (confdir)

• Название: xray.location.confdir или XRAY_LOCATION_CONFDIR
• По умолчанию: ""

При запуске xray run без флага -confdir, если переменная указывает на существующий каталог, Xray загрузит все файлы распознаваемых форматов (json/jsonc/yaml/yml/toml) в порядке имён и объединит их (см. Мульти-конфиг).

WARNING

Если confdir содержит одновременно JSON (*.json/*.jsonc) и YAML (*.yaml/*.yml) файлы, Xray завершится с ошибкой.

Каталог сертификатов (разрешение относительных путей)

• Название: xray.location.cert или XRAY_LOCATION_CERT
• По умолчанию: каталог исполняемого файла Xray

Если путь к сертификату (например certificateFile / keyFile) задан относительным, он будет разрешаться относительно этого каталога. Абсолютные пути не затрагиваются.

Каталог инструментов (xctl и т.п.)

• Название: xray.location.tool или XRAY_LOCATION_TOOL
• По умолчанию: каталог исполняемого файла Xray

Используется для поиска внешних инструментов (например xctl). Xray сначала проверит этот каталог, затем системный PATH.

Оптимизации ввода-вывода (readv / splice)

Оптимизация чтения readv

• Название: xray.buf.readv или XRAY_BUF_READV
• По умолчанию: включено (не задано, либо auto / enable)

Управляет использованием readv(2) для подходящих соединений. Установите любое другое значение (например disable), чтобы отключить.

splice (zero-copy) для Freedom

• Название: xray.buf.splice или XRAY_BUF_SPLICE
• По умолчанию: включено (не задано, либо auto / enable)

Управляет тем, использует ли Freedom outbound splice/zero-copy там, где это возможно. Установите любое другое значение (например disable), чтобы отключить.

Принудительный VMess Padding

• Название: xray.vmess.padding или XRAY_VMESS_PADDING
• По умолчанию: не задано (поведение VMess по умолчанию)

Если переменная задана (независимо от значения), Xray принудительно включает VMess global padding (в основном влияет на security: \"none\" и подобные случаи).

Переключатель UDP Cone

• Название: xray.cone.disabled или XRAY_CONE_DISABLED
• По умолчанию: не отключено (Cone включен)

Если значение строго равно true, Cone поведение будет отключено (влияет на сопоставление UDP-сессий для некоторых inbound, а также на генерацию XUDP globalID).

Размер буфера по умолчанию (Policy)

• Название: xray.ray.buffer.size или XRAY_RAY_BUFFER_SIZE

Задаёт значение по умолчанию для policy.bufferSize (единица: МБ). См. Политика.

Browser Dialer

• Название: xray.browser.dialer или XRAY_BROWSER_DIALER

Если задан адрес прослушивания (например 127.0.0.1:8080), включает Browser Dialer. См. Browser Dialer.

Отладка XUDP

Включить отладочные логи

• Название: xray.xudp.show или XRAY_XUDP_SHOW
• По умолчанию: выключено

Если задано true (без учёта регистра), Xray выводит отладочную информацию XUDP (например globalID).

Зафиксировать BaseKey

• Название: xray.xudp.basekey или XRAY_XUDP_BASEKEY
• По умолчанию: генерируется случайно при каждом запуске

Фиксирует BaseKey, используемый для XUDP globalID. Значение должно быть Base64-URL (raw, без =) от 32 байт; некорректное значение приведёт к panic при запуске.