Nginx启用basic_auth需配置auth_basic和auth_basic_user_file两行指令，用htpasswd生成加密密码文件并设为绝对路径，必须配合HTTPS使用，且确保.htpasswd文件权限安全、不可被Web直接访问。

在 Nginx 配置文件中启用 basic_auth，核心是两行指令：指定认证提示文字，以及指向加密密码文件的绝对路径。整个过程不依赖额外模块（ngx_http_auth_basic_module 默认已编译），但必须确保 HTTPS 环境和文件权限安全。

1. 生成加密密码文件（用 htpasswd）

密码不能明文存储，需用 htpasswd 工具生成标准 Apache 格式（Nginx 兼容）的加密文件：

• 安装工具（Ubuntu/Debian）：sudo apt install apache2-utils；CentOS/RHEL：sudo yum install httpd-tools
• 首次创建用户（如用户名 admin）：sudo htpasswd -c /etc/nginx/.htpasswd admin，系统会提示输入并确认密码
• 后续添加用户（不加 -c，避免覆盖）：sudo htpasswd /etc/nginx/.htpasswd user2
• 设置文件权限（防止被 Web 访问或越权读取）：sudo chown root:www-data /etc/nginx/.htpasswd && sudo chmod 640 /etc/nginx/.htpasswd

2. 在 location 块中配置 auth_basic

推荐在 location 中精确控制保护范围，比如只限制后台路径：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

• 使用前缀匹配（^~）避免正则干扰：location ^~ /admin/ { ... }
• 添加两行关键配置：
  auth_basic "Admin Area";（引号内是浏览器弹窗显示的提示文字，非密码提示）
  auth_basic_user_file /etc/nginx/.htpasswd;（必须为绝对路径）
• 完整示例：
  

  location ^~ /admin/ {<br>
    auth_basic "Admin Area";<br>
    auth_basic_user_file /etc/nginx/.htpasswd;<br>
  }

3. 必须启用 HTTPS 并验证配置

Basic Auth 的凭证通过 Base64 编码传输，本质无加密——HTTP 下等于明文发送，极易被截获：

• 确保站点已配置有效 TLS 证书，访问地址为 https:// 开头
• 测试配置语法：sudo nginx -t，输出 test is successful 才可继续
• 重载生效：sudo nginx -s reload（不中断服务）
• 访问受保护路径（如 https://yoursite.com/admin/），应弹出登录框；输错返回 401 状态

4. 安全与维护要点

配置生效后，还需注意几个容易忽略的实际细节：

• 禁止将 .htpasswd 放在网站根目录（如 /var/www/html/），否则可能被直接下载
• 不同 auth_basic realm 字符串会被浏览器视为独立认证域，切换时需重新输入
• 定期清理不用账号：sudo htpasswd -D /etc/nginx/.htpasswd olduser
• 如需叠加 IP 限制，可在同一 location 中配合 allow/deny 使用