REALITY в Xray и sing-box: перенос параметров без потери полей

REALITY — это современная технология маскировки трафика, которая имитирует TLS-рукопожатие легитимного сайта. Xray и sing-box — два популярных ядра, поддерживающих REALITY, но их конфигурации структурно различаются. При переходе с одного ядра на другое важно корректно перенести все параметры, иначе соединение не установится. В этой статье мы подробно разберём, какие поля соответствуют друг другу, как выполнить перенос без потери настроек и как диагностировать возникающие проблемы.

Зачем переносить конфигурацию REALITY между Xray и sing-box?

Переход между ядрами может быть вызван разными причинами: желание использовать более лёгкое и быстрое ядро sing-box, необходимость интеграции с другими инструментами, или наоборот — возврат к привычному Xray. Прямое копирование JSON-конфигурации невозможно, так как имена полей, вложенность и даже логика настройки TLS отличаются. Без понимания маппинга придётся долго отлаживать соединение. Знание соответствий помогает перенести конфигурацию за несколько минут, сохранив все ключевые настройки, включая приватные ключи, short_id и параметры flow.

Основные поля REALITY в Xray и sing-box

Для успешного переноса нужно чётко понимать, как в каждом ядре называются и организуются параметры. Ниже приведены таблицы соответствий для серверной (inbound) и клиентской (outbound) частей.

Серверная часть (inbound)

Клиентская часть (outbound)

Пошаговый перенос из Xray в sing-box (сервер)

Рассмотрим реальный фрагмент конфигурации inbound Xray с REALITY:

{
  "protocol": "vless",
  "settings": {
    "clients": [{"id": "uuid", "flow": "xtls-rprx-vision"}],
    "decryption": "none"
  },
  "streamSettings": {
    "network": "tcp",
    "security": "reality",
    "realitySettings": {
      "dest": "addons.mozilla.org:443",
      "serverNames": ["addons.mozilla.org"],
      "privateKey": "PRIVATE_KEY",
      "shortIds": ["abcdefgh"]
    }
  }
}

В sing-box тот же inbound будет выглядеть так:

{
  "type": "vless",
  "listen": "::",
  "listen_port": 443,
  "users": [{"uuid": "uuid", "flow": "xtls-rprx-vision"}],
  "tls": {
    "enabled": true,
    "server_name": "addons.mozilla.org",
    "reality": {
      "enabled": true,
      "handshake": {
        "server": "addons.mozilla.org",
        "port": 443
      },
      "private_key": "PRIVATE_KEY",
      "short_id": "abcdefgh"
    }
  }
}

Шаги конвертации:

1. Из dest извлеките адрес и порт. В sing-box адрес поместите в handshake.server, порт — в handshake.port. Значение SNI (обычно тот же адрес) укажите в server_name.
2. Удалите serverNames. В sing-box используется только одно значение server_name. Если в массиве было несколько доменов, выберите основной.
3. Перенесите privateKey в reality.private_key. Ключ должен быть в формате base64url (как в Xray).
4. Возьмите первый элемент из shortIds и запишите его в reality.short_id. Обратите внимание на регистр: обычно используется hex в нижнем регистре.
5. Опция xver не переносится. В sing-box для поддержки PROXY-протокола настройте accept_proxy_protocol на уровне inbounds.
6. Поле show игнорируйте — оно используется только для отладки.

Пошаговый перенос из Xray в sing-box (клиент)

Клиентская конфигурация Xray (outbound) содержит:

{
  "protocol": "vless",
  "settings": {
    "vnext": [{
      "address": "server.example.com",
      "port": 443,
      "users": [{"id": "uuid", "flow": "xtls-rprx-vision"}]
    }]
  },
  "streamSettings": {
    "network": "tcp",
    "security": "reality",
    "realitySettings": {
      "serverNames": ["addons.mozilla.org"],
      "fingerprint": "chrome",
      "publicKey": "PUBLIC_KEY",
      "shortId": "abcdefgh"
    }
  }
}

В sing-box этому соответствует outbound:

{
  "type": "vless",
  "server": "server.example.com",
  "server_port": 443,
  "uuid": "uuid",
  "flow": "xtls-rprx-vision",
  "tls": {
    "enabled": true,
    "server_name": "addons.mozilla.org",
    "utls": {
      "enabled": true,
      "fingerprint": "chrome"
    },
    "reality": {
      "enabled": true,
      "public_key": "PUBLIC_KEY",
      "short_id": "abcdefgh"
    }
  }
}

Ключевые изменения:

• serverNames превращается в строку server_name.
• fingerprint теперь находится внутри utls.
• publicKey и shortId переходят в reality.public_key и reality.short_id.

Обратный перенос: из sing-box в Xray

Процесс обратной конвертации симметричен. Для сервера объедините server_name и порт из handshake.port в строку dest. server_name заверните в массив serverNames. private_key и short_id преобразуйте в privateKey и shortIds (массив из одного элемента). Для клиента из server_name сделайте массив serverNames или просто строку, поместите utls.fingerprint в fingerprint, а public_key и short_id переименуйте в camelCase.

Типичные ошибки при переносе

Чаще всего проблемы возникают из-за невнимательности или непонимания смысла полей. Вот самые распространённые ошибки:

• Потеря flow. Если вы забыли перенести параметр flow: "xtls-rprx-vision" из клиента или сервера, соединение может установиться, но передача данных будет нестабильной или вообще не заработает, особенно при использовании XTLS.
• Путаница между server_name и handshake.server. В sing-box server_name определяет SNI, который видит клиент, а handshake.server — реальный адрес для поддельного рукопожатия. Если они различаются, клиент будет отправлять неправильный SNI, и сервер REALITY корректно не ответит.
• Неправильный short_id. В Xray shortIds — это массив, а в sing-box short_id — строка. При переносе нужно брать первый элемент. Также проверяйте длину: стандартный short_id — 8 символов (4 байта) в hex.
• Игнорирование spiderX. Некоторые конфигурации Xray используют поле spiderX для обхода ограничений. В sing-box такой опции нет, и если она критична, перенос может быть невозможен без потери функциональности.
• Опечатки в регистре. sing-box строго различает регистр: private_key и privateKey — разные вещи. Проверяйте имена полей по официальной документации.

Диагностика проблем после переноса

Если после переноса соединение не работает или работает нестабильно, действуйте пошагово:

1. Проверьте DNS и SNI. С клиента выполните команду: openssl s_client -connect host:443 -servername server_name. Вы должны увидеть сертификат того сайта, который указан в server_name (например, addons.mozilla.org). Если вы видите свой сертификат или ошибку — SNI неверный.
2. Смотрите логи. В Xray установите "log": {"loglevel": "debug"}. В sing-box — "log": {"level": "debug"}. Обращайте внимание на сообщения о TLS-рукопожатии и REALITY.
3. Проверьте совпадение ключей. На сервере private_key должен соответствовать public_key клиента. Сгенерируйте новую пару ключей (Xray: openssl ecparam -name prime256v1 -genkey -noout -out key.pem и т.д.) и убедитесь, что вы используете правильный формат.
4. Проверьте короткий ID. Убедитесь, что short_id на клиенте совпадает с одним из short_ids сервера. Если сервер настроен на несколько shortIds, клиент должен использовать один из них.
5. Проверьте порт и адрес. Иногда при переносе забывают изменить handshake.port или использовать не тот IP. Убедитесь, что с сервера доступен целевой сайт и порт 443.

Чеклист проверки переноса

Перед тем как считать перенос завершённым, пройдитесь по этому списку:

• ✔️ Параметр flow одинаковый на клиенте и сервере.
• ✔️ Значение server_name клиента есть в serverNames сервера (или совпадает с единственным server_name).
• ✔️ handshake.server доступен и возвращает корректный сертификат.
• ✔️ Используется правильная пара ключей: private_key на сервере, public_key на клиенте.
• ✔️ short_id совпадает (регистр и длина).
• ✔️ В клиенте включён utls с поддерживаемым fingerprint (например, chrome).
• ✔️ Если в Xray была опция xver, она заменена аналогом в sing-box (если нужно).
• ✔️ Проверено, что в конфигурации нет лишних полей, которые могут вызвать ошибки.

Заключение

Перенос REALITY-конфигурации между Xray и sing-box — задача на внимательность и понимание структуры каждого ядра. Используя таблицы соответствий и пошаговые инструкции из этой статьи, вы сможете выполнить миграцию без потери важных параметров. Не забывайте про диагностику и чеклист — это поможет быстро выявить и исправить ошибки. Актуальную информацию о полях всегда сверяйте с официальной документацией, так как реализация может меняться.