better-auth-best-practices

概覽

什麼是 better-auth-best-practices？

better-auth-best-practices 是一套實用指南與配置技能，協助你將 Better Auth 整合到 TypeScript 後端。它涵蓋設置認證伺服器與客戶端、配置資料庫適配器、管理會話、添加插件以及處理環境變數的關鍵步驟。此技能專為需要穩健認證流程的後端開發者設計，支援電子郵件/密碼、OAuth 及插件式認證設定。

誰適合使用此技能？

• 使用 TypeScript 的後端開發者
• 在 Node.js 專案中實作認證的團隊
• 需要安全且彈性認證的專案，採用 Better Auth
• 需要管理認證配置、環境變數與資料庫適配器的使用者

它解決了哪些問題？

• 簡化新專案或既有專案中 Better Auth 的設置流程
• 清楚說明環境變數與檔案位置的設定
• 精簡資料庫適配器與會話管理
• 提供 CLI 指令與插件整合的快速參考

使用說明

安裝步驟

1. 在專案中安裝 Better Auth：

   npm install better-auth
   

2. 設定必要的環境變數：
   • BETTER_AUTH_SECRET（至少 32 字元；可用 openssl rand -base64 32 產生）
   • BETTER_AUTH_URL（你的基底 URL，例如 https://example.com）
3. 在專案根目錄、lib、utils 或 src 資料夾中建立 auth.ts 檔案，配置資料庫適配器與認證選項。
4. 在你選用的後端框架中新增認證端點的路由處理器。
5. 執行遷移指令以建立資料庫結構：

   npx @better-auth/cli@latest migrate
   

6. 呼叫健康檢查端點確認設定：
   • GET /api/auth/ok 應回傳 { status: "ok" }

配置建議

• 只有在相對應的環境變數未設定時，才在配置中定義 baseURL 與 secret。
• CLI 會在標準位置尋找 auth.ts，如需自訂路徑，請使用 --config 參數。
• 新增或變更插件後，務必重新執行遷移指令。

常用 CLI 指令

• npx @better-auth/cli@latest migrate — 套用內建資料庫結構
• npx @better-auth/cli@latest generate — 產生 Prisma 或 Drizzle 的資料庫結構
• npx @better-auth/cli mcp --cursor — 為 AI 工具新增 MCP 整合

常見問題

better-auth-best-practices 適用於所有後端專案嗎？

此技能最適合需要安全且彈性認證的 TypeScript 與 Node.js 後端，不適用於純前端或非 TypeScript 環境。

需要設定哪些環境變數？

必須設定 BETTER_AUTH_SECRET（安全隨機字串）與 BETTER_AUTH_URL（應用程式基底 URL），這兩者對安全運作至關重要。

我的 auth.ts 檔案應該放在哪裡？

CLI 會在專案根目錄、lib、utils 或 src 資料夾尋找 auth.ts，如需自訂位置，請使用 --config 參數。

新增插件後如何更新設定？

新增或更改插件後，請務必重新執行遷移指令（npx @better-auth/cli@latest migrate），確保資料庫結構同步更新。

哪裡可以找到更多範例與文件？

請造訪 better-auth.com/docs 獲取最新程式碼範例、API 參考與進階配置指南。