OAuth 代理

一个代理插件，允许你代理 OAuth 请求。适用于开发和预览部署场景，在这些场景中由于无法提前确定重定向 URL 以添加到 OAuth 提供商，因此非常有用。

安装

import { betterAuth } from "better-auth"
import { oAuthProxy } from "better-auth/plugins"

export const auth = betterAuth({
  plugins: [
    oAuthProxy({ 
      productionURL: "https://my-main-app.com", // 可选 - 如果 URL 无法正确推断
      currentURL: "http://localhost:3000", // 可选 - 如果 URL 无法正确推断
    }), 
  ]
})

export const auth = betterAuth({
  plugins: [
    oAuthProxy(),
  ],
  socialProviders: {
    github: {
      clientId: "your-client-id",
      clientSecret: "your-client-secret",
      redirectURI: "https://my-main-app.com/api/auth/callback/github"
    }
  }
})

工作原理

该插件允许你使用单一的 OAuth 客户端（注册于你的生产 URL）在多个环境中使用，比如预览部署或本地开发。

1. 预览服务器发起 OAuth，重定向至包含生产环境重定向 URI 的 OAuth 提供商
2. OAuth 提供商回调至生产服务器
3. 生产服务器用 code 换取令牌并获取用户信息
4. 生产服务器加密用户信息并重定向回预览服务器（生产环境无数据库写入）
5. 预览服务器解密用户信息，在自己的数据库创建用户/会话，并设置会话 Cookie

import { authClient } from "@/lib/auth-client"

await authClient.signIn.social({
    provider: "github",
    callbackURL: "/dashboard"
})

加密的用户信息通过 URL 查询参数传递，只有共享相同密钥的服务器能解密。这也允许预览环境使用与生产环境不同的数据库（如果需要）。

选项

productionURL：如果此值与 auth 配置中的 baseURL 相匹配，请求将不会被代理。默认为 BETTER_AUTH_URL 环境变量。

currentURL：插件会自动确定应用当前 URL。它会优先检查请求的 URL（如果由客户端调用），然后检查流行托管服务的基 URL，最后回退到 auth 配置中的 baseURL。如果无法正确推断 URL，可以在此手动指定。

maxAge：加密用户信息的最大有效期（秒）。超过此时间的负载将被拒绝，以防止重放攻击。该值建议保持较短（例如 30-60 秒），以减少潜在重放攻击的窗口，同时保持正常的 OAuth 流程。默认为 60 秒。