NGINX反向代理403禁止访问：Express-JS站点基础认证异常

先理清楚你遇到的情况：复制了正常运行的子域Nginx配置，只改了路径和域名，但现在登录后出现403禁止访问。下面我从几个常见的排查点给你分析，帮你定位问题：

1. 先检查.htpasswd文件的权限和路径 #

这是最容易踩坑的地方，Nginx进程必须能读取这个文件才能完成认证：

• 确认配置里的auth_basic_user_file路径是否正确：尽量用绝对路径（比如/etc/nginx/.htpasswd-subdomain），避免相对路径带来的识别问题。
• 核对文件权限：执行ls -l /path/to/your/.htpasswd，确保Nginx的运行用户（通常是www-data或nginx）有读权限。可以用chmod 644 /path/to/your/.htpasswd设置权限，或者chown www-data:www-data /path/to/your/.htpasswd修改所属用户。

2. 确认Express应用的路径映射和目录权限 #

因为你只改了路径，要确保Nginx的代理规则和Express的路由匹配，同时目录权限没问题：

• 检查Nginx的location块路径是否和Express的路由对应：比如Express监听根路径/，那Nginx的location /要正确代理到上游的127.0.0.1:3003。
• 如果Express有静态资源目录，要确保Nginx进程能读取里面的文件，避免因为静态文件权限不足导致403。

3. 验证Nginx配置的语法正确性 #

复制配置时很容易不小心改漏或写错参数，先做语法检查：

• 执行sudo nginx -t，如果配置有错误，会直接提示具体位置（比如括号不匹配、参数拼写错误）。
• 语法没问题的话，重启Nginx生效：sudo systemctl restart nginx（不同系统可能用sudo service nginx restart）。

4. 查看Nginx日志，定位403的具体原因 #

日志能帮你精准找到问题根源：

• 实时查看错误日志：tail -f /var/log/nginx/error.log，然后尝试登录，看日志里的报错信息——如果是permission denied就是权限问题，如果是invalid user就是.htpasswd文件的用户格式错误。
• 如果是认证格式问题，建议用htpasswd -c /path/to/.htpasswd 用户名重新生成用户条目，避免手动编辑时格式出错（每个条目必须是用户名:加密后的密码的格式）。

5. 排查是否有其他Nginx规则冲突 #

比如复制配置时不小心带了限制访问的规则：

• 检查当前子域的server块里有没有额外的deny all或者其他限制规则，这些会覆盖认证后的访问权限。
• 查看全局Nginx配置（比如/etc/nginx/nginx.conf的http块），确认没有全局的访问限制规则影响当前子域。

最后给你一个正确的配置示例（替换成你的实际路径和域名）：

upstream subdomain-domain-com {
    server 127.0.0.1:3003;
    keepalive 64;
}

server {
    listen 80;
    server_name subdomain.domain.com;

    auth_basic "Restricted Area";
    auth_basic_user_file /etc/nginx/.htpasswd-subdomain;

    location / {
        proxy_pass http://subdomain-domain-com;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # 若有静态资源，可单独配置location优化访问
    location /static {
        root /path/to/express/static/folder;
        expires 30d;
        add_header Cache-Control "public, no-transform";
    }
}

按照上面的步骤一步步排查，应该能快速解决问题。

内容的提问来源于stack exchange，提问作者user9216855