KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #open-source #ai #claude-code #codex #developer-tools #react #windows #deepseek-harness #ai-agent

nanoid

★ 26,935 Open GitHub ↗

JavaScript를 위한 초소형(118 bytes), 안전하고 URL 친화적이며 고유한 문자열 ID 생성기

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Nano ID
![Nano ID logo by Anton Lovchikov](https://ai.github.io/nanoid/logo.svg)
\*\*English\*\* | [日本語](./README.ja.md) | [Русский](./README.ru.md) | [简体中文](./README.zh-CN.md) | [Bahasa Indonesia](./README.id-ID.md) | [한국어](./README.ko.md) | [العربية](./README.ar.md)
JavaScript를 위한 작고, 안전하며, URL에 친화적인 고유 문자열 ID 생성기입니다.
> “존경하지 않을 수 없는,
> 놀라울 정도로 무분별한 완벽주의.”
- \*\*작은 크기.\*\* 118바이트 (최소화 및 Brotli 압축 적용). 의존성 없음.
[Size Limit]을 통해 크기를 제어합니다.
- \*\*빠른 속도.\*\* 기본 `crypto.randomUUID()`보다 50% 더 빠릅니다.
- \*\*안전성.\*\* 하드웨어 난수 생성기를 사용합니다. 클러스터 환경에서 사용할 수 있습니다.
- \*\*짧은 ID.\*\* UUID보다 더 큰 알파벳 세트를 사용합니다 (`A-Za-z0-9\_-`).
따라서 ID 크기가 36개 문자에서 21개 문자로 줄어들었습니다.
- \*\*높은 호환성.\*\* Nano ID는 [20개 이상의 프로그래밍 언어](./README.md#other-programming-languages)로 포팅되었습니다.
```js
import { nanoid } from 'nanoid'
model.id = nanoid() //=> "V1StGXR8\_Z5jdHi6B-myT"
```
---
![](https://cdn.evilmartians.com/badges/logo-no-label.svg)  Nano ID는 **개발자 도구, AI 및 사이버 보안 스타트업**을 위한 미국의 디자인 및 엔지니어링 컨설팅 기업인 **[Evil Martians](https://evilmartians.com/)**에서 만들었습니다.
---
[Size Limit]: https://github.com/ai/size-limit
## 목차
- [목차](#table-of-contents)
- [UUID와의 비교](#comparison-with-uuid)
- [벤치마크](#benchmark)
- [보안](#security)
- [설치](#install)
- [JSR](#jsr)
- [CDN](#cdn)
- [API](#api)
- [커스텀 알파벳 또는 크기](#custom-alphabet-or-size)
- [커스텀 난수 바이트 생성기](#custom-random-bytes-generator)
- [보안되지 않음](#non-secure)
- [사용법](#usage)
- [React](#react)
- [React Native](#react-native)
- [PouchDB 및 CouchDB](#pouchdb-and-couchdb)
- [CLI](#cli)
- [TypeScript](#typescript)
- [기타 프로그래밍 언어](#other-programming-languages)
- [도구](#tools)
## UUID와의 비교
Nano ID는 UUID v4(랜덤 기반)와 상당히 유사합니다.
ID에 포함된 랜덤 비트 수가 비슷하고
(Nano ID는 126비트, UUID는 122비트), 충돌 확률도 비슷합니다.
> 10억 분의 1의 중복 확률이 발생하려면,
> 103조 개의 버전 4 ID가 생성되어야 합니다.
Nano ID와 UUID v4 사이에는 두 가지 주요 차이점이 있습니다.
1. Nano ID는 더 큰 알파벳을 사용하므로, 유사한 수의 랜덤 비트가 36개가 아닌 단 21개의 문자에 압축되어 들어갑니다.
2. Nano ID는 `crypto.randomUUID` 및 `uuid/v4`보다 빠릅니다.
## 벤치마크
```rust
$ node ./test/benchmark.js
nope-id 20,386,830 ops/sec
nanoid 20,434,827 ops/sec
customAlphabet 20,544,476 ops/sec
crypto.randomUUID 12,865,759 ops/sec
uuid v4 7,930,104 ops/sec
@napi-rs/uuid 5,573,171 ops/sec
uid/secure 6,308,267 ops/sec
@lukeed/uuid 5,278,597 ops/sec
nanoid for browser 311,497 ops/sec
secure-random-string 301,667 ops/sec
uid-safe.sync 297,815 ops/sec
Non-secure:
uid 20,286,757 ops/sec
nanoid/non-secure 2,397,594 ops/sec
rndm 2,445,462 ops/sec
```
## 보안
\_난수 생성기 이론에 관한 좋은 글을 참고하세요:
[안전한 난수 값 (Node.js 환경)]\_
- \*\*예측 불가능성.\*\* 안전하지 않은 `Math.random()`을 사용하는 대신, Nano ID는 Node.js의 `crypto` 모듈과 브라우저의 Web Crypto API를 사용합니다.
이 모듈들은 예측할 수 없는 하드웨어 난수 생성기를 사용합니다.
- \*\*균등성.\*\* ID 생성기를 코딩할 때 `random % alphabet`을 사용하는 것은 흔한 실수입니다. 이 경우 분포가 고르지 않게 되며, 특정 문자가 다른 문자보다 나타날 확률이 낮아집니다. 결과적으로 무차별 대입(brute-forcing) 시도 횟수가 줄어들게 됩니다. Nano ID는 [더 나은 알고리즘]을 사용하며 균등성 테스트를 거쳤습니다.
![Nano ID 균등성](img/distribution.png)

nanoid

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README