AdminForth

AdminForth是什麼

AdminForth是一個面向開發者的開源後台管理框架，以TypeScript和Vue 3為基礎所建構。它能夠連接到現有的資料庫，並快速生成具備新增、刪除、修改、查詢，以及過濾和排序功能的管理介面。

專案強調以Agent為核心的設計，可透過插件實現AI文本補全、大量內容的生成，以及將智慧代理整合到後台業務中。這並非托管式的無代碼SaaS，使用者需要自行準備運行環境、資料庫及部署資源。

AdminForth主要功能

1. 從資料庫生成CRUD後台

開發者可將資料庫連接地址交給命令列工具，再從既有資料表生成資源配置。生成後的後台支援建立、查看、編輯、刪除、篩選和排序等常見操作。

2. 多資料庫連接

目前官方文件中列出的有PostgreSQL、MySQL、MongoDB、SQLite、ClickHouse和Qdrant。其中，Qdrant連接器為只讀型，無法擁有其他資料庫所具有的完整管理功能。

3. 使用者、角色與訪問控制

框架內建登入與使用者管理功能，可設定資源及操作權限。插件還能新增OAuth2或OpenID單點登入、TOTP與通行密鑰雙因素認證，適合用於內部運營後台。

4. Vue 3介面擴展

開發者可以使用Vue 3組件來修改欄位顯示、編輯控制項、表格區域、側邊欄以及頁面標頭，同時也能製作自訂的頁面與圖表儀表板。

5. 後台常用插件

• 審計日誌：記錄使用者對數據的修改歷史。
• 上傳插件：將檔案上傳到相容的對象儲存服務。
• 導入導出：以CSV格式遷移或批量維護表格數據。
• 行內編輯與快速創建：減少頻繁打開詳情頁的操作。
• 國際化與富文字編輯：擴展多語言及內容維護體驗。
• 後台任務：調度、監控並管理耗時任務。
• 儀表板：在可視化介面中組織資料組件。

6. AI文本補全與批量生成

AI補全插件可以結合當前記錄的上下文來生成文字，而批次AI插件則能為多條記錄生成描述或圖片。此類功能需要配置第三方的模型服務金鑰，其產出品質與呼叫費用則取決於所選用的服務。

7. Agent智能代理

Agent插件提供自然語言互動介面，可把後台資源和自訂技能交給代理使用。它適合用於內容維護、資料查詢以及受控的資料操作，但必須限制權限並保留人工複核。

適合哪些用戶

• 需要為現有資料庫快速搭建內部管理後台的開發團隊。
• 使用TypeScript、Node.js和Vue技術堆疊的全堆疊開發者。
• 希望能在運營後台加入審計、雙因素認證和單點登入的團隊。
• 需要將AI寫作、圖片生成或數據代理接入業務表的產品團隊。
• 希望獲得可修改源碼、可自行部署方案的中小型項目。

支持環境與資料庫

截至2026年8月24日，官方的入門文件要求使用Node.js 20或更高版本。建議使用命令列工具來建立專案，而所產生的前端擴充功能則主要以Vue 3組件為主。

• PostgreSQL：支援連接現有的資料庫並產生資源。
• MySQL：支援常見的資料管理場景。
• MongoDB：可用作文件型資料庫的資料來源。
• SQLite：新專案預設可使用本機SQLite資料庫。
• ClickHouse：適合連接分析型資料表。
• Qdrant：目前該文件明確標示為只讀連線。

AdminForth本身不會擅自修改業務資料庫的結構。對於新建立的SQLite專案，命令列工具可以產生Prisma檔案和遷移腳本；而現有的資料庫則應仍依照團隊自身的遷移流程來處理。

費用與開源許可證

截至2026年8月24日，AdminForth的主框架為免費開源的，官方並未提供付費版本或雲端訂閱服務。其主儲存庫採用MIT許可證，只要遵守該許可證的條款及版權聲明，即可使用、修改和散布此軟體。

免費開源並不代表運作成本為零。伺服器、資料庫、對象儲存、網域名稱、監控服務以及大型模型API都可能產生第三方費用，具體金額應以各服務商的結算頁面為準。

可能產生費用的項目

• 用於部署Node.js應用程式的雲端伺服器或容器平台。
• 託管式PostgreSQL、MySQL、MongoDB或ClickHouse服務。
• 文件上傳插件使用的對象儲存與流量。
• 文本補全、批次AI和Agent插件調用的大模型API。
• 企業單點登入、郵件、監控和日誌等外部基礎設施。

快速部署教學

1. 準備Node.js 20或更高版本，並確認可以使用套件管理工具。
2. 運行AdminForth來建立命令，填入專案名稱和資料庫連線地址。
3. 如果已有資料庫，生成需要在後台管理的主題表資源。
4. 如果要建立新專案，可以使用預設的 SQLite 方案，並執行所產生的遷移流程。
5. 檢查使用者表、登入憑證、環境變數和資料庫權限。
6. 啟動本地服務，測試列表、篩選、建立、編輯和刪除操作。
7. 添加審計、雙因素認證、上傳或AI插件，並逐項配置外部服務。
8. 更換預設憑證，設定生產環境金鑰，再部署到受控伺服器。

接入AI插件教學

1. 先確定文本補全、批量生成或Agent代理的具體業務目標。
2. 安裝對應插件，並在服務商控制台創建權限受限的模型密鑰。
3. 透過環境變數來儲存金鑰，不要將金鑰寫入原始碼或前端組件中。
4. 只向模型傳遞任務所需欄位，對客戶數據和內部資訊進行脫敏。
5. 限制代理可以訪問的資源、動作和自訂技能。
6. 使用測試資料庫驗證提示詞、錯誤處理、費用和輸出格式。
7. 開啟審計記錄，並為修改或刪除操作增加人工確認。
8. 上線後監控模型費用、失敗率及異常數據變更。

產品優勢

• 可直接連接現有資料庫，減少從零開發通用後台頁面的工作量。
• TypeScript與Vue 3技術架構有助於前端及全堆疊團隊的擴展。
• 認證、審計、上傳、導入導出以及雙因素認證等插件，可滿足常見的後台需求。
• AI能力與數據資源結合緊密，可用於批量內容和受控代理操作。
• 主框架採用MIT許可證，沒有官方付費版本或雲訂閱鎖定。
• 既能快速生成基礎介面，也允許編寫自訂組件、頁面和介面。

使用限制與注意事項

• AdminForth是開發框架，不是註冊後即可使用的託管後台服務。
• 部署、備份、資料庫安全、升級和故障處理由使用團隊負責。
• Qdrant目前僅支援只讀，其他連接器的欄位功能也可能存在差異。
• AI插件依賴第三方模型，可能產生錯誤內容、延遲和持續調用費用。
• 代理獲得寫入或刪除權限後風險較高，應實行最小權限和人工確認。
• 插件及依賴需要持續更新，生產環境上線前應進行安全審查。
• 現有資料庫應先備份，並使用獨立帳號限制可訪問的表和操作。

安全與隱私建議

後台管理系統通常會接觸客戶資料、訂單資料以及運營相關的數據，因此資料庫帳號不應擁有超出業務需求的權限。在生產環境中，必須更換預設的登入憑證，並妥善保存會話金鑰及第三方服務的金鑰。

• 啟用雙因素認證，並為管理員設定獨立帳號。
• 使用審計日誌記錄創建、編輯和刪除行為。
• 對公網部署時配置TLS、訪問控制、限速與安全響應頭。
• 不要把生產資料庫連線字串提交到代碼倉庫。
• 向大模型發送數據前，確認數據分類、地區和供應商保留政策。
• 定期驗證備份恢復流程，並關注框架與插件的安全更新。

開源情況說明

AdminForth的主產品代碼已公開在官方的GitHub倉庫中，且採用MIT許可證，因此該框架本身可被視為開源軟體。不過，使用者仍必須遵守許可證所規定的版權及許可說明。

框架開源並不會自動涵蓋第三方模型、資料庫、對象儲存或其他依賴服務。每項外部服務都應單獨核對價格、使用條款和資料政策。

常見問題

AdminForth是免費的嗎

主框架免費且沒有官方付費版本或雲訂閱，但自行部署和第三方服務可能收費。

可以連接已有資料庫嗎

可以。命令列工具可讀取現有資料庫並產生資源配置，但資料庫遷移仍應由原有的工具和流程來管理。

不懂Vue可以使用嗎

基礎的CRUD介面可以透過設定及命令列來產生。在需要深入修改欄位介面、自訂頁面和儀表板時，掌握Vue 3會更為合適。

AI功能可以直接免費使用嗎

AI插件需要配置相應模型服務，是否免費以及調用價格取決於所選服務商。AdminForth本身不承擔外部模型費用。

AdminForth會修改資料庫結構嗎

框架本身不會自動改變業務資料庫的結構。若要建立新的 SQLite 方案，可以選擇使用命令列工具來產生 Prisma 的遷移檔案。

總結

AdminForth適合那些希望基於現有資料庫，快速建立可擴展管理後台的 TypeScript 與 Vue 團隊。它在常見的後台插件及 AI 代理功能方面相當完整，但若要投入實際使用，團隊仍需承擔部署、安全、權限控制以及第三方服務等相關成本。