ToolJet 平台全景解析低代码内部工具构建平台的架构、核心能力与实现原理【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJet本文基于 ToolJet 仓库中 3.0.0-LTS 版本文档docs/versioned_docs/version-3.0.0-LTS/getting-started/platform-overview.md展开系统讲解 ToolJet 这个低代码平台的核心定位、连接数据源 → 可视化搭建界面 → 工作流自动化 → 安全与管控四大工作环节以及可视化应用构建器、90 数据源集成、ToolJet Database、工作流自动化、企业级安全、SSO、多环境与多人协同编辑等关键能力。读完本文你既能从文档层面理解 ToolJet 的完整功能版图也能从源码层面服务端模块、WebSocket 协同网关、PostgreSQL 技术栈印证这些能力的真实实现。一、ToolJet 是什么一个面向内部工具的开源低代码平台官方文档对 ToolJet 的定义是一个让开发者快速构建并部署定制化内部工具internal tools的低代码平台。它具备以下核心特质拖拽式应用构建器通过可视化画布拖放预置组件即可搭建复杂应用无需从零写前端。LTS 3.0.0 文档提到平台内置 45 个预置组件而当前仓库根目录 README.md 的 Features 一节已将这一数字更新为80 响应式组件Tables、Charts、Forms、Lists、Progress Bars 等说明组件库在版本演进中持续扩充。开箱即用的数据源连接直接连接主流数据库、API 与 SaaS 应用。LTS 文档表述为50 应用、数据库与 API当前 README.md 中则写作90 数据源覆盖数据库、API、云存储与 SaaS 工具。基于分组的权限系统group-based permission system便于团队内的用户访问管理。代码能力内嵌在应用内直接运行 JavaScript 与 PythonREADME 称之为 Code Anywhere把业务逻辑写在应用里而不是外部系统。从仓库结构看平台整体由几个部分组成目录职责frontend/React 可视化构建器、应用画布、组件库src/AppBuilder/、src/_ui/server/NestJS 服务端包含约 70 个业务模块src/modules/承载数据源、查询、权限、工作流等能力plugins/ 与 marketplace/数据源/连接器插件plugins/packages下 49 个插件包marketplace/plugins下 45 个合计 90与 README 90 Data Sources 的表述相互印证docs/Docusaurus 文档站含按版本归档的文档如version-3.0.0-LTSdocker/、deploy/Docker 镜像、Docker Compose、Helm、Kubernetes、OpenShift 部署清单cypress-tests/E2E 测试套件按 platform、marketplace、git-sync 等场景拆分部署形态上仓库根目录的 docker-compose.yaml 展示了完整运行时依赖PostgreSQL 13 Redis 7 PostgREST v12.2.0 插件服务 服务端 客户端其中 PostgREST 作为 ToolJet Database 对外暴露的 REST 网关见下文。生产与开发镜像分别由docker/ce-production.Dockerfile、docker/server.Dockerfile.dev等构建deploy/下还提供 Helm chartdeploy/helm/与 AKS/GKE 的 Kubernetes 清单。二、ToolJet 的工作方式构建内部工具的四个核心步骤LTS 文档将 ToolJet 的开发流程归纳为 4 个核心步骤Connect Data Sources → Design Interfaces → Automate Workflows → Secure and Manage。这四步与仓库中的服务端模块一一对应1. Connect Data Sources连接数据源文档原文利用 ToolJet 强大的集成能力连接任意数据源平台支持 50 多种应用、数据库与 API 的无缝集成。在仓库中数据源能力由以下模块共同实现server/src/modules/data-sources/数据源的创建、连接管理server/src/modules/data-queries/查询的定义与执行server/src/modules/plugins/插件运行时负责加载plugins/下的 TypeScript 插件并调用其操作plugins/packages/每个插件是一个独立 npm 包含manifest.json、操作定义等如postgresql、mysql、mongodb、redis、restapi、google sheets、slack、stripe等plugins/schemas/ 中的manifest.schema.json与operations.schema.json定义了插件的统一契约。从源码结构看连接器不是硬编码在服务端而是通过插件包 manifest 契约的方式动态加载这解释了为什么插件目录可以用 Lerna 管理多包plugins/lerna.json也能用仓库自带的 CLI 脚手架cli/创建新连接器。2. Design Stunning Interfaces拖拽设计界面文档原文拖放 Table、Chart、Form 等 UI 组件几分钟内搭建自定义应用并与数据源绑定通过 JavaScript 或 Python 注入业务逻辑。前端画布实现集中在 frontend/src/AppBuilder/1000 文件含组件属性面板、画布、组件库服务端则通过 server/src/modules/app/、server/src/modules/apps/、server/src/modules/versions/ 管理应用及其版本化的页面定义Pages/Components/Layouts 实体可在 server/migrations/ 中的CreatePageTable、CreateComponentTable、CreateLayoutTable等迁移文件中看到建模过程。业务逻辑侧在应用内运行 JS/Python对应工作流与执行引擎能力Python 执行环境在 docker/nsjail/python-execution.cfg 中以沙箱配置形式出现体现了服务端对脚本执行的隔离约束。3. Automate Complex Workflows自动化复杂工作流文档原文在 ToolJet 中开发多步骤工作流以自动化业务流程并可便捷地将这些工作流集成进应用中。对应实现位于 server/src/modules/workflows/工作流定义、执行、节点/边的编排历史迁移中也有CreateWorkflowExecutionEntity、CreateWorkflowExecutionNodeEntity、CreateWorkflowScheduleTable等文件佐证其执行记录 定时调度的数据模型。README 将 Workflows 列为企业版能力支持分支逻辑、定时触发或 Webhook 触发。4. Secure and Manage安全与管控文档原文用细粒度权限设置和审计日志保护内部工具用版本控制保持质量一致性用可观测性工具追踪性能。仓库中的对应模块非常清晰server/src/modules/audit-logs/审计日志迁移CreateAuditLogs可追溯其建表过程server/src/modules/group-permissions/、server/src/modules/roles/、server/src/modules/casl/、server/src/modules/ability/基于分组的细粒度权限CASL 能力模型后续迁移文件如AddGranularPermissionsTable、CreateComponentPermissions表明权限粒度已细化到组件、页面、查询、数据源级别server/src/modules/app-git/、server/src/modules/git-sync/Git 同步与版本历史迁移中存在CreateTableGithubSSH、CreateTableGithubHTTPS、AddSSHBranchColumn等文件server/src/modules/metrices/ 与 server/src/otel/指标与 OpenTelemetry 可观测性埋点。三、核心功能逐项解析LTS 文档在四大步骤之后给出了 8 个关键功能的概览。下面逐项结合源码印证其实现落点。1. Visual App Builder可视化应用构建器文档描述通过拖拽界面与预置组件创建美观的前端界面。前端画布与组件体系位于 frontend/src/AppBuilder/ 与 frontend/src/_ui/580 文件。组件的默认属性、事件配置由服务端统一管理——server/data-migrations/ 目录下 250 个数据迁移脚本如ModalWidget-size.ts、MigrateStarRatingProperties.ts、BackfillMaxLimitForMultiselectV2.ts正是平台随版本演进不断调整组件默认配置的历史记录也是低代码平台组件契约演进这一典型问题的直接证据。2. Integrations集成文档描述与 50 应用、数据库、API 无缝集成。如前所述当前仓库plugins/packages49 个marketplace/plugins45 个合计 90 连接器README 的90 Data Sources与之吻合。每个插件目录内含manifest.json声明插件元数据、操作定义.ts与资源声明.json例如 plugins/packages/postgresql/。插件的 JSON Schema 契约定义在 plugins/schemas/manifest.schema.json 与 plugins/schemas/operations.schema.json新增连接器可通过 marketplace/_templates/plugin/ 的模板快速生成。3. ToolJet Database内置无代码数据库文档描述构建在 PostgreSQL 之上的稳健可扩展数据库方案支持无代码建表与管理让用户轻松构建、管理和扩展数据库。实现层面服务端模块 server/src/modules/tooljet-db/ 提供独立的 controller、repository 与 services而整个 compose 栈中的PostgREST v12.2.0docker-compose.yaml 第 78–86 行正是其对外提供 REST 访问的通道。迁移文件清晰还原了它的演进1667364798950-CreateInternalTables.ts建表、1721236971725-MoveToolJetDatabaseTablesFromPublicToTenantSchema.ts按租户隔离 schema、1718264886184-EnableAggregationInTooljetDatabase.ts开启聚合等。可以推断ToolJet Database 本质上是多租户 PostgreSQL schema PostgREST 只读/受控访问 无代码表管理 UI的组合。前端配套界面位于 frontend/src/TooljetDatabase/。4. Workflow Automation工作流自动化文档描述简化复杂手工业务流程的自动化降低工程投入。对应 server/src/modules/workflows/。从迁移历史看工作流模型包含执行记录WorkflowExecution及节点/边子表、调度表AddWorkflowScheduleTable后续迁移1758009004418-AddWorkflowGranularPermissionsToExistingAdminGroups.ts将工作流纳入了细粒度权限体系。前端画布入口在 frontend/src/WorkflowEditor/。5. Enterprise-Grade Security企业级安全文档描述以高级安全特性与可扩展基础设施满足企业团队需求。服务端安全能力散布在多个模块中server/src/modules/encryption/敏感凭据加密README 声明采用 AES-256-GCM、server/src/modules/session/会话管理、server/src/modules/scim/SCIM 用户供给、server/src/modules/casl/授权模型。数据流方面README 强调 proxy-only data flow——数据查询经由 ToolJet 服务端代理转发前端不直连用户数据源。6. SSO Support单点登录文档描述支持 Okta、Google、Azure AD 与 OpenID Connect 等提供方的 SSO。实现位于 server/src/modules/auth/oauth/其中util-services/oidc-auth.service.tsOIDC 通用接入Okta/Google/Azure AD 均可走此协议与util-services/saml.service.tsSAML两条服务分别处理两类主流企业登录协议。相关数据模型见迁移1642432246029-CreateSSOField.ts、1706113492448-AddInstanceLevelSSOInInstanceSettings.ts实例级 SSO 配置docs/docs/security/ 下也有对应的安全文档。7. Multiple Environments多环境管理文档描述创建与管理多个环境以高效管理应用生命周期使开发、测试、生产等不同阶段可被无缝处理。服务端模块 server/src/modules/app-environments/ 管理应用环境实体迁移文件1667070216520-createEnvironments.ts、1675844361118-MigrateEnvironmentsUnderWorkspace.ts环境迁移到 Workspace 之下、1702419267642-AddCustomLogoutUrl.ts前后的一系列环境相关迁移如AddIsDefaultToOrganizations表明环境体系与 Workspace/Organization 深度绑定。组织级常量按环境隔离的能力则由 server/src/modules/organization-constants/ 与PopulateCEOrgConstantsToOtherEnvs等回填迁移支撑。8. Multiplayer Editing多人协同编辑文档描述多个用户可实时协作开发应用来自不同团队成员的同时编辑与贡献简化了开发流程打造更动态、交互性更强的工作空间。这是文档中唯一可以直接给出完整源码级原理的功能协议层采用 YjsCRDT 库。前端依赖中声明yjs: ^13.5.46frontend/package.json同步网关服务端 server/src/modules/events/yjs.gateway.ts 是一个 NestJS WebSocket 网关路由为/yjs支持子路径部署maybeSetSubPath(/yjs)内部直接复用y-websocket的setupWSConnection以应用 ID 作为 Yjs 文档名setupWSConnection(connection, request, { docName: appId })——即每个正在被编辑的应用对应一份共享文档鉴权连接建立时从 Cookie 中提取tj_auth_token经SessionUtilService.verifyToken校验 JWT失败则以 WebSocket 错误码 4000 关闭连接并禁止客户端重连基础设施依赖 docker-compose.yaml 中的 Redisappendonly yes协同状态经 server/src/helpers/redis.ts 相关的持久化机制落到 Redis开关控制迁移1693368672418-addEnableMultiplayerSettingsInInstanceSettings.ts将多人协作做成实例级配置项说明该能力可按部署实例启停。四、部署形态与版本演进观察部署仓库提供 Dockerdocker/ 下的 CE 预览/生产 Dockerfile、docker/ce-entrypoint.sh、Docker Composedocker-compose.yaml、Helmdeploy/helm/、Kubernetesdeploy/kubernetes/ 含 AKS/GKE 子目录与 OpenShiftdeploy/openshift/多套方案README 的 Quickstart 给出了一行式docker run命令推荐使用 LTS 镜像以获得稳定性。版本文档文档站按版本归档docs/versioned_docs/ 下有version-2.50.0-LTS与version-3.0.0-LTS本文所依据的 docs/versioned_docs/version-3.0.0-LTS/getting-started/platform-overview.md 即为 3.0.0-LTS 的平台概览组件数45 → 80与数据源数50 → 90在两代文档间的差异本身就反映了平台能力的增长曲线。测试保障cypress-tests/ 包含 170 E2E 用例并按 platform、marketplace、git-sync 等场景拆分为多个 Cypress 配置如 cypress-tests/cypress-platform.config.js覆盖构建器与平台功能回归。五、小结ToolJet 的平台概览可以浓缩为一句话用数据源插件化 可视化画布 应用内代码 工作流引擎四个支柱把内部工具的构建从写代码变成配置与拖拽再用权限、审计、多环境与 Git 同步把它纳入企业级管控。从仓库源码看文档中的每一项能力都能找到对应模块数据源落在plugins/与data-sources/画布落在frontend/src/AppBuilder/内置数据库落在 PostgreSQL PostgREST tooljet-db/协同编辑落在 Yjs WebSocket 网关SSO 落在 OIDC/SAML 服务环境管理落在app-environments/。对于希望深入理解该平台的开发者建议从 README.md 的快速开始入手再按本文列出的模块路径逐层阅读实现。【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考