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 не примет ссылку или конфигурацию, но происхождение конкретных цифр сервер не проверяет.
Упомянутые темы
Похожие материалы
Разделы по теме
Источники
- RFC 9562: Universally Unique IDentifiers (UUID) — обращение 28 сентября 2026
- Документация Happ: примеры ссылок и параметры — обращение 28 сентября 2026
- Документация Xray: исходящее подключение VLESS — обращение 28 сентября 2026