Better Auth

🎯 開發動機：解決 TypeScript 認證的半解決問題

🔥 解決的核心痛點

碎片化的認證解決方案：現有的開源函式庫往往只能處理基礎認證功能，進階功能需要大量額外程式碼
過度依賴第三方服務：開發者經常被迫使用昂貴的 SaaS 認證服務，失去了對資料的控制權
開發體驗不佳：設定複雜、文件不完整、類型安全支援不足
擴展性限制：當需要企業級功能如 SSO、多租戶支援時，現有解決方案力不從心

Better Auth 的誕生源於 TypeScript 生態系中認證領域長期存在的「半解決問題」。開發者 Bereket Engida 深信社群可以做得更好，而不是僅僅將第三方服務推薦為唯一解決方案。這個框架的核心理念是：讓自建認證系統變得如此簡單，以至於你永遠不需要依賴第三方服務。

⚡ 技術架構：現代化的設計模式與框架整合

🔧 核心技術棧

TypeScript 優先

完全以 TypeScript 撰寫，提供完整的類型安全支援，支援 strict mode，具備優秀的開發體驗。

框架無關設計

支援 React、Vue、Svelte、Next.js、Nuxt、Astro、Hono 等主流框架，真正做到一次配置，到處使用。

資料庫適配器

內建 Prisma、Drizzle 等 ORM 支援，自動產生資料庫 Schema，支援多種資料庫後端。

插件生態系統

可擴展的插件架構，官方與社群插件豐富，支援快速添加進階功能。

🏗️ 採用的設計模式

// 1. Plugin Pattern - 可擴展的插件架構
import { betterAuth } from 'better-auth'
import { twoFactor } from 'better-auth/plugins'

const auth = betterAuth({
  database: prismaAdapter(prisma),
  plugins: [
    twoFactor(), // 插件模式：模組化功能擴展
  ],
})

// 2. Factory Pattern - 創建認證客戶端
import { createAuthClient } from 'better-auth/client'

const authClient = createAuthClient({
  baseURL: 'http://localhost:3000'
})

// 3. Observer Pattern - 狀態管理與事件監聽
authClient.onAuthStateChange((user) => {
  if (user) {
    console.log('User signed in:', user)
  }
})

// 4. Strategy Pattern - 多種認證策略
const authStrategies = {
  emailPassword: true,
  socialProviders: {
    github: { clientId: '...', clientSecret: '...' },
    google: { clientId: '...', clientSecret: '...' }
  }
}
                

🔐 進階設計特色

Adapter Pattern：資料庫適配器模式，支援不同 ORM 和資料庫
Middleware Pattern：支援自訂中介軟體，處理請求驗證和授權
Builder Pattern：鏈式 API 設計，提供流暢的開發體驗
Type Inference：善用 TypeScript 的類型推論，提供編譯時安全保障

🌟 應用情境：從簡單到企業級的全覆蓋

個人專案 & 新創公司

快速實作使用者註冊、登入功能，支援社群登入，內建 Session 管理，完美適合 MVP 開發和快速原型製作。

電商平台

多重認證方式、購物車狀態保持、訂單權限管理，支援客戶忠誠度計畫整合和進階安全防護。

SaaS 產品

多租戶架構支援、組織成員管理、邀請系統、角色權限控制，完整的企業級認證授權解決方案。

企業內部系統

SSO 單一登入、LDAP 整合、多因子認證、審計日誌，滿足企業安全合規要求。

// 企業級 SaaS 應用範例配置
import { betterAuth } from 'better-auth'
import { 
  organization, 
  twoFactor, 
  rateLimiter 
} from 'better-auth/plugins'

export const auth = betterAuth({
  database: prismaAdapter(prisma, {
    provider: 'postgresql'
  }),
  
  // 多重認證策略
  emailAndPassword: {
    enabled: true,
    requireEmailVerification: true
  },
  
  socialProviders: {
    github: { clientId: env.GITHUB_CLIENT_ID },
    google: { clientId: env.GOOGLE_CLIENT_ID },
    microsoft: { clientId: env.MICROSOFT_CLIENT_ID }
  },
  
  // 企業級功能插件
  plugins: [
    organization({
      allowUserToCreateOrganization: true,
      organizationLimit: 5
    }),
    twoFactor({
      issuer: 'MyCompany'
    }),
    rateLimiter({
      window: '15m',
      max: 100
    })
  ],
  
  session: {
    expiresIn: 60 * 60 * 24 * 7, // 7 days
    updateAge: 60 * 60 * 24 // 24 hours
  }
})
                

🏛️ 軟體架構：分層設計與插件生態

🔧 架構特色說明

分層設計：清楚的關注點分離，每一層都有明確的職責
插件化架構：核心功能精簡，透過插件擴展進階功能
類型安全：從上到下完整的 TypeScript 支援
適配器模式：支援多種資料庫和 ORM，提供最大彈性

❓ 開發者常見問答

🤔 Q: Two-Factor 是使用第三方服務？是如何支援 Two Factor 認證？

✅ A: Better Auth 的 2FA 完全自主，不依賴第三方服務！

🛡️ TOTP 技術特色：

開放標準：基於 RFC 6238 規範，使用共享金鑰和當前時間產生驗證碼
離線運作：驗證碼完全在本地生成，無需網路連線
時間同步：每 30 秒更新一次，確保安全性
相容性佳：支援 Google Authenticator、Microsoft Authenticator 等主流應用

🔧 實作方式：

服務端：Better Auth 內建 TOTP 算法，自動產生共享金鑰和 QR Code
客戶端：使用者用認證應用程式掃描 QR Code，之後就能產生驗證碼
備份機制：自動產生備份碼，防止使用者被鎖定

🆚 與第三方服務的差異：

特色	Better Auth TOTP	第三方服務
成本	✅ 完全免費	❌ 通常需要付費
資料控制	✅ 完全自主	❌ 依賴外部服務
離線功能	✅ 支援	❌ 需要網路
自訂性	🔧 高度可客製	🔒 受限於供應商

💡 Better Auth 真正實現了「讓自建認證系統變得如此簡單，以至於你永遠不需要依賴第三方服務」的理念！

✨ 總結

Better Auth 代表著 TypeScript 認證領域的重大突破，它不僅解決了長期存在的技術痛點，更重要的是為開發者提供了一個真正可以信賴的、可擴展的認證解決方案。從個人專案到企業級應用，Better Auth 都能提供相應的解決方案，讓開發者專注於核心業務邏輯的實現。

這個框架的設計哲學體現了現代軟體開發的最佳實踐：類型安全、模組化設計、優秀的開發者體驗。隨著 TypeScript 生態系的持續發展，Better Auth 無疑將成為認證領域的重要基石。