Happ VPN

UUID: что это

Автор
Екатерина Лебедева, редактор раздела knowledge base
Проверил:
Артём Волков
Проверено:
Опубликовано:
, обновлено
Версия гайда:
1.0

Коротко

UUID — стандартный 128-битный идентификатор в формате из 32 шестнадцатеричных знаков, который в VLESS и VMess служит логином клиента. В Happ он идёт сразу после символа @ в ссылке сервера и одновременно определяет, кого сервер пускает к себе.

UUID (universally unique identifier) — общий стандарт для уникальных идентификаторов, а не изобретение Xray-core: он описан в отдельном RFC и используется в базах данных, операционных системах и множестве протоколов. Записывается как 32 шестнадцатеричных знака, разделённых дефисами на пять групп. В VLESS и VMess сервер сравнивает присланный клиентом UUID со своим списком пользователей и обслуживает только совпадения. Формально существует несколько версий UUID — случайные, основанные на времени или на хэше, — но для проверки клиента Xray-core версия значения не важна: важно само совпадение строки.

UUID — стандартный 128-битный идентификатор, который принято записывать как 32 шестнадцатеричных знака в пяти группах через дефис. В протоколах VLESS и VMess он служит идентификатором клиента: сервер сравнивает присланный UUID со своим списком пользователей.

Суть термина

UUID расшифровывается как universally unique identifier — уникальный идентификатор, который можно создать где угодно, без обращения к центральному реестру, и почти наверняка не столкнуться с повторением. Стандарт описан в отдельном RFC и старше, чем сами протоколы VLESS и VMess: его используют базы данных, файловые системы и множество сетевых сервисов, никак не связанных с прокси.

Записывается UUID всегда одинаково: 32 шестнадцатеричных знака (цифры и буквы от a до f), разбитые дефисами на пять групп длиной 8-4-4-4-12. Пример из документации и примеров на этом сайте — 00000000-0000-0000-0000-000000000000.

Существует несколько версий UUID: одни строятся на случайных числах, другие — на текущем времени, третьи — на хэше от имени и пространства имён. Для протоколов VLESS и VMess это различие не играет роли: сервер не анализирует, как получено значение, а просто сравнивает присланную строку со своим списком пользователей.

Роль UUID в VLESS и VMess

В обоих протоколах UUID выполняет одну и ту же задачу — опознаёт клиента у сервера, — но с разными дополнительными проверками.

ПротоколЧто проверяет серверДополнительная проверка
VLESSСовпадение UUID со списком пользователейНет — протокол не хранит состояние сессии
VMessСовпадение UUID со списком пользователейМетка времени: часы клиента и сервера не должны расходиться больше чем на 120 секунд

Поэтому неточные часы устройства мешают подключению по VMess, но не по VLESS — разница именно в том, что VMess использует UUID вместе с временной меткой для шифрования и защиты от повторной отправки пакетов, а VLESS полагается на внешний слой TLS или Reality.

В обоих случаях UUID фактически работает как пароль: тот, кто им завладеет, сможет подключаться от имени законного клиента, пока администратор не заменит идентификатор.

Как это выглядит в Happ

В ссылках vless:// и vmess://, которые принимает Happ, UUID — первая часть после схемы и перед символом @, сразу перед адресом сервера. Например, в ссылке vless://00000000-0000-0000-0000-000000000000@example.com:443?... идентификатором клиента служит именно часть до @.

При ручном вводе сервера — кнопка «+» → «Ручной ввод» → выбор протокола — поле для UUID отдельное и заполняется значением, которое выдал администратор сервера или провайдер. Если скопировать его с ошибкой или обрезать при вставке, Happ покажет ошибку конфигурации при импорте ссылки или не сможет подключиться к уже добавленному серверу.

В подписке UUID скрыт внутри ссылок каждого сервера и отдельно не показывается, если только подписка не зашифрована — тогда пользователю недоступны и адрес, и параметры серверов вовсе.

Чем UUID отличается от похожих терминов

UUID легко перепутать с другими идентификаторами, которые тоже выглядят как случайный набор символов.

ТерминЧто определяетОтличие от UUID
HWIDКонкретное устройство пользователяПривязывает лимитированную ссылку к устройству, а не к учётной записи на сервере
Provider IDПровайдера в системе статистики HappОтносится к провайдеру целиком, а не к одному клиенту сервера
Публичный ключ Reality (pbk)Сервер, а не клиентаПроверяет клиенту подлинность сервера, а не наоборот

Все эти значения в ссылках Happ выглядят похоже — длинные строки символов, — но отвечают за разное: UUID определяет, кого сервер пускает к себе по протоколу VLESS или VMess, и в этом смысле он ближе всего к паролю, а не к техническому идентификатору оборудования или провайдера.

Главное

  • UUID — общий сетевой стандарт для уникальных идентификаторов, а не собственная разработка Xray-core или Happ.
  • Формат UUID — 32 шестнадцатеричных знака в пяти группах через дефис, например 00000000-0000-0000-0000-000000000000.
  • В ссылках VLESS и VMess UUID стоит сразу после символа @ и играет роль логина клиента у сервера.
  • Существует несколько версий UUID — случайные и основанные на времени, — но для проверки клиента в VLESS и VMess версия значения не имеет значения.
  • UUID отличается от HWID: UUID определяет пользователя у сервера Xray-core, а HWID привязывает лимитированную ссылку к конкретному устройству.

Частые вопросы

Что такое UUID и откуда он берётся?

UUID — сокращение от universally unique identifier, стандартного способа создавать идентификаторы, которые почти никогда не повторяются даже без центрального реестра. Стандарт описан в отдельном RFC и применяется далеко за пределами VPN-протоколов — в базах данных, файловых системах, операционных системах. В контексте VLESS и VMess UUID выдаёт администратор сервера или провайдер при создании учётной записи для клиента.

Чем отличаются версии UUID, например v4 и v7?

Версии описывают, как именно генерируется значение: v4 — случайные 128 бит, v7 — новее и включает метку времени создания для сортировки по порядку. Для VLESS и VMess это различие не имеет практического значения: сервер просто сравнивает присланную строку со своим списком, не проверяя, по какому алгоритму она получена.

Почему в примерах используют 00000000-0000-0000-0000-000000000000?

Это так называемый нулевой UUID — служебное значение из того же стандарта, состоящее целиком из нулей. Его удобно использовать в примерах ссылок и документации именно потому, что он никогда не выдаётся реальному пользователю и явно не является рабочим идентификатором. Настоящий UUID сервера выглядит так же по формату, но состоит из случайных шестнадцатеричных знаков.

Можно ли использовать один UUID на нескольких серверах?

Технически да: сервер проверяет только совпадение со своим списком, и один и тот же UUID можно добавить в настройки нескольких независимых серверов. На практике администраторы обычно выдают разные UUID разным клиентам одного сервера, чтобы иметь возможность отключить доступ одному человеку, не трогая остальных.

Чем UUID в Happ отличается от HWID?

UUID — часть протокола VLESS или VMess: он определяет, какого клиента видит сервер Xray-core, и указывается в ссылке или JSON-конфигурации. HWID — отдельный механизм на уровне провайдера, который привязывает лимитированную ссылку к конкретному устройству, чтобы её нельзя было использовать сразу с нескольких телефонов или компьютеров. Один сервер может использовать оба механизма одновременно, а может не использовать HWID вовсе.

Проверяет ли Xray-core, что UUID имеет правильный формат версии?

Нет, для аутентификации клиента в VLESS и VMess важно только совпадение строки со списком на сервере, а не то, соответствует ли она правилам конкретной версии стандарта. Формат из 32 шестнадцатеричных знаков в пяти группах через дефис соблюдать нужно, иначе Happ не примет ссылку или конфигурацию, но происхождение конкретных цифр сервер не проверяет.

Упомянутые темы

Разделы по теме

Источники

  1. RFC 9562: Universally Unique IDentifiers (UUID) — обращение 28 сентября 2026
  2. Документация Happ: примеры ссылок и параметры — обращение 28 сентября 2026
  3. Документация Xray: исходящее подключение VLESS — обращение 28 сентября 2026