在nginx中，将auth_basic放在server块内可实现全站基础认证，需配置auth_basic指令设置realm提示文字，并用auth_basic_user_file指定由htpasswd生成的、nginx可读的绝对路径密码文件，且必须启用https防止凭据明文泄露。
在 Nginx 中，把 auth_basic 放在 server 块里，就能为整个域名下的所有请求统一加一层基础认证——适合需要全站保护的后台、测试环境或内部系统。
server 块内直接启用认证
只需在目标 server 块中添加两行配置：
-
auth_basic "Admin Access Required";—— 设置弹窗提示文字（即 realm），浏览器会原样显示 -
auth_basic_user_file /etc/nginx/.htpasswd;—— 指向密码文件的绝对路径，必须可读且不能被 Web 直接访问
注意：这两行写在 server { ... } 大括号内、任意 location 外层即可生效。它会覆盖该 server 下所有未显式关闭认证的 location。
密码文件必须由 htpasswd 生成
不能手写或复制明文密码。标准做法是：
- 安装工具：Ubuntu/Debian 运行
apt install apache2-utils，CentOS/RHEL 运行yum install httpd-tools - 创建首个用户：
htpasswd -c /etc/nginx/.htpasswd admin（-c 表示新建文件） - 追加用户：
htpasswd /etc/nginx/.htpasswd devuser（去掉 -c，避免覆盖） - 设权限：
chmod 640 /etc/nginx/.htpasswd && chown root:www-data /etc/nginx/.htpasswd
不同域名用不同认证凭据
多个 server 块可各自独立配置，互不干扰：
- 域名 A 的 server 块用
auth_basic_user_file /etc/nginx/a.htpasswd - 域名 B 的 server 块用
auth_basic_user_file /etc/nginx/b.htpasswd - 每个文件用 htpasswd 单独管理，支持不同用户名和密码
这样既避免共享凭据风险，又无需修改应用逻辑。
验证与常见问题
配置完务必执行检查：
- 运行
nginx -t确认语法无误 - 再执行
nginx -s reload生效（不是 restart） - 访问该域名任意路径，应立即弹出登录框；若没反应，检查是否被某个 location 内的
auth_basic off覆盖 - 返回 500 错误时，查 error.log，大概率是 .htpasswd 路径错、权限不足或文件格式非法
安全前提：基础认证本身不加密，务必搭配 HTTPS 使用，否则用户名密码会以 Base64 形式明文传输。
