UUID 생성기

관련 추천

UUID란 무엇인가요?

사용 사례

• 데이터베이스 설계 시 UUID v4를 테이블 레코드 기본키로 생성하여 자동증가 ID로 인한 데이터량 노출 방지
• 분산 시스템 또는 마이크로서비스 아키텍처에서 ULID를 정렬 가능한 전역 고유 요청 추적 ID로 사용
• API 개발 및 연동 테스트 시 UUID를 일괄 생성하여 테스트 데이터와 모의 주문번호·사용자 ID로 사용
• 프론트엔드 단축 URL이나 공유 링크에서 NanoID를 UUID 대신 사용하여 더 짧고 깔끔하며 URL 인코딩 불필요
• UUID v5를 사용하여 고정 네임스페이스에서 결정론적 ID를 생성하고 동일한 입력이 항상 동일한 출력을 내도록 보장
• 디버그 로그나 타사 문서에서 알 수 없는 형식의 ID를 발견했을 때 검증 기능으로 ID 유형과 버전 식별

이용 방법

1. 상단 카드에서 생성할 ID 유형을 선택: UUID v4(권장), v1, v5, ULID 또는 NanoID
2. UUID v5를 선택한 경우 네임스페이스용 문자열을 입력. 다른 ID는 바로 형식 옵션 설정 가능
3. 필요에 따라 대소문자와 하이픈 스위치를 전환하고, 퀵 버튼 또는 슬라이더로 일괄 생성 수량(1~100) 설정
4. 생성 버튼을 클릭하여 결과 목록 확인. 개별 복사, 전체 원클릭 복사, 또는 TXT/JSON 파일로 내보내기 가능
5. 기존 ID를 검증하려면 '검증' 탭으로 전환하여 ID 문자열을 붙여넣으면 유형과 버전 정보 확인 가능

주요 기능

• 5가지 ID를 한 페이지에서 지원: UUID v1(타임스탬프), v4(랜덤), v5(네임스페이스), ULID(정렬 가능), NanoID(URL 안전)를 동시 지원. 하나의 도구로 다양한 기술 스택의 요구 충족
• UUID 검증·식별: 검증 탭으로 전환하여 아무 ID나 붙여넣으면 UUID 버전 또는 ULID/NanoID 형식을 식별. 디버깅 시 빠른 문제 해결
• 최대 100개 일괄 생성: 1~100개 원하는 수량을 한 번에 생성. 테스트 데이터 작성 시 일일이 수동 복사할 필요 없음
• 유연한 형식 전환: UUID의 대소문자와 하이픈을 토글하여 데이터베이스, URL, 설정 파일 등 다양한 시나리오의 형식 요구사항에 맞춤
• 내보내기 및 로컬 히스토리: 전체 원클릭 복사, TXT/JSON 파일 내보내기 지원. 생성 이력은 로컬에 저장되어 언제든 복원 가능하며 일괄 작업이 더 효율적
• 클라이언트 사이드 안전 난수: 브라우저 crypto API로 암호학적으로 안전한 난수를 생성. ID는 기기를 떠나지 않으며 오프라인에서도 작동

코드 예제

// 최신 브라우저 / Node.js 19+
const id = crypto.randomUUID();
console.log(id); // "550e8400-e29b-41d4-a716-446655440000"

// Node.js 14.17 - 18.x
const crypto = require('crypto');
const id = crypto.randomUUID();

import uuid

# 단일 UUID 생성
uid = uuid.uuid4()
print(uid)

# 10개 일괄 생성
for _ in range(10):
    print(uuid.uuid4())

# 하이픈 없는 대문자 UUID 생성
print(uuid.uuid4().hex.upper())

# Linux
uuidgen

# macOS
uuidgen | tr 'A-Z' 'a-z'

# 시스템 랜덤 파일에서 직접 읽기(가장 원시적인 방법)
cat /proc/sys/kernel/random/uuid

유일 ID는 어떤 방식을 선택해야 할까?

UUID만이 유일한 선택은 아닙니다. 데이터베이스 자동증가 ID와 Snowflake도 주요 기본키 방식입니다. 먼저 '데이터 규모, 전역 고유성 필요 여부, 시간순 정렬 필요 여부'를 살펴본 후 구체적인 방식을 선택하면 많은 시행착오를 피할 수 있습니다.

Best Practices

자주 묻는 질문

용어집

UUID

Universally Unique Identifier(범용 고유 식별자). 128비트 길이, RFC 4122 표준. 주요 버전으로는 v1(타임스탬프+MAC), v4(랜덤), v5(SHA-1 해시)가 있다.

GUID

Globally Unique Identifier(전역 고유 식별자). 마이크로소프트에서 UUID를 부르는 명칭으로, 형식과 용도가 완전히 동일하다.

ULID

Universally Unique Lexicographically Sortable Identifier(사전순 정렬 가능한 범용 고유 식별자). 26자로 Crockford Base32 인코딩을 사용하며, 처음 48비트가 타임스탬프로 생성 시간순으로 정렬 가능하다.

NanoID

경량 고유 ID 생성 방식. 기본 21개의 URL 안전 문자(A-Za-z0-9_-)를 사용하며, UUID보다 짧고 빨라 프론트엔드와 URL 시나리오에 적합하다.

UUID v1

타임스탬프와 MAC 주소 기반의 UUID 버전. 시간순 정렬이 가능하지만 MAC 주소와 생성 시간이 노출될 수 있어 v4보다 보안성이 낮다.

UUID v4

완전히 난수 기반으로 생성되는 UUID 버전. 가장 널리 사용되며 충돌 확률이 극히 낮아 개발에서 기본 선택이다.

UUID v5

SHA-1 해시 기반의 네임스페이스 UUID 버전. 동일한 네임스페이스+동일한 이름 입력은 동일한 UUID 출력을 생성하여 결정론적 시나리오에 적합하다.

충돌 확률

무작위로 생성된 두 ID가 우연히 동일할 확률. UUID v4의 충돌 확률은 약 170억 분의 1조 분의 1로 실제 엔지니어링에서 무시할 수 있다.

Crockford Base32

Douglas Crockford가 설계한 Base32 인코딩으로, I/L/O/U를 제외한 대문자와 숫자를 사용하여 혼동하기 쉬운 문자를 피한다. ULID에서 사용된다.

UUID / ULID / NanoID 비교표

언어별 UUID 생성 방법

Authoritative References

• IETFRFC 4122 - UUID 명세
• GitHubULID 명세 (GitHub)
• OfficialNanoID 공식 사이트