如何让Nginx改用X-Authorization头替代Authorization做基础认证？

要让Nginx使用自定义的X-Authorization头完成auth_basic认证，同时避免与后端应用的Authorization头冲突，你可以通过临时替换认证头变量+代理时恢复原头的方式实现，具体配置如下：

完整配置示例 #

location / {
    # 1. 保存客户端原本的Authorization头（供后端应用使用）
    set $original_client_auth $http_authorization;

    # 2. 将自定义的X-Authorization头赋值给Authorization变量，供auth_basic验证
    if ($http_x_authorization) {
        set $http_authorization $http_x_authorization;
    }

    # 3. 启用auth_basic访问限制
    auth_basic "Restricted";
    auth_basic_user_file /etc/apache2/.htpasswd;

    # 4. 代理时恢复客户端原本的Authorization头（如果存在）
    if ($original_client_auth) {
        proxy_set_header Authorization $original_client_auth;
    }

    # 原有反向代理配置
    proxy_pass http://localhost:3011/;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

配置说明 #

1. 保存原认证头：用$original_client_auth变量暂存客户端发送的标准Authorization头，确保后端应用能拿到自身认证所需的凭证。
2. 替换认证变量：当请求中存在X-Authorization头时，将Nginx内部的$http_authorization变量替换为该头的值，让auth_basic模块读取自定义头完成验证。
3. 恢复原头到后端：验证通过后，将暂存的原Authorization头（如果有）重新设置到代理请求中，传递给后端Nuxt应用，避免冲突。

客户端使用方式 #

团队成员发送请求时，需要将认证凭证放在X-Authorization头中，格式与标准Basic Auth一致：

X-Authorization: Basic <base64编码的用户名:密码>

比如用户名是teamuser，密码是teampass，则base64编码后为dGVhbXVzZXI6dGVhbXBhc3M=，请求头就是：

X-Authorization: Basic dGVhbXVzZXI6dGVhbXBhc3M=

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