OpenUI项目中使用Nginx反向代理时解决Basic Auth与Bearer Token冲突问题

背景介绍

在部署OpenUI项目时，很多开发者会选择使用Nginx作为反向代理来提高安全性和访问控制。一个常见的安全措施是配置HTTP Basic认证来限制访问。然而，OpenUI的前端实现中使用了AI兼容的API接口，会自动生成"Authorization: Bearer sk-fake"的请求头，这会导致与Nginx的Basic认证机制产生冲突。

问题分析

OpenUI的前端代码中使用了AI的JavaScript SDK，该SDK会强制在所有API请求中添加Bearer Token认证头。即使这个Token是硬编码的"sk-fake"值，它也会覆盖浏览器为Basic认证生成的"Authorization: Basic"头信息，导致Nginx返回401未授权错误。

技术解决方案

经过项目维护者的深入研究，发现可以通过继承并重写AI类的方法来解决这个问题。具体实现方案如下：

1. 创建一个自定义的AI子类，重写authHeaders方法使其返回空对象
2. 可选地自定义fetch方法，确保包含必要的认证凭证

核心代码实现如下：

class MyAI extends AI {
    protected override authHeaders(opts) {
       return {};
    }
}
const ai = new MyAI({
  apiKey: 'sk-fake',
  baseURL: `${host()}/v1`,
  dangerouslyAllowBrowser: true
})

实现细节

这个解决方案的关键点在于：

1. 通过继承AI类创建自定义实现
2. 重写authHeaders方法阻止默认的Bearer Token添加行为
3. 保留其他所有AI SDK的功能不变

值得注意的是，虽然OpenUI后端实际上并不验证这个API密钥，但SDK要求必须设置一个值，因此我们仍然保留了apiKey参数，只是阻止了它的传输。

部署建议

对于实际部署场景，开发者可以考虑以下方案：

1. 使用Nginx Basic认证作为第一层防护
2. 结合IP限制规则增强安全性
3. 对于需要更复杂认证的场景，可以启用GitHub OAuth集成

总结

通过这种巧妙的类继承和方法重写技术，我们成功解决了OpenUI项目在Nginx反向代理环境下Basic认证与Bearer Token的冲突问题。这个方案既保持了AI SDK的核心功能，又实现了必要的安全控制，为OpenUI项目在各种部署场景下的安全访问提供了可靠保障。