Генератор и декодер UUID — v1, v4, v5, v7

Что такое UUID?

// Generate a UUID v4 using the Web Crypto API
const uuid = crypto.randomUUID();
console.log(uuid);
// → '550e8400-e29b-41d4-a716-446655440000'

// Manual v4 generation with crypto.getRandomValues()
function generateUUIDv4() {
  const bytes = new Uint8Array(16);
  crypto.getRandomValues(bytes);
  bytes[6] = (bytes[6] & 0x0f) | 0x40; // version 4
  bytes[8] = (bytes[8] & 0x3f) | 0x80; // variant 10
  const hex = Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('');
  return `${hex.slice(0,8)}-${hex.slice(8,12)}-${hex.slice(12,16)}-${hex.slice(16,20)}-${hex.slice(20)}`;
}

Ключевые возможности

Сравнение версий UUID

Выберите подходящую версию UUID под ваш сценарий.

UUID и другие форматы ID

Примеры версий UUID

550e8400-e29b-41d4-a716-446655440000

01906b5e-4a3e-7234-8f56-b8c12d4e5678

6ba7b810-9dad-11d1-80b4-00c04fd430c8

886313e1-3b8a-5372-9b90-0c9aee199e5d

Как использовать

1. 1

   Выберите версию UUID

   Выберите v1 (на основе времени), v3 (MD5 на основе имени), v4 (случайный), v5 (SHA-1 на основе имени) или v7 (упорядоченный по времени со случайными данными). Каждая версия решает свою задачу — v4 чаще всего применяется для общих сценариев.

2. 2

   Настройте параметры

   Для v3 и v5 выберите namespace (DNS, URL, OID, X.500 или пользовательский) и введите имя для хеширования. Укажите количество от 1 до 50 и выберите формат вывода: строчные буквы, ПРОПИСНЫЕ, без дефисов или фигурные скобки {GUID}.

3. 3

   Сгенерируйте UUID

   Нажмите кнопку «Сгенерировать». Каждый UUID создаётся с помощью Web Crypto API (crypto.getRandomValues()) с криптографической стойкостью. Поля версии — timestamp (v1/v7) и хеши (v3/v5) — кодируются корректно.

4. 4

   Скопируйте и используйте

   Нажмите кнопку «Скопировать» рядом с любым UUID, чтобы поместить его в буфер обмена, или «Скопировать всё», чтобы получить все сгенерированные UUID разом. Переключитесь на вкладку «Декодировать», чтобы проанализировать существующий UUID — его версию, вариант, timestamp и другую встроенную информацию.

Типичные сценарии

Первичные ключи БД

Используйте UUID v4 или v7 как уникальные первичные ключи без координации между узлами БД. UUID v7 особенно хорош, потому что его упорядоченность по времени улучшает производительность B-tree индексов.

Распределённые системы

Генерируйте уникальные идентификаторы независимо в микросервисах, очередях сообщений и системах event sourcing. UUID устраняют необходимость в централизованном сервисе генерации ID.

Разработка API

Создавайте уникальные ID запросов, correlation ID и ключи идемпотентности для REST и GraphQL API. UUID упрощают трассировку запросов между распределёнными сервисами.

Управление сессиями и токенами

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

Тестирование и разработка

Быстро генерируйте тестовые данные, mock-идентификаторы и уникальные ID фикстур для автоматических тестов. Пакетная генерация упрощает заполнение dev-баз и тестовых наборов.

Технические детали

Структура UUID

UUID — это 128 бит (16 байт), представленные как 32 шестнадцатеричных символа в формате 8-4-4-4-12. Биты 48-51 (13-я шестнадцатеричная цифра) кодируют номер версии. Биты 64-65 кодируют поле варианта, идентифицирующее раскладку UUID. Остальные биты несут payload, специфичный для версии: timestamp, случайные данные или хеш.

Биты версии

Биты 48-51 (старший nibble 7-го байта) кодируют версию UUID: 0001 = v1 (на основе времени), 0011 = v3 (MD5 на основе имени), 0100 = v4 (случайный), 0101 = v5 (SHA-1 на основе имени), 0110 = v6 (переупорядоченное время), 0111 = v7 (Unix epoch). Эти четыре бита всегда устанавливаются явно при генерации.

Поле варианта

Биты 64-65 (два старших бита 9-го байта) определяют вариант. Шаблон 10x — UUID по RFC 4122/9562 (подавляющее большинство). Шаблон 110 — Microsoft GUID со смешанным порядком байт. Шаблон 0xx — UUID NCS обратной совместимости (legacy). Шаблон 111 зарезервирован.

Стандарт RFC 9562

RFC 9562, опубликованный в мае 2024, заменяет RFC 4122 как окончательную спецификацию UUID. Формально вводит UUID версий 6, 7 и 8. Версия 6 переупорядочивает поля v1 для сортируемости. Версия 7 использует 48-битный Unix timestamp в миллисекундах плюс случайные данные — рекомендуемая версия для новых UUID на основе времени. Версия 8 даёт формат для пользовательских UUID конкретной реализации. RFC 9562 также формально объявляет v1 устаревшей в пользу v6/v7.

Лучшие практики

Выбирайте подходящую версию

Используйте v4 для уникальных идентификаторов общего назначения, где не нужны порядок или детерминированность. Используйте v7 для первичных ключей БД — упорядоченность по времени даёт значительно лучшую производительность индексов. Используйте v5, когда нужны детерминированные ID на основе имён (предпочтительнее v3 ради более стойкого хеширования).

UUID v7 — для первичных ключей БД

Упорядоченная по времени структура UUID v7 держит вставки B-tree последовательными, снижая фрагментацию индекса примерно на 90% по сравнению со случайными UUID v4. Это означает более быстрые записи, меньшие индексы и лучшее использование кеша. Современные БД (PostgreSQL 17+, MySQL 8.0+) имеют нативную поддержку UUID, оптимизированную под этот шаблон.

Не используйте UUID как токены безопасности

UUID спроектированы для уникальности, а не секретности. UUID v1 раскрывает timestamp генерации и MAC-адрес. UUID v4 имеет только 122 бита энтропии при предсказуемой структуре. Для токенов безопасности, API-ключей или секретов сессий используйте специализированный CSPRNG для генерации 128 или 256 бит чистых случайных данных без накладных расходов структуры UUID.

Проверяйте перед разбором

Всегда проверяйте формат UUID регулярным выражением перед разбором или сохранением. Отвергайте некорректные входы на границах системы — endpoint API, формы, входы в БД. Это предотвращает инъекционные атаки, повреждение данных и трудно отлаживаемые ошибки от невалидных идентификаторов.

Часто задаваемые вопросы