Teable 1.10 介绍与选型指南

Teable 1.10.0（2026-10-16 发布）认知篇：开源多维表格协作平台定位、四平台合一架构、许可证与商业模式、功能特性、官方快速上手，并量化对比 Airtable/NocoDB/Baserow 社区活跃度、版本节奏与兼容矩阵（查询日期 2026-10-18）。

TeableTeable2026/10/18

Teable 1.10 介绍与选型指南

目标：面向准备自托管「多维表格/Airtable 替代品」的工程师，系统介绍 Teable 1.10.0 的定位、架构、功能特性与选型依据；全部论断以官方仓库、官方文档站与镜像发布件为来源（查询日期 2026-10-18），同类竞品（Airtable/NocoDB/Baserow）活跃度数据均联网实查并标注日期。

一、环境信息（信息基准）

本章说明本文所有信息的来源基准，供读者核验时效性。

  • 信息查询日期：2026-10-18
  • 版本依据：
    • GitHub 仓库 teableio/teable 最新 Release：release.2026-10-16T07-06-34Z.3445（发布于 2026-10-16，官方自 2026 年中起采用「时间戳.构建号」滚动发布，不再打 v* 语义化 tag，来源：github.com/teableio/teable/releases，查询日期 2026-10-18）；
    • 该 Release 对应官方发布件 ghcr.io/teableio/teable:latest（Docker Hub 同名仓库，推送时间 2026-10-16），发布件内核心包 @teable/core 版本号实测为 1.10.0，仓库 develop 分支根 package.json 版本同为 1.10.0（来源：raw.githubusercontent.com，查询日期 2026-10-18）；
    • 因此本文以 1.10.0（2026-10-16 发布） 作为「最新稳定版」叙述基准。
  • 官方来源清单：
  • 竞品数据来源：GitHub 仓库 API 与 shields.io 实时徽章、各仓库 releases.atom 订阅源、各仓库 LICENSE 文件（全部为 2026-10-18 实查，下文逐一标注）。
  • 本文不包含本地安装实测：按认知篇约定，安装与部署实测见《Teable Docker Compose 部署指南》，配置实测见《Teable 1.10 配置参数详解》，功能实测见《Teable 1.10 功能验证手册》。

二、软件概述

Teable 1.10.0 是一个以「真实 PostgreSQL 为底座」的多维表格协作平台（官方口号：Airtable 替代品，"database with spreadsheet simplicity"），由 Teable, Inc.（原 tea-artist 团队）主导开发，2022 年 11 月开源（仓库创建于 2022-11-01），主语言 TypeScript。它把「类电子表格」的交互层架在真实的 PostgreSQL 数据库之上：你在界面上建的每一张表，底层就是数据库里一张真实的表，因此可以直接用 SQL 客户端、BI 工具对接数据，这是它与 Airtable（专有云存储）最本质的架构差异。

一句话定位：给业务团队的「表格界面 + 数据库底座 + 自动化/AI 工作流」一体化协作平台，支持云服务与完全自托管两种形态。

按官方 README（2026-10-18 版）的表述，当前版本自托管包含「四个平台合一」：

平台说明Standalone 自托管全功能自托管/Cloud
数据协作平台表格、视图、权限、API、自动化✅✅
AI 工作流引擎记录变更/定时/Webhook 触发，AI 步骤❌✅
AI 会话沙箱每个会话独立隔离运行环境❌✅
应用构建与发布（App Builder）自然语言生成应用并一键发布❌✅

💡 说明：社区常说的「Teable 自托管」默认指 Standalone 形态——单个应用服务 + PostgreSQL（另配 Redis 缓存），即官方仓库 dockers/examples/standalone/ 给出的部署形态；需要 AI 与 App Builder 时再按官方迁移指南加装「运行时平面」，数据原地保留。本文选型对比以 Standalone 形态为基准。

2.1 许可证与商业模式

Teable 采用 open-core（开放核心）模式，许可证结构实测自仓库 LICENSE 文件（查询日期 2026-10-18）：

组成部分许可证
核心应用（nestjs-backend、nextjs-app）AGPL-3.0
packages/ 下的 SDK 与工具包MIT
品牌资产（名称/Logo/图标）附加条款保护，不得修改替换
官方发布件（ghcr.io/teableio/teable）免费运行；AI 与企业级能力按付费许可就地解锁（license key，无需换发布件）

💡 技术拓展：对比同类产品的「开源许可证」不止一种，选型前应分清三类——

许可证类型代表产品含义自托管改造/二次分发空间
OSI 开源-弱 CopyleftTeable（核心 AGPL-3.0）网络服务也须开源修改部分；可自由自托管大（注意 AGPL 网络条款）
OSI 开源-宽松Baserow 核心版（MIT）几乎无限制，商用闭源衍生可行最大
Fair-code/源码可得NocoDB（Sustainable Use License）可看源码、可自用，但禁止把它做成竞争性商业服务中（受使用场景条款约束）
闭源 SaaSAirtable无源码，仅云服务无

Teable 实际采用 AGPL-3.0（核心）+ MIT（SDK 包）组合：对「自托管使用」完全免费，对「云化二次售卖」有传染性约束，这是它与 NocoDB（不可云化售卖）和Baserow（可宽松商用）在合规层面的关键差异。

2.2 版本演进与发布节奏

官方发布节奏（来源：releases.atom，查询日期 2026-10-18）呈现「高频滚动发布」特征：2026-09-05 至 2026-10-16 约 6 周内共发布 43 个 Release（时间戳 tag，如 release.2026-10-16T07-06-34Z.3445），平均每周 6~7 个，latest 发布件随之滚动更新。对使用者的含义是：

三、核心架构

本章依据官方 Architecture 页（help.teable.ai/en/deploy/architecture，查询日期 2026-10-18）与官方部署编排文件（dockers/ 目录）梳理。

3.1 服务组成

一次完整的自托管部署按「应用与数据面 + 运行时平面」划分服务：

服务职责Standalone 是否需要
Teable 应用（单一服务）Web UI、REST API、自动化、会话✅（必需）
PostgreSQL主数据库：所有表结构、记录数据、元数据✅（必需）
Redis缓存、任务队列、实时协作消息✅（官方 Standalone 编排含 Redis，缓存也可降级为 memory/sqlite）
对象存储文件三桶：public（头像等公开资源）、private（附件）、build（应用构建产物）可用本地磁盘目录替代
Infra Service（运行时入口）应用与运行时平面的唯一连接点，协调构建与发布❌（AI/App Builder 才需要）
沙箱引擎每个 AI 会话一个隔离运行实例❌
Git registry存放 App Builder 生成应用的源码❌
预览网关把浏览器路由到沙箱预览与已发布应用❌

3.2 数据模型与存储路径

Teable 的关键架构决策是「记录数据落在真实 PostgreSQL 表」：

  • 元数据（空间/项目/表/字段/视图定义）由应用内部主库管理（官方迁移日志显示为 Prisma 管理的 meta database，含 255 个迁移脚本，实测自 1.10.0 发布件首次启动日志）；
  • 用户业务表的记录数据在 PostgreSQL 中以真实表的形式存放，因此可用 SQL 直连分析、可对接 BI；
  • 附件默认存本地 .assets/uploads 目录（BACKEND_STORAGE_PROVIDER=local），可切换 MinIO/S3/阿里云 OSS；
  • 实时协作与计算任务经 Redis 队列分发（BullMQ，官方管理面板有 Computed Outbox 监控页）。

💡 技术拓展：「多维表格的底层存储」业界有三种流派，决定了性能与集成天花板——

流派代表原理取舍
专有云存储Airtable自研存储，不可直连体验统一，但数据可移植性差
真实数据库表Teable、Baserow用户表即数据库表可 SQL/BI 直连；表结构变更受数据库约束
元数据+JSON 文档NocoDB记录以文档形式存储，可挂外部库可挂现有 MySQL/PG 做只读增强，复杂查询性能弱于真实表

Teable 实际采用「真实 PostgreSQL 表」路线，这也是其官方定位「PostgreSQL 上的协作平台」的由来。

3.3 技术栈

层技术（实测/官方来源）
后端NestJS（Node.js 24 运行时，发布件环境变量 NODE_VERSION=24.19.0）、Prisma ORM
前端Next.js（服务端渲染 + SPA）、React
数据库PostgreSQL（官方 Standalone 编排使用 PostgreSQL 15.4）
缓存/队列Redis 7.2（BullMQ 任务队列）
实时协作WebSocket
APIRESTful（官方 API 文档 737 个端点页面，help.teable.ai/_llms/en/api.txt）+ JavaScript SDK（npm @teable/sdk）

四、功能特性

以下特性清单依据官方 README 与文档站（查询日期 2026-10-18），标注 Standalone 形态可用性：

4.1 数据表与字段

  • 视图类型：Grid（表格）、Form（表单）、Kanban（看板）、Gallery（画册）、Calendar（日历），Standalone 全部可用；
  • 字段类型：文本、长文本、数字、货币、百分比、单选/多选、日期、勾选、评分、成员、附件、URL、邮箱、电话、公式、关联记录、查找引用、汇总、按钮、AI 字段（AI 类需 AI 能力）；
  • 公式引擎：函数式公式（官方文档含完整函数参考），支持跨表引用；
  • 数据约束：字段级校验、必填、默认值、唯一性（部分为商业版能力，见官方 Limitations）。

4.2 协作与权限

  • 三级资源层级：Space（空间）→ Base/Project（项目）→ Table（表）；
  • 四级协作角色：Owner/Creator/Editor/Viewer（另有 Commenter，官方 Space Permission 页描述四级操作范围）；
  • 邀请方式：邮件邀请、链接邀请（空间级与项目级）；
  • 记录级能力：评论、记录历史、撤销/重做、批量编辑。

4.3 自动化

  • 触发器：记录创建/更新/满足条件、表单提交、按钮点击、定时、Webhook 接收；
  • 动作：创建/更新/读取记录、HTTP 请求、条件分支、循环批处理、跨项目访问、发邮件、运行 JavaScript 脚本；
  • 许可要求（实测修正）：自托管未激活商业许可时，自动化能力返回 402 payment_required（feature=automationEnable），需购买许可就地解锁——功能实测见《Teable 1.10 功能验证手册》11.2。

4.4 API 与集成

  • 全功能 REST API + 官方 JavaScript SDK；
  • Personal Access Token 认证（作用域化）；
  • 导入导出：CSV、XLSX、Airtable 迁移；
  • SQL 直连：数据即 PostgreSQL 表，可用任意 PostgreSQL 客户端/BI 工具连接分析。

4.5 管理面板（自托管专属）

官方 Admin Panel（help.teable.ai/en/basic/admin-panel/overview）：实例用户管理、空间管理、数据库租户、实例设置（含邮件配置）、自动化运行监控、审计日志、公告发布、Schema 完整性修复等。

五、快速上手（引自官方文档）

本章为官方部署文档的最小示例摘录，未做本地实测（本地实测过程见《Teable Docker Compose 部署指南》）。

5.1 三种上手路径

官方 Deployment 页（help.teable.ai/en/deploy/choose，2026-10-18 抓取）给出三路径：

路径适用入口
Teable Cloud零部署试用https://teable.ai
Standalone 自托管小团队/评估（官方推荐 ≤50 用户）help.teable.ai/en/deploy/docker
全功能自托管需要 AI/App Builderteableio/teable-deployment 仓库

5.2 Standalone 最小流程（官方 docker.md 摘要）

官方推荐的 Standalone 部署按以下步骤（细节与逐条回显见《Teable Docker Compose 部署指南》）：

  1. 准备一台满足最低要求的服务器：官方 docker.md 标注最低 4GB 内存、2 核 CPU、40GB 磁盘、推荐 Ubuntu 20.04 LTS 以上；
  2. 创建部署目录，写入官方提供的编排文件（应用 + PostgreSQL + Redis 三服务）与 .env（数据库连接、缓存连接、PUBLIC_ORIGIN 等）；
  3. 启动服务后首次访问 http://<服务器IP>:3000 完成管理员注册（首个注册用户自动成为实例管理员）；
  4. 建空间 → 建项目 → 建表，或从 CSV/XLSX/Airtable 导入。

5.3 首个 API 调用（官方 API 文档示例路径）

官方 API 文档（help.teable.ai/en/api-doc/token）描述的最小调用链：

  1. 在网页端「个人设置 → Access Token」创建令牌（选择作用域）；
  2. 以 Authorization: Bearer <token> 调用 REST API，例如读取当前用户信息 GET /api/user/me；
  3. 用同一令牌创建空间/项目/表并写入记录，全部能力与网页端一致。

六、适用场景与限制

6.1 适用场景

  1. 团队轻量业务系统：项目跟踪、CRM、资产管理、招聘流水、内容排期——需要多人协作 + 视图分化（看板/日历/表单）的场景；
  2. 需要数据可移植的表格应用：团队已有 PostgreSQL 运维体系，希望表格数据可 SQL 直连、可接 BI（Metabase/Grafana 等）；
  3. 内网/私有化合规要求：数据不出内网，且希望保留类 Airtable 体验；
  4. 自动化中台：以记录变更/定时/Webhook 驱动业务流（配合 HTTP 动作可打通任意外部系统）；
  5. AI 数据底座（全功能形态）：以真实业务数据为上下文的 AI 会话与应用生成（需全功能部署与商业许可）。

6.2 限制与注意（依据官方文档，查询日期 2026-10-18）

  • 单数据库引擎：仅支持 PostgreSQL，不支持 MySQL 作为主库（与 NocoDB 的多数据源路线相反）；
  • AI 能力不在 Standalone：AI 会话/App Builder 需要全功能自托管（运行时平面 + 付费许可）；
  • 商业能力边界：自托管的高级能力（如部分自动化动作、高级权限）按官方 Pricing 页划分免费/付费，激活需 license key；
  • 升级节奏快：滚动发布模式下 latest 变动频繁，生产环境应固定版本并阅读 Changelog；
  • AGPL 合规：若对 Teable 做修改并提供网络服务，需按 AGPL-3.0 开源修改部分，且不得移除品牌资产（附加条款）。

七、同类选型对比

对比对象：Airtable（闭源 SaaS 原型）、NocoDB（github.com/nocodb/nocodb）、Baserow（github.com/baserow/baserow）。除 Airtable 外均为可自托管产品；所有量化数据实查于 2026-10-18（来源随行标注）。

7.1 社区活跃度（实查 2026-10-18）

指标TeableNocoDBBaserow
GitHub Stars21,89665k（65,000+）6.2k
Forks1,3575.1k767
开放 Issues1463881.1k
贡献者40——
仓库创建时间2022-112020-10（官网自述 2020 年开源）2020-12（LICENSE 版权头 2019-present）
主语言TypeScriptTypeScript/NodePython(Django)+Vue
最近一次仓库推送2026-10-18（当日仍活跃）2026-10（徽章显示持续活跃）2026-10

解读：NocoDB 起步最早、社区体量最大（65k Stars）；Teable 用约 4 年时间积累 21.9k Stars，按「Stars/仓龄」的增长斜率三者中最快，且仓库当日仍有提交（活跃密度高）；Baserow 体量小但由公司全职维护，发布稳定。

7.2 版本节奏（实查 2026-10-18，来源：各仓库 releases.atom）

维度TeableNocoDBBaserow
最新版本1.10.0（发布件 release.2026-10-16T07-06-34Z.3445，2026-10-16）2026.09.1（2026-09-29）2.4.1（2026-10-13）
版本命名时间戳.构建号（内部包版本 1.10.0）日历语义化 YYYY.MM.seq语义化 vMAJOR.MINOR.PATCH
近期节奏约 6 周 43 个 Release（2026-09-05~10-16），滚动发布月度 minor + 补丁（2026.07.0→08.0→08.1→08.2→09.0→09.1，约每 2~4 周一个）约 48 周一个 minor（2.3.1→2.4.1，2026-0710 共 5 个版本）
发布件通道latest 跟随滚动；可固定时间戳 tag固定语义 tag固定语义 tag

解读：三个产品都处于活跃维护期（最近一次 Release 均在近 4 周内）。Teable 发布频率最高、迭代最激进，选它意味着更快的功能获取与更高的升级管理成本；NocoDB/Baserow 节奏平缓，更适合「低频升级」的生产策略。

7.3 兼容矩阵（来源：各官方文档与仓库，查询日期 2026-10-18）

维度TeableNocoDBBaserowAirtable
自托管✅（AGPL-3.0 核心）✅（Sustainable Use License）✅（MIT 核心）❌
主数据库仅 PostgreSQLSQLite/MySQL/PostgreSQL（元数据）仅 PostgreSQL—（专有云）
外部数据源挂接❌（数据自建）✅（可挂已有 MySQL/PG 等）❌—
SQL/BI 直连✅（记录即 PG 表）有限（挂接库直连；自建库为文档模型）✅（记录在 PG 表）❌
视图类型Grid/Form/Kanban/Gallery/CalendarGrid/Form/Kanban/Gallery/CalendarGrid/Form/Kanban/Gallery/CalendarGrid/Form/Kanban/Gallery/Calendar/Timeline/Gantt
自动化⚠️（需商业许可激活，未激活返回 402）✅（自托管可用）✅（部分能力商业版）✅
REST API/SDK✅（实测 OpenAPI 规范 749 个端点路径）✅✅✅（限额计费）
中文界面✅（官方多语言，含简体中文）✅✅（社区翻译）✅
最低资源（官方口径）4GB 内存/2 核/40GB 磁盘1GB 内存即可运行（官方 README）4GB+ 内存（官方建议 8GB）—
AI 能力全功能形态内置（商业许可）部分集成商业版云端附加购买

解读与选型建议：

  • 数据主权 + BI 直连优先 → Teable 或 Baserow（记录即数据库表）；其中 Teable 的自动化/API 生态与中文体验更完整，Baserow 的 MIT 核心对商用衍生最友好；
  • 要在现有 MySQL/PostgreSQL 业务库上「加装」表格界面 → NocoDB（外部数据源挂接是三者中独有能力）；
  • 要 AI 会话/应用生成与表格一体化 → Teable 全功能形态（或直接 Airtable Cloud 预算充足时）；
  • 合规红线：计划云化转售选 Baserow（MIT）或自研；禁止竞争性商用场景避开 NocoDB（Sustainable Use License）；接受 AGPL 网络条款则 Teable 无额外限制；
  • 资源受限环境：NocoDB 最低门槛最低（1GB 内存），Teable/Baserow 建议 4GB 起步。

八、参考链接

  1. GitHub 仓库：https://github.com/teableio/teable （LICENSE、README、dockers/ 目录，查询日期 2026-10-18）
  2. 官方文档站部署选择页：https://help.teable.ai/en/deploy/choose （查询日期 2026-10-18）
  3. 官方文档站架构页：https://help.teable.ai/en/deploy/architecture （查询日期 2026-10-18）
  4. 官方文档站环境变量页：https://help.teable.ai/en/deploy/env （查询日期 2026-10-18）
  5. 官方 Docker 部署指南：https://help.teable.ai/en/deploy/docker （查询日期 2026-10-18）
  6. 官方 API 文档：https://help.teable.ai/en/api-doc/token （查询日期 2026-10-18）
  7. 官方定价页：https://teable.ai/pricing （查询日期 2026-10-18）
  8. 全功能部署仓库：https://github.com/teableio/teable-deployment （查询日期 2026-10-18）
  9. 竞品仓库：https://github.com/nocodb/nocodb 、https://github.com/baserow/baserow （活跃度数据查询日期 2026-10-18）
  10. 实测部署篇：《Teable Docker Compose 部署指南》；配置实测篇：《Teable 1.10 配置参数详解》；功能实测篇：《Teable 1.10 功能验证手册》