Rowflare

Rowflare

一款开源的 Airtable 风格数据库，可在你自己的 Cloudflare 账户上运行。一个 base 对应一个由 SQLite 支持的 Durable Object。整个团队每月只需向 Cloudflare 支付 5 美元，而不是每个席位 20 美元或更多。

Rowflare Cloud · 网站 · 文档 · REST API · MCP

功能

• 网格、看板、日历、时间线、图库和表单视图。 网格最多可按 3 个字段分组，并显示每组摘要；日历支持月视图和周视图，可拖动调整日程；时间线可按开始和结束日期或持续时间，在泳道中规划工作。画布式网格支持虚拟滚动、键盘导航、与 Excel 和 Google Sheets 互相复制粘贴、拖动填充、拖动列和行、筛选、排序、搜索、隐藏字段及行高调整。
• 20 种字段类型： 单行文本、长文本、数字（数字、货币、百分比）、单选、多选、日期（可带或不带时间）、复选框、附件、关联到另一条记录、查找、汇总、公式、用户、电子邮件、URL、电话、创建时间、最后修改时间、自增编号、按钮。
• Airtable 公式语言，包含 89 个函数，并会在输入时进行验证。
• 实时协作： 编辑、新建记录和架构变更会显示在所有已打开的浏览器中；协作者的光标会以彩色轮廓显示。
• 撤销和重做编辑、粘贴、填充、移动、创建和删除操作。
• 导入 CSV（自动推断类型），或使用个人访问令牌直接从 Airtable 导入：表格、字段、记录、关联、查找、汇总、公式和附件。
• 公开表单可通过可分享的链接访问，无需账户。
• REST API 以 Airtable Web API 为蓝本，并支持个人访问令牌。
• 仪表板：提供数字、柱状图、折线图、饼图和摘要表组件，可展示任意表格的数据，使用共享日期范围，并可点击查看各个数字背后的记录。
• 自动化：在创建记录、记录更改或开始符合条件时、按计划执行时、到达指定日期时、应用调用 webhook 时，或有人点击按钮时运行步骤。步骤可创建、更新和查找记录，发送 HTTP 请求和电子邮件（通过 Cloudflare Email Service、Resend 或 SMTP），并支持“如果／否则”分支、运行日志、重试和循环保护。
• AI 字段：根据提示词以及其他字段和图片填充文本、选项、数字、日期或复选框；可使用你自己的 Anthropic 密钥或任何兼容 OpenAI 的服务（OpenAI、DeepSeek、Qwen、Kimi、Zhipu、OpenRouter、Gemini、本地 Ollama），也可使用 Workers AI。输入发生变化时，单元格会更新；内容会在后台生成，并支持重试，也可重新生成或手动编辑。自动化中新增了可生成文本或 JSON 答案的“AI 生成”步骤。
• MCP 服务位于 /mcp，供 Claude、Cursor 等 AI 客户端使用：通过个人访问令牌读取、写入、创建表格并获取分组汇总。详见 docs/mcp.md。
• 工作区和角色（所有者、编辑者、查看者），成员数量不限。
• 电子邮件验证和密码重置，通过 Cloudflare Email Service、Resend 或 SMTP 实现。
• **模板：**项目跟踪器、CRM、内容日历、错误跟踪器、库存管理。

不在范围内：界面和应用构建器、应用内 AI 聊天助手、超过 125,000 行的 base。

自托管

你需要一个 Cloudflare 账户，并订阅 Workers 付费计划（每月 5 美元）。免费计划每个请求允许使用 10 ms CPU，每天可读取 500 万行 SQLite 数据；一个包含 50,000 行的数据表每天大约进行 100 次筛选就会耗尽配额。

一键部署： 使用上方的部署按钮。Cloudflare 会将此仓库分叉到你的 GitHub 或 GitLab 账户，并创建 Worker、Durable Object 命名空间、D1 数据库、R2 存储桶和每小时运行的定时任务。打开部署后的 URL 并注册：第一个账户将成为所有者，其他人则通过邀请加入。

通过命令行：

git clone https://github.com/rowflare/rowflare.git
cd rowflare
npm install
npx wrangler login
npm run deploy

使用 Docker 在任意服务器上运行： 无需 Cloudflare 账户。此镜像会在 workerd（Cloudflare 的开源 Workers 运行时）中运行相同的 Worker 代码，并将 Durable Objects、D1 和 R2 存储为 /data 中的本地文件。

docker run -d --name rowflare -p 8787:8787 -v rowflare-data:/data ghcr.io/rowflare/rowflare:latest

也可以使用此仓库中的 docker-compose.yml：docker compose up -d。

设置、更新、备份和费用：docs/self-hosting.md。

变量	默认值	含义
MODE	selfhost	selfhost：第一个用户拥有此实例，之后仅限受邀用户加入。cloud：开放注册。
ALLOW_SIGNUP	false	允许任何能够访问此实例的人创建账户。
APP_URL		此实例的公开 URL，用于构建绝对链接。
BENCH_TOKEN		启用 /api/_bench 下的负载测试端点。生产环境中请勿设置。

工作原理

每个数据表都位于独立的 Durable Object 中，并拥有私有 SQLite 数据库：每个用户数据表对应一个物理表，行以 JSON 文档形式存储，因此字段变更会立即生效；链接存储在已索引的配对表中；查找、汇总和公式则会物化并增量更新。大型重新计算会由对象的闹钟以每批 500 行的方式运行，因此不会阻塞其他用户。详情和基准测试数据：docs/architecture.md。

开发

npm install
npm run build:web        # build the web app into dist/client
npx wrangler dev         # Worker + Durable Objects + D1 + R2 locally on :8787
npm run dev:web          # optional: Vite dev server on :5173 with hot reload, proxying /api to :8787
npm test                 # unit tests (formula engine) and Worker integration tests in workerd
npm run typecheck

将 .dev.vars.example 复制为 .dev.vars，即可在本地启用注册和负载测试端点。营销网站和文档网站位于单独的仓库 rowflare-web 中。

目录结构：

src/shared/      types, cell coercion, formula engine, rollups (used by Worker and browser)
src/worker/      Worker routes, auth, billing, REST API, Base Durable Object, storage engine, Airtable import
src/web/         React app: grid, kanban, form views, record view, field editor, imports, settings
migrations/      D1 schema (applied automatically on first request)
test/            unit tests and Worker integration tests
docker/          Docker entry point: runs the built Worker in workerd via Miniflare

许可证与承诺

Rowflare 基于 GNU Affero 通用公共许可证 v3.0 授权。你可以出于任何目的在自己的基础设施上运行它，包括商业用途。如果你将修改后的版本作为网络服务提供给他人，则必须以相同许可证公开你的修改。

我们承诺：今天开源的功能永远不会被移入付费层级。 我们不按席位收费，也不收取 SSO 费用。Rowflare Cloud（托管服务，按工作区收取固定费用，成员数量不限）以及用于闭源嵌入或白标的商业许可证为项目提供资金。

欢迎贡献；请阅读 CONTRIBUTING.md。我们要求签署贡献者许可协议，以便贡献的代码也能通过商业许可证提供。

Cloudflare 是 Cloudflare, Inc. 的商标。Rowflare 与 Cloudflare 无关联，也未获得 Cloudflare 的认可。Airtable 是其所有者的商标；Rowflare 与 Airtable 无关联。