Nginx 中 alias 与 auth_basic 可共用，认证作用于 location 级别，需将 auth_basic 和 auth_basic_user_file 置于同一 location 块内，且 alias 路径末尾斜杠须与 location 保持一致，避免 404；密码文件须用 htpasswd 生成并确保 Nginx 可读。
在 Nginx 中，alias 指令用于将 location 映射到文件系统中某个具体路径（不同于 root 的拼接逻辑），而基础认证（Basic Auth）需通过 auth_basic 和 auth_basic_user_file 指令启用。关键在于：**基础认证作用于 location 级别，与 alias 是否存在无关，只要 location 被匹配，认证就会生效**。
确保 location 配置正确并启用 auth_basic
使用 alias 时，location 路径必须以 / 结尾（除非是精确匹配），否则可能因路径拼接出错导致 404。基础认证直接加在该 location 块内即可：
location /protected/ {
alias /var/www/myapp/assets/;
auth_basic "Restricted Area";
auth_basic_user_file /etc/nginx/.htpasswd;
}
注意：alias /var/www/myapp/assets/ 末尾的斜杠必须和 location 的 /protected/ 保持语义一致（即都表示目录），否则文件查找会失败。
生成合法的 .htpasswd 用户密码文件
Nginx 不自带密码生成工具，需用 htpasswd（Apache 工具）或 OpenSSL 手动创建。推荐使用 htpasswd：
- 安装（Ubuntu/Debian）：
sudo apt install apache2-utils - 新建用户并设置密码：
sudo htpasswd -c /etc/nginx/.htpasswd alice - 添加额外用户（不加
-c）：sudo htpasswd /etc/nginx/.htpasswd bob
生成的 .htpasswd 文件需确保 Nginx worker 进程有读取权限（如 chmod 644 /etc/nginx/.htpasswd，属主可为 root）。
避免常见陷阱
-
不要在 alias 路径里嵌套 auth_basic location：比如
location /protected/files/ { alias /data/; }和location ^~ /protected/files/ { auth_basic ... }分开写会导致认证失效——必须把auth_basic放在同一个 location 块内。 -
区分 root 与 alias 的路径行为：若误用
root替代alias，Nginx 会把请求 URI 拼接到 root 路径后，可能越权访问；而alias是直接替换 location 路径，更安全也更符合“指定某目录为入口”的需求。 -
静态文件类型需显式支持：alias 下若含 CSS/JS/图片等，建议加上
types或确认include /etc/nginx/mime.types;已加载，否则可能返回文本而非正确 Content-Type。
验证配置并重载
修改后务必检查语法、测试配置：
-
sudo nginx -t—— 确认无语法错误 -
sudo systemctl reload nginx或sudo nginx -s reload - 浏览器访问
https://yoursite.com/protected/file.txt，应弹出登录框；输入错误凭据会返回 401；正确则返回文件
不复杂但容易忽略细节。
