Nginx 中 auth_basic_user_file 必须为绝对路径，指向由 htpasswd 生成的加密密码文件（推荐 bcrypt 格式），且需确保 Nginx worker 进程有读取权限（如 chmod 640、chown root:www-data），否则认证将失败。
在 Nginx 中，auth_basic_user_file 用于指定一个包含用户名和加密密码的文件，配合 auth_basic 指令实现 HTTP 基础认证。这个文件通常由 Apache 的 htpasswd 工具生成，Nginx 本身不生成该文件，但完全兼容其格式。
确认 htpasswd 文件格式正确
Nginx 只支持 htpasswd 生成的两种常见哈希格式：crypt（默认，较弱）和 bcrypt（推荐）。不支持 SHA、MD5（非 Apache 标准格式）或 Windows NTLM 等格式。
- 生成 bcrypt 格式（安全性高，推荐）：
htpasswd -B -c /etc/nginx/.htpasswd username - 生成 crypt 格式（兼容性好，但已过时）：
htpasswd -c /etc/nginx/.htpasswd username -
-c表示创建新文件（会覆盖旧文件），首次使用建议加上；后续添加用户去掉-c
在 Nginx 配置中正确引用该文件
确保路径是绝对路径（相对路径易出错），且 Nginx 工作进程有读取权限。
- 在
server或location块中启用基础认证：auth_basic "Restricted Area";<br>auth_basic_user_file /etc/nginx/.htpasswd;
- 检查文件权限：Nginx 主进程通常以
root启动，但 worker 进程常以www-data或nginx用户运行，需确保该用户可读：sudo chown root:www-data /etc/nginx/.htpasswd<br>sudo chmod 640 /etc/nginx/.htpasswd
验证配置并重载服务
避免因语法错误或权限问题导致认证失效。
- 测试配置语法：
sudo nginx -t - 若通过，重载配置：
sudo nginx -s reload - 访问对应 URL，浏览器应弹出登录框；输入正确用户名密码后才可访问内容
常见问题排查
如果认证不生效或提示 500/403 错误，优先检查以下几点：
-
auth_basic_user_file路径是否拼写正确？是否为绝对路径？ - 文件是否存在？是否为空？是否有多余空行或 UTF-8 BOM？
- 文件是否被 SELinux 或 AppArmor 限制（Linux 发行版如 CentOS/RHEL/Ubuntu 默认可能启用）？可临时用
setenforce 0测试 - 日志中是否有相关错误？查看
error_log（默认在/var/log/nginx/error.log）中的提示，例如open() "/path/.htpasswd" failed (13: Permission denied)
