bknd：基于Web标准的可视化后端系统

开发框架 3.8k（+1） 150 TypeScript 2026-11-15 访问官网 ↗ 在 GitHub 打开

bknd提供数据库、认证、媒体与工作流的可视化后端，可部署到多种运行时与框架中。

bknd是一个通用后端系统，内置数据管理、认证、媒体存储和工作流自动化，并提供完整REST API、管理界面、TypeScript SDK与React组件。它基于WinterTC最小公共Web平台API构建，功能模块可按需启用，通过适配器直接访问底层驱动，支持SQLite/Postgres等多种数据库、S3兼容存储，以及Node.js、Bun、Deno、Cloudflare Workers等运行时和React、Next.js、Astro等框架。项目要求Node.js 22.13及以上，尚未发布v1.0.0，不保证完全向后兼容。

Star 趋势2026-11-10 — 2026-11-14当前 Stars 3.8k24h +1

#数据库相关

项目信息

所有者: bknd-io
Star: 3.8k
Fork: 150
开源协议: —
主要语言: TypeScript
发布时间: 2024-11-16
最近更新: 2026-10-31

项目更新

v0.21.02026-10-25
bknd 新增 Solid、Nuxt、TanStack Start 三个适配器，沿用现有 Astro 与 Next.js 适配器的同一套模式，接入方式见官方集成指南。时间戳插件加入 indexStrategy 选项，用来决定 createdat、updatedat 字段的索引生成方式："composite" 建联合索引，"individual" 则各建各的。 ``ts import { timestamps } from "bknd/plugins"; export default { options: { plugins: [ timestamps({ entities: ["pages"], indexStrategy: "composite" // 改为 "individual" 则分别建索引 }) ], }, } satisfies BkndConfig; ` 新增 Sort 插件，自动维护可排序实体的 position：插入时从 0 起分配序号，序号变动后自动重排，支持按 scope 分组排序，并提供 POST /api/sort/{entity}/reorder 与 POST /api/sort/{entity}/recalculate` 两个端点，后者适合大数据量时批量重算。指定了 scope 字段后，排序只在同 scope 内进行。此外还有一些易用性改进、Bug 修复和文档更新。
v0.20.02026-01-09
bknd 本次更新集中在生态打通与开发体验。许可证改为 Apache 2.0，商用与企业采用更自由。Postgres 支持不再需要单独的 @bknd/postgres，已并入主包，直接导入即可： ``ts import { pgPostgres, postgresJs } from "bknd"; import { Pool } from "pg"; import postgres from 'postgres' // 使用 pg 库 const connection = pg({ pool: new Pool({ connectionString: "postgresql://user:password@localhost:5432/database", }), }); // 使用 postgres.js const connection = postgresJs({ postgres: postgres("postgresql://user:password@localhost:5432/database"), }); ` MCP 工具启用后直接进入后台主导航，界面按路由感知重做，在管理端调用 AI 工具顺手不少。Hybrid 模式优化了类型推断与配置处理：reader 函数现在可以直接返回对象，开发环境靠 sync_required 标志自动同步 schema，配置文件缺失时自动落到默认值。查询关联实体会自动补上 join，where 里直接写关联字段就行： `ts // 按 author.name 过滤时自动 join author const posts = await api.data.readMany("posts", { where: { "author.name": "John" }, }); ` 新增 emailOTP 认证插件，走邮箱一次性密码的免密登录，覆盖登录与注册两条流程，有效期、邮件模板可配，验证码用后即失效： `ts import { emailOTP } from "bknd/plugins"; import { resendEmail } from "bknd"; export default { options: { plugins: [ emailOTP({ generateEmail: (otp) => ({ subject: "OTP Code", body: Your OTP code is: ${otp.code}, }), }) ], }, } satisfies BkndConfig; ` 邮件驱动新增 Plunk，与 Resend 并列支持： `ts import { plunkEmail } from "bknd"; export default { options: { drivers: { email: plunkEmail({ apiKey: "<api-key>", from: "hello@example.com", }), }, } } `` SvelteKit 现在有一等适配器
v0.19.02025-10-31
本次更新重点在于高级权限与 Deno 支持：高级权限（类 Postgres RLS）：权限规则现在可以带条件地允许或拒绝访问，并对支持过滤的资源做结果过滤。每类权限都有各自的上下文，比如数据权限会记录请求的是哪个实体。数据权限新增「策略效果」，可给查询附加一条不可变过滤条件，实现类似 Postgres 行级安全的数据隔离——区别在于这一切都能在界面上完成，用的就是你查数据时那套 where 语法。后续版本还会继续完善各类权限的上下文与过滤能力。 Deno 支持收尾：Deno 此前已能运行 bknd，缺的只是托管管理后台界面。Node、Bun 依赖 node_modules 提供静态资源，Deno 环境则未必，因此提供了三种方案：用 serveStaticViaImport 动态导入（推荐）、用 serveStatic 加 copy-assets 命令托管本地副本，或用 adminOptions.assetsPath 从远程地址拉取。新手模板已加入 Deno，可直接运行： ``sh deno run npm:bknd create -i deno ` 模式辅助函数：新增 code 和 hybrid 两个 helper，开箱即用——自动同步配置、类型与密钥，开发环境自动同步数据结构，生产环境 hybrid 模式自动切到 code，并跳过配置校验以提升性能。此外还有时间戳插件、批量 schema 语句执行、媒体请求体大小限制、useAuth` 与 SDK 改进、dropzone 的 MIME 类型校验修复、获取数据实体 TypeScript 定义的工具等若干改动。
v0.18.12025-10-13
v0.18.1 是一个小修版本，主要解决两件事：一是修复了分页在接口未返回 total 总数时的处理问题，此前这种情况下翻页会出现异常，现在可以正常工作；二是在文档中补充说明，Cloudflare 图片优化功能需要依赖对应插件才能启用，避免使用者配置后不生效却找不到原因。完整变更见：https://github.com/bknd-io/bknd/compare/v0.18.0...v0.18.1
v0.18.02025-10-01
bknd 新增三种运行模式：UI-only（默认，可视化配置写入数据库）、Code-only（用类 Drizzle API 纯代码定义数据结构，禁用可视化控件）、Hybrid（开发期可视化配置，生产环境改用生成的配置走代码模式，兼顾体验与性能）。注意这是破坏性变更：原先的 initialConfig 已改名为 config，其余用法照旧。 Admin 支持在 React 项目中深度定制：用户菜单和实体操作的下拉可追加动作项，列表与增改页面能插入页头页脚，字段可替换为自定义组件，也允许挂载自定义路由。媒体处理同步改进：mime 类型识别更准确，列表上限提高，预览可在弹窗中直接查看 PDF、文本与音频内容；实体删除时关联文件会一并清理。 SQLite 连接新增 onCreateConnection 回调，连接建立后可执行任意 PRAGMA，例如开启 WAL 模式： ``ts import { nodeSqlite, type NodeBkndConfig } from "bknd/adapter/node"; export default { connection: nodeSqlite({ url: "file:data.db", onCreateConnection: (db) => { db.exec("PRAGMA journal_mode = WAL;"); }, }), } satisfies NodeBkndConfig; `` 其余修复涉及 CLI 依赖外部化、typegen 字段格式与类型名处理、Cloudflare dev-fs 分块请求，以及 MinIO 所需的 s3 头部设置。
v0.17.22025-09-15
v0.17.2 是一次以修复为主的补丁版本：Cloudflare 适配中缺失的 serve 导出已补上；raw node 执行时 import 属性会在构建中丢失的问题也一并修好，此前这类用法无法正常运行。对象转换现在能正确处理带编号的情况，MCP 工具的 URL 同步更新。另新增了 UUID 校验工具函数，Dockerfile 与 postgres 适配均升级至 0.17.1，其中 postgres 还改进了自定义连接 API。
v0.17.12025-09-03
v0.17.1 是个补丁版本，修了两个实际问题。一是 Cloudflare 部署下的配置状态竞争：此前多个实例会各自持有并写入配置，互相覆盖导致状态不一致。现在改为始终读取最新配置，不再让实例之间抢状态，用 Cloudflare 跑 bknd 的人升级后会明显稳一些。二是移动端样式——输入框聚焦或失焦时页面会被浏览器自动放大，现已修正，手机上填表单不再晃来晃去。如果你只在本地或非 Cloudflare 环境使用，这版可以按需升级；上 Cloudflare 的建议尽快跟上。
v0.17.02025-08-30
bknd 现在内置了完整的 MCP 服务端，用于操作实例。工具与资源大多由 schema 动态生成，并从 hono 路由与手工定义中提取，因此始终与实际配置同步，维护成本很低。管理界面新增 MCP UI，应用内可直接使用内置 MCP 客户端，CLI 也提供 stdio 传输的启动命令。后续会把管理界面也迁到 MCP 上，并支持 SSE/WebSocket 传输与自定义工具。 Cloudflare 方面移除了 durable 模式——它引入的 cloudflare:workers 导入在 Astro、React Router 下频繁出问题。新增 withPlatformProxy，让 CLI 能访问 Cloudflare 资源；针对 Vite 插件模拟环境缺少文件系统、导致 syncTypes 这类插件失效的情况，提供 devFsVitePlugin 与 devFsWrite 恢复写盘能力。文档补上系统实体、实体挂载媒体、SDK 的 data/media API、插件开发与内置插件用法，以及 MCP 总览。Dockerfile 升到 Node 24，CLI 新增 sync 命令，另有若干依赖与类型修复。
v0.16.12025-08-06
bknd v0.16.1 是 0.16 系列的补丁版本，主要修补类型与示例代码上的遗留问题。新增 jsonv-ts 作为依赖，用于类型推断，同时修正了 media API 的类型定义——此前直接使用该接口的开发者容易拿到不准确的类型提示，现在应能正常推断。另外，示例项目因 0.16 的改动导致导入路径失效，这一版已全部修复，照着 examples 起步不会再踩坑；文档资源中也补充了海报图。整体属于维护性更新，无行为变更，建议升到 0.16.0 的用户顺手跟上。
v0.16.02025-08-01
v0.16.0 是一次破坏性更新：bknd/core、bknd/data、bknd/auth、bknd/media 四个导出路径已移除，相关模块统一从 bknd 导入： ``diff -import { libsql } from "bknd/data"; +import { libsql } from "bknd"; ` bknd/adapter、bknd/utils、bknd/ui 等路径不受影响。此前想把模块拆成独立包，实测反而引出重复代码问题，为此收回了该设计。 JSON Schema 层从 @sinclair/typebox` 迁到 jsonv-ts：包体更小、性能更好，并自带请求校验与 OpenAPI 动态生成。更关键的是 jsonv-ts 能遍历 schema，直接暴露嵌套的 MCP Tools 与 Resources——MCP 能力将由 schema 本身驱动，而非外挂一层 API。文档站已迁移至 fumadocs。此外修复了 auth 错误重定向与 media API 参数透传，新增静态资源动态导入、cookie partitioned 选项、CORS origin 数组与 credentials 开关，增强 Cloudflare 图片优化插件，并加入 Deno、Waku 支持。