直接在 location 块中配置 auth_basic 和 auth_basic_user_file 即可为 /admin/ 等目录启用账号密码认证；需用 htpasswd 生成加密凭据文件，设权限 640，配合 https 使用，并用 ^~ 精准匹配路径，静态资源可单独放行。
直接在 Nginx 的 location 块里配置 auth_basic 和 auth_basic_user_file，就能为指定目录加上账号密码保护。不改应用代码、不依赖数据库，配完 reload 一下就生效。
生成安全的密码文件
必须用 htpasswd 工具生成加密格式的凭据，不能手写明文或复制 Base64 字符串：
- Ubuntu/Debian 系统：运行
sudo apt install apache2-utils -y - CentOS/RHEL 系统：运行
sudo yum install httpd-tools -y或dnf install httpd-tools - 首次创建用户文件：
sudo htpasswd -c /etc/nginx/.htpasswd admin（会提示输入并确认密码） - 后续添加用户（不覆盖原有用户）：
sudo htpasswd /etc/nginx/.htpasswd ops - 设权限防泄露：
sudo chmod 640 /etc/nginx/.htpasswd，并确保属组可读（如sudo chown root:www-data /etc/nginx/.htpasswd）
在 location 中精准启用认证
只保护真实需要的路径，避免误拦静态资源或接口：
- 用
^~ /admin/这种前缀匹配，语义明确、优先级高，不易被正则规则覆盖 - 典型配置示例：
location ^~ /admin/ {<br> auth_basic "Admin Login Required";<br> auth_basic_user_file /etc/nginx/.htpasswd;<br>} - 若该路径下含 CSS/JS 等静态资源（如
/admin/static/），单独放行：location ^~ /admin/static/ {<br> auth_basic off;<br>} - 注意路径尾部斜杠：
/admin和/admin/匹配行为不同，保持前后一致
必须配合 HTTPS 使用
HTTP Basic Auth 的凭证本质是 Base64 编码，不是加密——明文传输极其危险：
- 未启用 HTTPS 时，浏览器可能拒绝发送认证头，或直接提示“不安全”
- 即使已配好 Basic Auth，也务必确保站点已部署有效 SSL 证书，并监听 443 端口
- 建议在 server 块中强制跳转 HTTPS：
return 301 https://$host$request_uri;
验证与生效
配置完成后别跳过检查步骤：
- 运行
sudo nginx -t验证语法是否正确 - 确认无误后执行
sudo nginx -s reload重载配置 - 访问目标路径（如
https://example.com/admin/），应弹出浏览器登录框 - 错误提示常见原因：密码文件路径写错、Nginx 进程无读取权限、HTTPS 未启用、路径匹配不准确
