Nginx通过auth_basic指令启用HTTP基础认证，需配置auth_basic和auth_basic_user_file指令，并使用htpasswd生成加密凭据文件；必须配合HTTPS使用，注意文件权限与路径安全。
Nginx 通过 auth_basic 指令启用 HTTP 基础认证（Basic Authentication），这是一种轻量级、无需额外依赖的访问控制方式。它要求客户端在请求时提供 Base64 编码的用户名和密码，Nginx 则比对预设的用户凭据文件（auth_basic_user_file）来决定是否放行。
启用 auth_basic 并指定用户文件
在 server 或 location 块中添加以下配置：
-
auth_basic "Restricted Area";—— 启用认证，并设置浏览器弹窗提示文字（可自定义） -
auth_basic_user_file /etc/nginx/.htpasswd;—— 指向存储加密用户名/密码的文件（路径需 Nginx 进程有读取权限）
示例片段：
location /admin/ {
auth_basic "Admin Access Required";
auth_basic_user_file /etc/nginx/.htpasswd;
}
生成合法的 .htpasswd 用户文件
Nginx 不自带密码生成工具，需借助 htpasswd（来自 apache2-utils 包）或 OpenSSL 手动构造。推荐使用 htpasswd：
- 安装（Ubuntu/Debian）：
sudo apt install apache2-utils - 新建用户并生成文件：
sudo htpasswd -c /etc/nginx/.htpasswd alice（-c 表示首次创建，会覆盖旧文件） - 追加用户（不带 -c）：
sudo htpasswd /etc/nginx/.htpasswd bob
生成的 .htpasswd 内容形如：alice:$apr1$abc123$xyz789...（MD5 或 bcrypt 加密，取决于 htpasswd 版本和参数）
注意安全边界与常见问题
基础认证本身不加密传输内容，必须配合 HTTPS 使用，否则用户名密码将以明文 Base64 形式在网络中传递（极易被截获）。
- 确保
.htpasswd文件权限严格（如640），且不在 Web 可访问路径下（避免被直接下载） - 若修改了配置或用户文件，需重载 Nginx：
sudo nginx -t && sudo nginx -s reload - 浏览器缓存认证凭据，退出需手动清除或关闭标签页；服务端无法主动“登出”，只能依赖客户端行为
进阶：按条件启用认证
可通过 map 指令或 if（谨慎使用）实现动态控制。例如，仅对非内网 IP 启用认证：
map $remote_addr $auth_status {
default "Restricted Area";
~^192\.168\. "";
}
server {
location /admin/ {
auth_basic $auth_status;
auth_basic_user_file /etc/nginx/.htpasswd;
}
}
当 $auth_status 为空字符串时，Nginx 不触发认证流程。
