要让特定静态资源免于auth_basic认证，需用更具体的location块（如^~ /admin/static/）优先匹配并设置auth_basic off，而非关闭整个路径认证；注意alias路径一致性及.htpasswd权限。
要让特定静态资源（比如 CSS、JS、图片）在受保护路径下免于 auth_basic 认证，关键不是“关闭整个 location 的认证”，而是用更精确的 location 匹配规则，优先命中这些资源并显式关闭认证。
用更具体的 location 块匹配静态资源路径
Nginx 的 location 匹配有明确优先级：精确匹配（=）和前缀匹配（^~）高于正则匹配，且越长、越具体的前缀匹配越优先。只要新块的路径比受保护路径更具体，Nginx 就会先走它，跳过认证逻辑。
- 若主保护路径是
location ^~ /admin/ { auth_basic ... }，而静态资源放在/admin/static/下，就单独加一个location ^~ /admin/static/块 - 这个块里写
auth_basic off;，再配上alias或root正确服务文件 - 位置无所谓——写在受保护块之前或之后都生效，Nginx 自动按最长前缀选中
常见静态资源豁免写法示例
以下配置可直接复用，注意路径结尾斜杠和 alias/root 的对应关系：
- 放行
/admin/static/下所有资源：location ^~ /admin/static/ {<br> alias /var/www/myapp/static/;<br> auth_basic off;<br>} - 放行根目录下的通用资源（如
/css/app.css）：location ^~ /css/ { alias /var/www/assets/css/; auth_basic off; } - 只放行某个图标文件：
location = /favicon.ico { alias /var/www/icons/favicon.ico; auth_basic off; }
必须避开的坑
几个容易导致豁免失效的典型错误：
- 用正则匹配（如
location ~ \.js$）去放行，但它的优先级低于^~ /admin/，结果还是被主块拦住——改用^~ /admin/js/这类前缀更稳妥 - alias 路径结尾没加斜杠，或与 location 路径不一致，导致文件 404，看起来像“没放行”
- .htpasswd 文件权限太松（比如 644），Nginx 读取失败后可能静默降级为无认证，造成误判——应设为 640，属主 root，属组 nginx 或 www-data
补充：其他豁免方式（按需选用）
如果静态资源分散、路径不规律，或需要更灵活控制，还可考虑：
-
IP 白名单：对内网请求直接跳过认证，例如在受保护 location 内加
allow 192.168.0.0/16; deny all;，再配合auth_basic off给白名单用户 - Referer 判断：只对来自本域页面的静态请求放行（需启用 ngx_http_referer_module），适合防止外链但不适用于基础豁免场景
- auth_request + 内部鉴权：把静态资源也走一次轻量校验接口，返回 200 即放行——适合已有统一认证服务的环境
