Версии UUID Объяснены

Каждая версия UUID — от v1 до v8 — с диаграммами структуры, случаями использования, риском коллизии и примерами кода JavaScript.

Структура UUID

xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx

time_low (32 bits)time_mid (16 bits)M = version (4 bits) + time_hi (12)N = variant (2 bits) + clock (14)node / random (48 bits)

UUID v1Time-based (MAC)Sortable

Структура

timestamp (60-bit) + clock seq (14-bit) + MAC (48-bit)

Риск коллизии

Very low

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

Преимущества

+Globally unique
+Sortable by time
+Embeds creation time

Недостатки

−Exposes MAC address (privacy risk)
−Requires MAC or pseudo-random node
−Clock adjustments can cause duplicates

Лучше всего подходит для

Legacy systems. Avoid in new projects due to MAC address exposure.

UUID v3Name-based (MD5)Not sortable

Структура

MD5(namespace UUID + name) → UUID

Риск коллизии

MD5 collision risk (low for UUIDs)

6fa459ea-ee8a-3ca4-894e-db77e160355e

Преимущества

+Deterministic — same input = same UUID
+Can recreate UUIDs from known inputs

Недостатки

−MD5 is cryptographically weak
−Not random — attackers can predict given namespace+name
−Prefer v5 for new projects

Лучше всего подходит для

Generating UUIDs from URLs, email addresses, or other stable identifiers. Use v5 instead.

UUID v4RandomNot sortable

Структура

122 random bits + 4-bit version + 2-bit variant

Риск коллизии

Negligible (2^122 possibilities)

550e8400-e29b-41d4-a716-446655440000

Преимущества

+Extremely low collision probability
+No timestamp/MAC leakage
+Simple generation — no state needed
+Most widely supported

Недостатки

−Not sortable by generation time
−Random order degrades B-tree performance in databases
−Cannot verify when a UUID was created

Лучше всего подходит для

Default choice for most applications. IDs for records, sessions, tokens.

UUID v5Name-based (SHA-1)Not sortable

Структура

SHA-1(namespace UUID + name) → UUID (top 128 bits)

Риск коллизии

SHA-1 — extremely low for UUID purposes

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

Преимущества

+Deterministic like v3, but uses SHA-1
+Stronger hash than MD5 (v3)
+Standard namespaces: DNS, URL, OID, X.500

Недостатки

−SHA-1 is fully deterministic — not suitable for secrets
−Truncates SHA-1 to 128 bits

Лучше всего подходит для

Deterministic IDs from a namespace + name. Example: UUID for 'https://example.com' is always the same.

UUID v7Time-ordered RandomSortable

Структура

Unix ms timestamp (48-bit) + version (4-bit) + random (74-bit)

Риск коллизии

Very low (74 random bits)

018f0b2d-4c9e-7abc-89de-f012345678ab

Преимущества

+Sortable by time (great for database primary keys)
+Does NOT expose MAC address
+Near-zero collision probability
+RFC 9562 standard

Недостатки

−Slightly less entropy than v4 (74 vs 122 bits)
−Requires a time source
−Newer — less library support than v4

Лучше всего подходит для

Database primary keys where sort order matters. Replaces v1 for time-ordered UUIDs.

UUID v8CustomSortable

Структура

128 bits, content defined by the implementation

Риск коллизии

Depends on implementation

2489e9ad-f195-8b67-72da-3291d8c9fc1b

Преимущества

+Fully customizable
+Useful for embedding application-specific data

Недостатки

−No standard semantics — interoperability must be documented
−Not widely supported

Лучше всего подходит для

Experimental or vendor-specific use cases where v1–v7 don't fit.

Быстрое Сравнение

Version	Method	Sortable	Privacy-safe	Deterministic
v1	Time + MAC	✅	❌ (MAC leak)	❌
v3	MD5 hash	❌	✅	✅
v4	Random	❌	✅	❌
v5	SHA-1 hash	❌	✅	✅
v7	Time + Random	✅	✅	❌
v8	Custom	—	—	—

Генерация UUID в Коде

// JavaScript / Node.js (built-in, Node 15+)
import { randomUUID } from 'crypto';
const v4 = randomUUID();  // → "550e8400-e29b-41d4-a716-446655440000"

// Browser
const v4 = crypto.randomUUID();

// UUID v7 (npm: uuid package v10+)
import { v7 as uuidv7 } from 'uuid';
const v7 = uuidv7();  // → "018f0b2d-4c9e-7abc-89de-f012345678ab"

// Python
import uuid
v4 = str(uuid.uuid4())  # Random
v5 = str(uuid.uuid5(uuid.NAMESPACE_URL, 'https://example.com'))

# PostgreSQL
SELECT gen_random_uuid();        -- v4 (pg 13+)
SELECT uuid_generate_v4();       -- v4 (uuid-ossp extension)
SELECT gen_random_uuid()::text;  -- as text

FAQ по Версиям UUID

Что такое UUID?

UUID (Universally Unique Identifier) — это 128-битный идентификатор, стандартизированный в RFC 4122. Форматируется как 8-4-4-4-12 шестнадцатеричных символов, разделённых дефисами. Разработан для уникальности в пространстве и времени без центрального органа.

Какую версию UUID использовать?

Используйте v4 для большинства общих целей — генерируется случайно и имеет крайне низкую вероятность коллизии. Используйте v7 для временно упорядоченных UUID в качестве первичных ключей базы данных. Используйте v5 для детерминированных UUID из пары namespace+имя. Избегайте v1 в новых проектах — раскрывает MAC-адрес.

В чём разница между UUID v4 и v7?

UUID v4 полностью случайный (122 случайных бита). UUID v7 кодирует временную метку Unix в первых 48 битах, за которыми следуют случайные биты. Это делает UUID v7 сортируемыми по времени создания, значительно улучшая производительность B-tree индексов.

Действительно ли ID UUID v4 уникальны?

Практически да. UUID v4 имеет 122 случайных бита, давая 2^122 ≈ 5,3 × 10^36 возможных значений. Чтобы иметь 50% шанс коллизии, нужно было бы сгенерировать около 2,7 × 10^18 UUID.

Version

Method

Sortable

Privacy-safe

Deterministic

Time + MAC

✅

❌ (MAC leak)

❌

MD5 hash

❌

✅

Random

❌

✅

❌

SHA-1 hash

❌

✅

Time + Random

✅

❌

Custom

—

Генерация UUID в Коде

// JavaScript / Node.js (built-in, Node 15+)
import { randomUUID } from 'crypto';
const v4 = randomUUID();  // → "550e8400-e29b-41d4-a716-446655440000"

// Browser
const v4 = crypto.randomUUID();

// UUID v7 (npm: uuid package v10+)
import { v7 as uuidv7 } from 'uuid';
const v7 = uuidv7();  // → "018f0b2d-4c9e-7abc-89de-f012345678ab"

// Python
import uuid
v4 = str(uuid.uuid4())  # Random
v5 = str(uuid.uuid5(uuid.NAMESPACE_URL, 'https://example.com'))

# PostgreSQL
SELECT gen_random_uuid();        -- v4 (pg 13+)
SELECT uuid_generate_v4();       -- v4 (uuid-ossp extension)
SELECT gen_random_uuid()::text;  -- as text

FAQ по Версиям UUID

Что такое UUID?

Какую версию UUID использовать?

В чём разница между UUID v4 и v7?

Действительно ли ID UUID v4 уникальны?

Версии UUID Объяснены

Структура UUID

Быстрое Сравнение

Генерация UUID в Коде

FAQ по Версиям UUID

References & cheat sheets

Версии UUID Объяснены

Структура UUID

Быстрое Сравнение

Генерация UUID в Коде

FAQ по Версиям UUID