AdminForth

AdminForth

AI TOOL PROFILE工具资料

开源 Tailwind 管理面板框架,声明式配置接现有数据库,编码代理可直接读写面板数据

官网地址 https://adminforth.dev/

访问官网
价格开源免费(npm 包安装)
平台Web / Node.js / npm
归类AI 编程
收录2026-10-10
复核2026-10-10
编辑评分 4.0 / 5

AdminForth编辑总结

EDITOR REVIEW编辑评测

AdminForth 是一个开源管理面板(back-office)框架,基于 Vue3、Node.js 与 TypeScript,界面走 Tailwind 风格。它直连你已有的数据库生成 CRUD 后台,配置是普通声明式对象,项目就是仓库里一个普通 Node 应用。两大突出优势:一是对编码代理友好——每个生成的应用自带 AGENTS.md、CLAUDE.md、llms.txt 与 skills/,Claude Code、Codex、Gemini 或 Copilot 能直接增删资源与插件;二是内置 MCP Server,让代理以发起用户的权限读写面板数据。从空文件夹到可用面板约六分钟。短板:需要 Node.js 22.12+ 环境,且面板本身不管理数据库 schema,迁移仍需 Prisma 或自备工具。

AdminForth是什么?

AdminForth 是一个面向开发者与管理员的开源后台面板框架:连接已有数据库,提供数据管理所需的增删改查、过滤与排序能力,前后端用 Vue3 与 Node.js TypeScript 编写,界面组件按 Tailwind 方式构建。

通过 npx adminforth create-app 一条命令即可从空文件夹生成完整可用的面板项目(约六分钟);支持 SQLite,ClickHouse 与 Qdrant 连接串;运行要求 Node.js 22.12+ 或 24、26,官方推荐 Node.js 24 LTS;启动后默认访问 http://localhost:3500,默认账号密码为 adminforth/adminforth;此外提供约三十个以 npm 包形式安装的官方插件。

普通开发者用 create-app 选「已有数据库」或「新建 SQLite 数据库」两条路径起步,再用 npx adminforth resource 从表生成资源文件;团队管理员通过认证、会话、审计日志等插件管好权限;AI 编码代理则可通过 MCP Server 插件把面板资源当远程工具调用,读写数据时权限、校验与钩子照常生效。

AdminForth核心功能

CAPABILITIES工具标签

声明式建面板

资源在配置里声明即可生成界面,配置是普通声明式对象,面板就是仓库里的普通 Node 应用,代理能改、审阅者能看 diff,不锁定私有格式。

官方说明 ↗

多数据库直连

create-app 接受 sqlite://、postgresql://、mongodb://、mysql:// 与 clickhouse:// 连接串,还支持 qdrant://;对多数数据库能自动发现列类型与约束。

入门教程 ↗

代理友好工程

每个生成的应用自带 AGENTS.md、CLAUDE.md、llms.txt 与 skills/ 目录,Claude Code、Codex、Gemini 或 Copilot 无需重新学习项目即可添加资源、列或插件。

官方说明 ↗

MCP Server

把面板资源与操作暴露为远程 MCP 工具,供 Claude Code、OpenAI Codex、Gemini CLI 等客户端调用;每次调用以创建密钥的 AdminForth 用户身份运行,权限、校验与钩子照常生效,一个代理一个密钥、可单独吊销。

官方说明 ↗

认证与安全

内置 OWASP 合规登录;OAuth2/OpenID SSO 插件预置 Google、GitHub、Microsoft、Keycloak 等适配器(RFC 6749);2FA 插件支持 TOTP 与 WebAuthn PassKeys(RFC 6238);用户会话可按设备一键吊销;登录可挂 reCAPTCHA 或 Cloudflare Turnstile。

官方说明 ↗

官方插件体系

约三十个插件以 npm 包形式安装,一行配置启用,覆盖审计日志、CSV 导入导出(RFC 4180)、后台任务、富文本编辑、行内编辑、批量 AI 填充、仪表盘、文件上传到 S3 等场景。

官方说明 ↗

AI 辅助能力

AI autocomplete 插件用你的 LLM API key 结合记录上下文补全文案;Bulk AI 插件按所选记录批量生成数据或图片;Agent 插件接收自然语言指令在面板内检索与修改数据;LLM 翻译插件可翻译面板与外部应用。

官方说明 ↗

自定义与主题

用 Vue3 组件创建自己的页面与仪表盘,可添加任意 npm 包扩展面板;上传 logo、改颜色与标题即可贴合品牌;暗色模式默认开启。

官方说明 ↗

AdminForth值不值得用?

VERDICT工具标签

当你的团队已经有现成数据库、又需要一个能快速长出来的管理后台时,AdminForth 值得选:一条命令连库生成面板,资源声明式维护,三十来个插件按需启用,编码代理还能通过 MCP 直接帮你操作数据。当你的数据库是全新项目且团队不熟 Node.js/TypeScript,或需要面板自己管理数据库 schema 时要谨慎——AdminForth 从不修改表结构,迁移要靠 Prisma 或你自己的工具。PHP、Python 等非 Node 技术栈团队也要评估维护成本。

建议选它的情况

  • 已有 PostgreSQL/MySQL/SQLite/MongoDB 数据库、需要后台管理的团队
  • 大量使用 Claude Code、Codex 等编码代理的开发团队
  • 需要 OAuth2/SSO、2FA、审计日志等合规要求的内部系统
  • 想要插件化扩展、自定义 Vue 页面与仪表盘的产品团队

不建议选它的情况

  • 没有 Node.js 22.12+ 运行环境的非 JS 技术栈团队
  • 期望面板自动管理数据库 schema 与迁移的新项目
  • 只需要现成 SaaS 后台、不愿自托管维护的用户

AdminForth使用建议

HOW TO USE工具标签
入门先把路子走对
  1. 一条命令起步运行 npx adminforth create-app --app-name myadmin --db "postgresql://user:password@localhost:5432/dbname" 连接现有库;新项目则省略 --db 用默认 SQLite。完成后 pnpm start,浏览器打开 http://localhost:3500。
  2. 从表生成资源项目建好后进入目录运行 npx adminforth resource,从已有表生成资源文件;以后每新增或改动表都再跑一次该命令同步。
  3. 改默认密码首次登录用默认账号 adminforth/adminforth,进入后立即修改密码;密钥类配置在生成的 .env 文件中(ADMINFORTH_SECRET 已自动生成),不要提交进版本库。
  4. 选好迁移路径空库时 CLI 会问 Include Prisma migrations?:没有自己的迁移工具就答 Yes 让 AdminForth 用 pnpm makemigration 与 pnpm migrate:local 管理;已有 schema 则答 No,README 会给出 adminuser 表的 SQL。
进阶省时间也省钱
  1. 给代理配 MCP启用 MCP Server 插件,把资源暴露为 Claude Code、Codex、Gemini CLI 的远程工具;坚持一个代理一个密钥,出问题单独吊销,权限与校验仍按发起用户生效。
  2. 按需开插件审计日志、Quick Filters、行内编辑、CSV 导入导出都是一行配置加一个 npm 包;先开审计日志与 Quick Filters 这类高频件,再按需加 Bulk AI、后台任务等。
  3. 升级 Node 版本运行环境务必落在 Node.js 22.12+、24 或 26,Node 20/21 已不再支持;官方推荐用 nvm 固定 24 LTS,避免版本漂移导致插件兼容问题。

AdminForth适合谁用?

WHO IS IT FOR工具标签

Node/TS 全栈团队

推荐

技术栈对齐 Vue3 + Node.js TypeScript,面板就是仓库里的普通 Node 应用,扩展与审查都在熟悉的工作流里完成。

AI 编码代理用户

推荐

日常用 Claude Code、Codex、Gemini 或 Copilot 的团队收益最大:项目自带代理所需文件,配置可被代理直接编辑,MCP 还能让代理代操作数据。

自建后台的初创团队

推荐

开源免费、六分钟出面板、三十个插件按需加装,能以很低成本搭起内部管理系统。

非 JS 技术栈团队

有条件

运行环境要求 Node.js 22.12+,二次开发需要 Vue3 与 TypeScript 能力,PHP/Python 团队需评估额外维护成本。

不想自托管的用户

不推荐

它是需要自己部署维护的开源框架,没有托管服务,不愿管服务器与升级的用户不适合。

AdminForth优点和缺点

PROS & CONS工具标签

优点

  • 开源免费,create-app 一条命令六分钟出面板
  • 直连现有数据库,支持 SQLite/PostgreSQL/MySQL/MongoDB/ClickHouse/Qdrant
  • 自带 AGENTS.md、CLAUDE.md、llms.txt,编码代理开箱即懂
  • MCP Server 让代理以用户权限安全读写面板数据
  • 约三十个官方插件,一行配置即可启用
  • 认证体系完整:SSO、2FA、会话吊销、审计日志

缺点

  • 要求 Node.js 22.12+,Node 20/21 已不被支持
  • 面板从不修改数据库 schema,迁移需自备或用 Prisma
  • 默认账号 adminforth/adminforth,上线前必须手动改
  • 深度自定义需要 Vue3 与 TypeScript 开发能力

AdminForth常见问题

FAQ工具标签
AdminForth 多少钱?免费吗?

AdminForth 是开源框架,通过 npm 安装,npx adminforth create-app 等均无需付费;约三十个官方插件也以 npm 包形式随框架使用。作为自托管项目,成本主要来自服务器与维护人力,页面未提及任何收费档位。

当前主力能力是什么?

当前核心是「一条命令接库出面板」:npx adminforth create-app 连接现有或新建数据库生成完整后台,资源用声明式配置维护;对代理侧则提供 MCP Server,把资源暴露为 Claude Code、Codex、Gemini CLI 的远程工具;另有 OAuth2/SSO、2FA、会话管理、审计日志、Bulk AI、后台任务、仪表盘等约三十个插件按需启用。

和 Retool 这类低代码后台怎么选?

AdminForth 的差异在于开源自托管、面板是仓库里可版本化的普通 Node 应用、配置可被编码代理直接编辑,适合工程团队长期演进;低代码 SaaS 平台上手更快但受限于平台能力与按席位计费。需要代码级控制、代理协作与私有部署时选 AdminForth,想零代码快速拼界面时 SaaS 更省事。

国内能不能用?有什么限制?

官网未提及地区限制。它通过 npm 分发、依赖 Node.js 运行,安装时如需访问 npm 源或 GitHub,国内网络环境可能需要配置镜像或代理;运行时面板完全部署在你自己的服务器上,数据不出内网。使用前请按你的网络环境自行准备。

怎么开始?

先确保 Node.js 22.12+(推荐 24 LTS),然后运行 npx adminforth create-app:有数据库就加 --db 传连接串(支持 postgresql://、mysql://、mongodb://、clickhouse://、sqlite://),没有就用默认 SQLite。进入项目目录后用 npx adminforth resource 从表生成资源,pnpm start 启动,浏览器访问 http://localhost:3500。

它会不会改我的数据库结构?

不会。官方明确 AdminForth 本身从不修改数据库 schema、不加列也不建新表;连接已有库时它读取你的 schema 并自动发现列类型与约束,配置里的定义优先于库结构。只有当你选择让 AdminForth 生成 Prisma migrations 时,schema 管理才交给 Prisma,且仅覆盖 PostgreSQL、MySQL 与 SQLite。

支持哪些数据库?

create-app 接受的连接串包括 sqlite://、postgresql://、mongodb://、mysql:// 与 clickhouse://,文档示例中还给出 qdrant:// 的格式;对多数数据库它能自动发现列类型与约束,MongoDB 无需预先建集合,ClickHouse 则始终由你管理自己的 schema。

AdminForth竞品对比

COMPARISON工具标签
工具编辑评分价格核心功能平台
AdminForth本工具 4.0 开源免费(npm 包安装) 声明式建面板;多数据库直连;代理友好工程;MCP Server Web / Node.js / npm
JS2TS — 完全免费,无需登录 将任何 JavaScript 代码轻松转换为 TypeScript,提升代码的类型安全性和可维 Web
Shipixen — 付费 Shipixen 生成定制的基础网站模板,支持 Next.js、TypeScript 和 Sha Web
Convex — 未标价 全栈 TypeScript 平台,具有实时数据库,用于响应式应用 —
WindChat — Freemium,提供免费使用与付费方案 在线预览 Tailwind CSS HTML 代码 - 使用 ChatGPT 轻松查看和测试您的 Web
Plasmara — 未标价 AI 驱动的 Next.js 和 Tailwind 可视化构建器,便捷导出干净代码 —