这是两种标识符
经典 CUID(常叫 CUID v1)是 25 个字符,以字母 c 开头。它让多个 worker 在没有中心序列的情况下发号,并且可以直接放进 HTML id 或 URL。各段可以读出来:时间戳、计数器、主机指纹和随机字符。
CUID2 是同一作者后来的设计。它故意把计数器、主机和时间藏进哈希,因为可读的计数器会让看过几个 id 的人猜出下一个。CUID2 不能按时间排序。官方库(@paralleldrive/cuid2)默认 24 个字符,以 a 到 z 中的随机字母开头,并把熵、会话计数器、主机指纹和时间一起哈希。
经典 CUID 怎么切
原始布局是一个字母,后面是 base36 文本。base36 使用数字和小写字母。毫秒时间戳目前是 8 个字符。在毫秒数达到 36^8 之前,也就是 2059 年之前,它都是 8 位。计数器段 4 个字符,指纹段 4 个,随机段 8 个,分成两组 4 个字符。1 + 8 + 4 + 4 + 8 = 25。
下面的例子用来看结构,不是保证按钮会打出这一串。lqu5m2o0 是 1704067200000 的 base36,对应 2024-01-01T00:00:00.000Z。计数器 004h 是一个补齐到 4 位的小 base36 整数。在服务器上,指纹来自进程号和主机名。在这个浏览器里,指纹是固定标签 devf,因为网页没有进程号。最后 8 个字符是随机 base36。
c prefix, so the id can be an HTML identifier
lqu5m2o0 timestamp, base36 of 1704067200000
004h counter block, padded to 4
devf fingerprint block, 4 characters
1k2m9p0q random block, 8 characters of base36
clqu5m2o0004hdevf1k2m9p0qCUID2 改了什么,本页又生成什么
官方 CUID2 不能解回时间、计数器或主机。这些输入被密码学哈希混合后再写成 base36。第一个字符从 a 到 z 里选,这样即使哈希本来会以数字开头,id 仍然是合法的 HTML 标识符。长度是安全参数。对 24 字符的 id,如果首字符是 26 个字母之一,其余 23 个是均匀的 base36,空间是 26 x 36^23,大约 124 位。更短的 id 空间更小。库的作者把 24 当作大型应用的默认值,很短的长度则需要你自己说明理由。
本页的 CUID2 控件演示的是这个形状,不是 @paralleldrive/cuid2 的构建。它始终以 c 开头,用一个小型非密码学哈希混合时间、计数器和 Math.random,再用 Math.random 补到你设定的长度(4 到 32,默认 24)。不要把 124 位这句用在本页生成的值上。生产环境请使用官方包:密码学哈希,以及随机的首字母。
该用哪一种
- id 会出现在 URL 或 API 里,并且你不希望旁观者看出时间、主机或计数器时,用官方 CUID2。
- 只有现有系统已经存了那种 25 字符形式时,才用经典 CUID。新工作不应该优先选它:计数器和时间戳是可见的。
- id 必须在数据库索引里按创建时间排序时,用 ULID。两种 CUID 都不是排序键。
- 需要 64 位整数,并且能分配不重复的 worker id 时,用 Snowflake。
常见坑
- 本页生成的 CUID v1 与所有其他访问者共用指纹 devf。演示可以。它不能代替会给主机做指纹的服务器生成器。
- 本页的计数器在一个很小的 base36 范围内回绕。它只避免同一个浏览器标签里的重复,不和其他标签或其他机器协调。
- 本页上的 CUID2 长度不是免费的熵。滑块改变你看到的字符数。官方的碰撞计算只适用于官方生成器。
- 不要把任何一种当作密码或会话密钥。它们是标识符。id 泄露是设计里已经接受的事。
- 给一列 CUID2 排序不等于按时间排序。需要这个顺序时,另存时间戳,或改用 ULID。
CUID 和本站其他 id
| CUID v1 | CUID2(官方) | ULID | |
|---|---|---|---|
| 长度 | 25 个字符 | 默认 24,可配置 | 26 个字符 |
| 以字母开头 | 始终是 c | a-z 中的随机字母 | 常常是数字 |
| 能读出时间 | 能,base36 毫秒 | 不能,在哈希里面 | 能,前 10 个字符 |
| 按时间排序 | 大致可以,直到时间戳多出一位 | 不能 | 能 |
| 隐藏主机和计数器 | 不隐藏 | 隐藏 | 没有主机 id |
问题
经典 CUID 为什么以 c 开头?
为了让这个值成为合法的 HTML 和 CSS 标识符。这类标识符不能以数字开头。c 是固定前缀,不是校验和。
能从 CUID v1 读出时间吗?
能。去掉开头的 c,把接下来的 8 个 base36 字符读成毫秒时间戳,前提是时间戳仍然是 8 位。例子 lqu5m2o0 解码为 2024-01-01T00:00:00.000Z。2059 年之后时间戳变成 9 位,固定切 8 位就会错。
本页的 CUID2 是官方算法吗?
不是。官方 CUID2 使用密码学哈希和随机首字母。本页展示的是这个想法:一个字母,后面是哈希后的主体,长度可以改。应用里请使用官方库。
长度为 24 的官方 CUID2 空间有多大?
大约 124 位:首字符是 26 个字母之一,其余 23 个字符各自是均匀的 base36,即 log2(26) + 23 x log2(36)。和 UUID 同一个数量级。长度更短,空间就更小。
主键该用 CUID2 还是 ULID?
不可预测比顺序更重要时用 CUID2。索引应该跟着创建时间走时用 ULID。它们解决的是不同的问题,本站两种都能生成。