Bcrypt 哈希生成器与验证器

什么是 Bcrypt？

// Node.js — bcryptjs / bcrypt (emits $2b$)
const bcrypt = require('bcrypt');
const hash = await bcrypt.hash('correct horse battery staple', 12);
// -> $2b$12$dUSFKqT1FCMYZ6hcQfsxuONizEqcX8IGK8snfVSowP5Uu.TDJoPUq
const ok = await bcrypt.compare('correct horse battery staple', hash); // true

# Python — bcrypt
import bcrypt
hashed = bcrypt.hashpw(b'correct horse battery staple', bcrypt.gensalt(12))
bcrypt.checkpw(b'correct horse battery staple', hashed)  # True

# PHP — password_hash (emits $2y$)
$hash = password_hash('correct horse battery staple', PASSWORD_BCRYPT, ['cost' => 12]);
password_verify('correct horse battery staple', $hash); // true

# Apache htpasswd CLI — bcrypt entry to stdout (-B bcrypt, -b inline, -n stdout)
htpasswd -Bbn admin 'correct horse battery staple'
# -> admin:$2y$12$dUSFKqT1FCMYZ6hcQfsxuONizEqcX8IGK8snfVSowP5Uu.TDJoPUq

核心功能

Bcrypt 生成器示例

password: correct horse battery staple
cost: 12
prefix: $2b$

$2b$12$dUSFKqT1FCMYZ6hcQfsxuONizEqcX8IGK8snfVSowP5Uu.TDJoPUq

password: correct horse battery staple
hash: $2b$12$dUSFKqT1FCMYZ6hcQfsxuONizEqcX8IGK8snfVSowP5Uu.TDJoPUq

✓ 匹配 — 该密码与此哈希一致

$2b$12$dUSFKqT1FCMYZ6hcQfsxuONizEqcX8IGK8snfVSowP5Uu.TDJoPUq

版本: $2b$ · 成本: 12 · 盐值: dUSFKqT1FCMYZ6hcQfsxuO · 摘要: NizEqcX8IGK8snfVSowP5Uu.TDJoPUq

如何使用 Bcrypt 生成器

1. 1

   输入密码并选择成本

   在「生成」选项卡上，输入密码或点击「随机密码」。挑选一个成本因子（4–15；12 是现代默认值）和一个版本前缀——$2b$、$2a$ 或 $2y$——以匹配你的技术栈。

2. 2

   生成哈希

   bcrypt 哈希会在本地用全新的随机盐值计算，并显示为一个 60 字符的 $2b$12$... 字符串。点击「复制」获取它，或重新生成一个新的加盐哈希。

3. 3

   查看结构或验证

   结构面板将哈希拆分为版本、成本、盐值和摘要。切换到「验证」选项卡，粘贴存储的哈希和密码，即可立即确认它们是否匹配。

Common Errors

bcrypt.decrypt(hash)  // no such operation

bcrypt.compare(password, hash)  // returns true / false

cost: 4  // far too fast, weak against brute force

cost: 12  // modern default, resists brute force

hash(pw) === storedHash  // fails — different salts

bcrypt.compare(pw, storedHash)  // correct check

常见使用场景

在数据库中预置密码哈希

为管理员或测试账户生成一个 bcrypt 哈希，直接插入到你的 users 表中，这样你无需先搭建完整的注册流程即可登录。

调试失败的登录

用已知正确的密码验证存储的哈希，确认哈希本身是否正确，从而把 bug 从你的认证代码中隔离出来。

挑选合适的成本因子

在你自己的硬件上以多个成本级别生成哈希以感受各自耗时，再选择一个既能抵御暴力破解又不拖慢真实登录的工作因子。

创建 htpasswd / Basic Auth 条目

为 Apache、Docker Registry 或 Caddy 凭证生成 $2y$ bcrypt 哈希，再将其放入用于 HTTP Basic Auth 的 user:hash 行。

构建测试夹具

生成按密码确定的 bcrypt 哈希，用于预置登录或密码重置流程的集成测试，无需搭建真实的认证服务器。

审计你发现的哈希

读取配置或转储中某个 bcrypt 字符串的结构以检查其成本因子，并用你预期的密码验证它以确认是否匹配。

技术细节

基于 Blowfish，自适应成本

Bcrypt 的哈希源自 Blowfish 密码昂贵的密钥设置过程，重复执行 2^cost 次。成本每加 1，工作量翻倍，使该函数随硬件进步仍能抵御暴力破解。

128 位随机盐值

每个哈希内嵌一个 16 字节（128 位）随机盐值，以 Base64 编码为成本之后的 22 个字符。盐值使每个哈希都唯一，因此相同的密码绝不会共用摘要，彩虹表也无从下手。

自描述的 60 字符格式

输出为 $版本$成本$盐值+摘要——一个固定的 60 字符字符串，承载了验证它所需的全部信息。无需单独的盐值列或参数存储。

72 字节密码上限

Bcrypt 只哈希密码的前 72 字节；超出部分会被静默忽略。对于很长的口令，常见的缓解办法是在 bcrypt 之前先预哈希（例如用 SHA-256）。

验证，而非解密

Bcrypt 是单向的。验证会用从存储哈希中解析出的盐值和成本对候选密码重新运行哈希，再以恒定时间比较摘要。没有任何操作能还原明文。

诚实说明与注意事项

哈希在本地计算，绝不会与实际系统校验。复制的哈希以及你输入的任何密码会留存在剪贴板和浏览器内存中——请将它们视为机密，并在粘贴进生产环境后清空剪贴板。

最佳实践

使用成本 12 或更高

成本 12 是现代基线；在登录延迟仍可接受的前提下，可为敏感系统提高到 14 左右。定期重新评估——五年前足够慢的设置，如今攻击起来已经很廉价。

绝不存储或记录明文

只存储 bcrypt 哈希，绝不存储原始密码，并让密码远离日志和错误信息。如果明文随哈希一同泄露，bcrypt 的全部价值就荡然无存了。

让 bcrypt 处理盐值

Bcrypt 会为你生成并内嵌一个安全的随机盐值。不要提供你自己的静态盐值，也不要重复使用——每次哈希一个随机盐值，正是挫败彩虹表的关键。

留意 72 字节上限

如果你接受长口令，记住 bcrypt 会忽略 72 字节之后的内容。当很长的输入必须被完整覆盖时，可考虑先用 SHA-256 预哈希，或评估 Argon2id。

Bcrypt 生成器常见问题