htpasswd 生成器

在线生成 htpasswd 行:bcrypt $2y$、SHA-512 crypt、APR1 等格式,标明你的 Nginx 或 Apache 能否读取,还能用已有 htpasswd 文件验证密码、增删用户。

  • 在浏览器中处理
  • 工具不会把输入上传到 ZeroTool 服务器
  • 免费 · 无需注册
用户名最多 255 个 UTF-8 字节。哈希前会拒绝冒号、以 # 开头、控制字符及首尾空白。
输入密码,或点随机生成 20 位密码。按 UTF-8 哈希;bcrypt 只使用前 72 字节,CRYPT 只使用前 8 字节。超过 255 字节会被拒绝。
选择服务器能读取的格式,再点生成。结果区直接显示兼容性说明;仅用于迁移的不安全格式单独分组。
哈希设置
bcrypt 强度范围为 4–17,默认 10。数值越大,计算越慢;强度 17 可能需要多秒。

哈希在本标签页内计算。用户名、密码和文件不会发送,也不会保存。

生成的行 把完整的 username:hash 行复制到 htpasswd 文件。修改用户名、密码或哈希设置会清除生成的行,编辑后需再次点生成。

批量生成多个用户每行一个 user:password
每行填写 user:password,再点批量生成。第一个冒号分隔用户名;忽略空行和以 # 开头的行,跳过无效或重复用户。
使用已选格式和哈希设置。

检查或编辑 htpasswd 文件验证密码,增加、更新或删除用户
粘贴 htpasswd 内容,或打开不超过 1 MiB 的本地文本文件。编辑后表格自动更新,标出重复用户、不可读取的哈希及其他行问题。编辑只在当前标签页生效。
验证使用已填用户名;用户名为空且文件只有一条用户记录时自动选中。只验证第一个匹配行;增加或更新会替换该用户的全部行,删除会移除所有匹配行。

这几个按钮使用已填的用户名、密码和已选格式。

示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。

先确认服务器能读哪种格式

Apache 的 Password Formats 列出 bcrypt($2y$)、APR1 MD5($apr1$)、SHA-1({SHA})、CRYPT 和明文,htpasswd 手册 另有 SHA-256、SHA-512 crypt(-2、-5)。Nginx 的 auth_basic_user_file 自己处理 $apr1$、{SHA}、{SSHA}、{PLAIN},其余交给系统 crypt();Apache 除 $2a$、$2y$、$apr1$、{SHA} 外同样交给 crypt()(APR apr_passwd.c 的 apr_password_validate)。

所以 Nginx 能不能用 bcrypt 取决于操作系统。2026-10-01 我们用 Docker 镜像里的系统 crypt() 逐一验证:

系统bcrypt $2y$SHA-512 / SHA-256 cryptCRYPT
CentOS 7.9(glibc 2.17)不支持支持支持
Ubuntu 18.04不支持支持支持
Ubuntu 20.04 / 22.04 / 24.04支持支持支持
Debian 11 / 12 / 13支持支持支持
AlmaLinux 9.8支持支持支持

再把本工具生成的行放进 Nginx 1.29.8(Debian 13 与 Alpine 3.23 镜像)和 Apache 2.4.68,用 curl -u 登录:bcrypt、SHA-512、SHA-256、APR1、SHA-1、CRYPT 全部通过;无前缀的明文两边都失败,{PLAIN} 只有 Nginx 接受。国内不少服务器还在跑 CentOS 7,在这类机器上给 Nginx 配 Basic 认证,选 SHA-512 crypt 最稳妥:轮数可调,又不依赖系统的 bcrypt 支持。

示例:同一个密码的三种写法

用户 admin,密码 春眠不觉晓-2026(盐是随机的,你生成的结果会不同):

admin:$2y$10$3LD7z4FEQ30ifzeHhZ87EOQCSf5leTn8lq.xcZedcGbgPvlZ7G1oe
admin:$6$c/1gv6vIDsCOui.D$x6wo6Gy9VzP7dl8C1I8ww19k3JPp4wVtCfcGgQh7PaB/J8wmiMajLV8c9Eyu8rrLadpr.fhNXIrpidWD4Xtx10
admin:$apr1$XZpeiq1G$KCu7/cf7Tz6ysV42CPgYZ1

三行都通过 Apache 的 htpasswd -vb 文件 admin 春眠不觉晓-2026 校验(输出 Password for user admin correct.);SHA-512 那一行在 httpd:2.4 容器里校验,因为 macOS 的 htpasswd 不支持 SHA-2 crypt。这个密码含 5 个汉字,按 UTF-8 共 20 字节,工具会提示「按 UTF-8 的 20 字节哈希」。

再换一个 29 个汉字的长密码选 bcrypt,工具会提示:

bcrypt 只取前 72 字节;这个密码有 87 字节,后面的部分不起作用。

也就是说,只要前 24 个汉字相同,后面写什么都能登录。需要长中文口令时改用 SHA-512 crypt,它没有这个限制。

检查已有文件

把文件粘贴进 检查或编辑 htpasswd 文件,每个用户行都会标出格式和提示,例如:

# 测试环境
admin:$2y$10$3LD7z4FEQ30ifzeHhZ87EOQCSf5leTn8lq.xcZedcGbgPvlZ7G1oe
admin:$apr1$XZpeiq1G$KCu7/cf7Tz6ysV42CPgYZ1
test:$apr1$XZpeiq1G$KCu7/cf7Tz6ysV42CPgYZ1  
  • 第 3 行与第 2 行同名。实测 Apache 和 Nginx 都只用第一条匹配的行,第 3 行改了也不生效。
  • 第 4 行哈希后面有两个空格:Apache 读行时去掉,Nginx 把空格算进哈希,每次登录都失败。

填好用户名、密码后点 验证密码,会告诉你密码与哪一行匹配;增加或更新用户 与 htpasswd -b 一致:同名的每一行原地替换,注释和空行保留,新用户追加到末尾,换行符(LF 或 CRLF)不变;删除用户 与 htpasswd -D 一致,删掉该用户的所有行。处理后的内容直接写回文本框,可复制或下载。

用户名的几个坑

  • 用户名不能含 ::冒号是用户名和哈希的分隔符,htpasswd 遇到这种名字直接退出(退出码 6)。不少在线生成器照样输出 a:b:$apr1$…,Apache 会把它读成用户 a。
  • 以 # 开头的行在 Apache 和 Nginx 里都是注释,这个用户永远登录不了。
  • 首尾空格:Apache 会去掉行首空格,Nginx 不会,两边看到的用户名不一样。
  • 中文用户名可以用,但服务器按字节比较,客户端必须按 UTF-8 发送。

与其他在线 htpasswd 生成器的区别

2026-10-01 用桌面版 Chromium 实测,并记录页面发出的网络请求:

  • 在线工具大全 lddgo.net(cn.bing.com 搜「htpasswd 在线生成」第一)点击生成时,把用户名、密码和算法以 JSON 发到 /api/Htpasswd,在服务器端计算。用户名填 a:b 照样输出 a:b:$apr1$…。
  • web2generators.com(Bing 英文结果第一)同样把用户名和密码 POST 到自己的服务器,只有 MD5。

本工具只在浏览器里计算;能用已有的行验证密码,能指出 Apache 与 Nginx 读法不同的行,并写明每种格式哪些服务器能读。

限制

  • 生成的格式是 Apache htpasswd 能写的 7 种,加上 $2a$ 和 {PLAIN}。验证时另外支持 $1$ MD5 crypt 和 {SSHA};yescrypt($y$)、scrypt、$2x$ 只能识别,不能在浏览器里验证。
  • bcrypt 强度 4–17(APR 的上限),SHA-2 轮数这里限 1000–1000000。强度 17 在浏览器里要算很多秒。
  • 文件编辑只处理文本,不会写到服务器上。
  • Digest 认证的 htdigest 文件是另一种格式,不支持。

FAQ

该选哪种格式?Nginx 上用 bcrypt 一直登录失败怎么办?

服务器能读就用 bcrypt $2y$,Apache 2.4 在任何平台上都能读。Nginx 自己只实现了 $apr1$、{SHA}、{SSHA} 和 {PLAIN},bcrypt 要交给操作系统的 crypt()。实测 CentOS 7.9(glibc 2.17)和 Ubuntu 18.04 的 crypt() 不认 bcrypt,Debian 11 以上、Ubuntu 20.04 以上、AlmaLinux 9、Alpine 可以。系统不支持时改用 SHA-512 crypt;APR1 是所有 Apache 和 Nginx 都能读的格式。

为什么输出 $2y$ 而不是 $2a$?

$2y$ 是 Apache 自带 htpasswd -B 的输出,也是 Apache 文档写的 bcrypt 前缀。两者哈希相同,只有前缀不同。OpenBSD 的 crypt() 只认 $2a$ 和 $2b$,在 OpenBSD 上才选 $2a$。不要用 $2b$:Apache 的 APR 只自己处理 $2a$ 和 $2y$,$2b$ 交给系统 crypt(),在 macOS 和 Windows 上会失败。

bcrypt 强度选多少?

htpasswd 默认 5,范围 4 到 17;本工具默认 10。Basic 认证每个请求都带密码,服务器每个请求都要算一次 bcrypt。在 Apple M1 Max 上用 htpasswd -v 验证一次,强度 5 约 13 毫秒,10 约 72 毫秒,12 约 266 毫秒。按请求量选能承受的最高值。

中文密码可以用吗?

可以,但要注意两点。本工具按 UTF-8 哈希,客户端也必须按 UTF-8 发送;从 UTF-8 终端用 curl -u 实测 Apache 和 Nginx 都能通过。另外 bcrypt 只取前 72 字节,一个汉字占 3 字节,超过 24 个汉字的部分不起作用,工具会提示。

密码会上传吗?

不会。哈希用 bcrypt.js 和页面自带的代码在当前标签页里计算,不发送、不保存,本页也不加载统计和广告脚本。生成时可以打开浏览器开发者工具的 Network 面板核对。

可以用明文格式吗?

只在少数情况下可以。Apache 只在 Windows 和 NetWare 上接受明文密码(htpasswd 手册的 -p 选项)。Nginx 只认带 {PLAIN} 前缀的明文,它的文档说这只是示例,不应使用。Linux 上的 Apache 遇到明文行不会匹配。