HtPasswd

一个用于Apache/Nginx HTTP基本认证的真正的htpasswd文件管理器。可创建密码文件、添加/删除用户、验证密码以及列出用户。通过openssl支持apr1（Apache MD5）、SHA-256和SHA-512哈希算法。

命令

命令	描述
htpasswd create <文件> <用户> <密码>	创建包含第一个用户的新htpasswd文件（文件已存在则失败）
htpasswd add <文件> <用户> <密码>

向现有文件添加用户（若用户已存在则更新密码） | | htpasswd delete <文件> <用户> | 从htpasswd文件中删除用户 | | htpasswd verify <文件> <用户> <密码> | 验证用户密码（支持apr1、sha256、sha512、sha1、crypt） | | htpasswd list <文件> | 列出所有用户及其哈希算法类型 | | htpasswd version | 显示版本 | | htpasswd help | 显示可用命令及用法 |

配置

变量	默认值	描述
HTPASSWD_ALGO	apr1	哈希算法：apr1、sha256或sha512

要求

• - Bash 4+（set -euo pipefail）
• openssl — 用于密码哈希和验证
• grep、sed — 标准文本工具
• 无外部依赖或API密钥

使用场景

1. 1. 设置基本认证 — htpasswd create /etc/nginx/.htpasswd admin secret 创建新文件
2. 管理用户 — htpasswd add 添加用户，htpasswd delete 删除用户
3. 密码验证 — htpasswd verify 检查密码是否正确
4. 安全审计 — htpasswd list 显示所有用户及其哈希类型
5. 更强哈希 — 设置 HTPASSWD_ALGO=sha512 使用SHA-512替代默认的apr1

示例

bash

创建新的htpasswd文件

htpasswd create /etc/nginx/.htpasswd admin MySecretPass

添加另一个用户

htpasswd add /etc/nginx/.htpasswd editor AnotherPass

使用SHA-512进行更强哈希

HTPASSWDALGO=sha512 htpasswd add /etc/nginx/.htpasswd secureuser StrongPass

列出所有用户

htpasswd list /etc/nginx/.htpasswd

验证密码

htpasswd verify /etc/nginx/.htpasswd admin MySecretPass

删除用户

htpasswd delete /etc/nginx/.htpasswd editor

示例输出

$ htpasswd create /tmp/.htpasswd admin secret123
┌──────────────────────────────────────────────────┐
│ htpasswd 文件已创建 │
├──────────────────────────────────────────────────┤
│ 文件: /tmp/.htpasswd │
│ 用户: admin │
│ 算法: apr1 │
│ 权限: 640（所有者读写，组读取） │
├──────────────────────────────────────────────────┤
│ ✅ 文件已创建，包含1个用户 │
└──────────────────────────────────────────────────┘

$ htpasswd list /tmp/.htpasswd
┌──────────────────────────────────────────────────┐
│ htpasswd 用户列表 │
├──────────────────────────────────────────────────┤
│ 文件: /tmp/.htpasswd │
│ 用户数: 2 │
├──────────────────────────────────────────────────┤
│ 1. admin [apr1 (MD5) ] │
│ 2. editor [sha512 ] │
└──────────────────────────────────────────────────┘

$ htpasswd verify /tmp/.htpasswd admin secret123
┌──────────────────────────────────────────────────┐
│ 密码验证 │
├──────────────────────────────────────────────────┤
│ 文件: /tmp/.htpasswd │
│ 用户: admin │
│ 结果: ✅ 密码正确 │
└──────────────────────────────────────────────────┘

安全说明

• - 文件以640权限创建（所有者读写，组读取）
• 默认算法为apr1（Apache MD5）— 广泛兼容
• 在现代系统上使用HTPASSWD_ALGO=sha512进行更强哈希
• 用户名不能包含:或空白字符
• 使用add命令时，现有用户的密码会被替换

---

由BytesAgain提供 | bytesagain.com | hello@bytesagain.com