
ToolJet 3.0.0-LTS 自托管部署的许可证体系Basic / Trial / Paid 类型、AI 积分机制与 License Key 更新流程【免费下载链接】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/ToolJetSelf-Hosted ToolJet 采用许可证模型来控制实例可用的功能与配额本文基于官方文档 Self-Hosted Licensing 指南结合服务端 licensing 模块源码完整讲解三种许可证类型Basic、Trial、Paid的差别、AI 积分AI Credits的消耗与计算规则以及在 Settings 页面更新 License Key 的具体操作步骤并深入源码验证许可证过期回退、Basic 计划功能裁剪的底层实现帮助你在自托管环境中正确选型、换发和管理许可证。一、Self-Hosted ToolJet 的许可证模型概述Self-Hosted ToolJet 运行在许可证License模型之上实例启动后默认运行在免费档位如需更高配额或企业级功能需要向 ToolJet 团队申请生成许可证密钥License Key并在实例的 Settings 页面中填入生效。从源码结构看这一模型由服务端server/src/modules/licensing/模块统一实现。license 类型枚举 定义了四种许可证类型export enum LICENSE_TYPE { BASIC basic, TRIAL trial, ENTERPRISE enterprise, BUSINESS business, }其中basic对应免费的 Basic 档trial与business/enterprise分别对应试用与付费订阅这与官方文档描述的Basic、Trial、Paid三类许可证一一对应。二、三种许可证类型详解2.1 Basic License免费版Basic 是免费许可证用户可以获得创建应用、预定义用户组、社区支持等基础能力适合个人或小团队满足基本需求无需配置任何许可证密钥。源码中 Basic 档的默认条款定义在 BASIC_PLAN_TERMS核心限制包括项目Basic 计划限制应用数 / 工作区数 / 用户数代码层面为UNLIMITED实际配额见下方套餐说明Super Admin 数量1审计日志Audit Logs关闭保留天数 0OpenID Connect / SAML / LDAP / SCIM全部关闭自定义样式 / 白标 / 自定义主题关闭多环境Multi-environment关闭多人协同编辑 / 评论关闭Git 同步 / 查询文件夹 / 可观测性关闭自定义用户组关闭工作流工作区级最多 200 个、每日 500 次、每月 10000 次实例级最多 1000 个、每日 25000 次、每月 50000 次执行超时 60 秒应用多页面 / 组件权限 / 查询权限关闭Promote / Release / 应用历史 / JS 库关闭同时 BASIC_PLAN_SETTINGS 将 Basic 档的部分实例设置强制置为关闭包括个人工作区、多人协同编辑与评论功能。2.2 Trial License试用版ToolJet 提供有效期14 天的试用许可证期间可以访问全部高级premium功能方便按自身需求评估产品。试用密钥同样需要联系 ToolJet 团队生成。源码中 LICENSE_TRIAL_API 提供了试用密钥生成的接口地址可通过环境变量TJ_LICENSE_TRIAL_API覆盖并且试用档在工作流等配额上同样适用 Basic 计划的条款见下文LicenseBase.workflows获取器对LICENSE_TYPE.TRIAL的处理。2.3 Paid License付费版付费许可证对应不同的订阅计划。确定合适的计划后联系 ToolJet 团队完成入驻流程即可获得正式密钥。服务端在 PLAN_DETAILS 中内置了各订阅计划的展示信息注意具体价格以官方定价页为准以下为源码中的计划结构计划定价源码内数据主要特性源码内数据Basic Plan免费2 个 builder、50 个 end user、2 个应用、每月 30 个共享 AI 积分、预定义用户角色、Slack 社区支持Pro79 美元/builder/月无限 builder、额外 50 个 end user、最多 5 个应用、每 builder 200 AI 积分/月、自定义样式、应用白标、版本控制、邮件支持Team199 美元/builder/月年付 8 折无限 end user、无限应用、每 builder 500 AI 积分/月、SSO 集成、自定义用户组、全平台白标、Super Admin 控制台、审计日志、Git 同步、多环境dev/staging/prod、优先支持Enterprise定制报价在 Team 基础上自定义 AI 积分、自定义 AI 模型选项、多实例部署、Air-gapped 部署、自定义数据保留策略、高级 SLA 等可选服务此外源码还为部分计划定义了差异条款例如 BUSINESS_PLAN_TERMS 与 ENTERPRISE_PLAN_TERMS 分别将审计日志保留上限设为 14 天与 30 天而 WORKFLOW_TEAM_PLAN_TERMS 将 Team 计划的工作流配额放宽为实例级不限。三、许可证如何生效License 与 LicenseBase 的解析机制更新密钥后服务端会把解析出的许可证条款封装到License对象中供全站守卫guard使用。License 类 是一个单例通过静态方法Reload(key, updatedDate)重建实例内部以BASIC_PLAN_TERMS作为基础条款继承自LicenseBase。LicenseBase 是真正的核心它把许可证 JSON 数据中的各项字段解析为可读属性几个关键设计值得注意无效或过期即回退 Basic私有判定IsBasicPlan返回!this.isValid || this.isExpired而licenseType获取器在密钥无效或过期时直接返回LICENSE_TYPE.BASIC。这就是文档 FAQ 中许可证过期后实例回退到 Basic 计划的底层实现。所有配额与特性获取器都遵循同一模式以oidc()、auditLogs()、gitSync()等为例若处于 Basic 计划则读取BASIC_PLAN_TERMS中对应的features值均为false否则读取许可证数据中的特性开关。因此一旦密钥过期OpenID SSO、审计日志等高级功能会立即失效但应用数据本身不受影响。旧版许可证的兼容性兜底对部分新引入的字段如 modules、app 页面、promote/release 等当许可证数据中未提供时默认视为开启Not passed set to true for older licenses and trial保证老密钥升级后功能不被意外裁剪。AI 计划模式aiPlan获取器返回byok | selfhostai | credits三种模式未显式指定时默认为credits对应文档中按积分消耗的 AI 计费方式。前端可见性features获取器会把 openid、auditLogs、saml、customStyling、whiteLabelling、multiEnvironment、gitSync、ai、aiPlan 等开关聚合成一个对象下发供前端如 Settings 的 license/limits 页签渲染当前实例的可用能力与到期时间。四、AI Credit SystemBuild with AI 的积分体系从v3.5.0-ee-lts起ToolJet 支持 Build with AI允许用自然语言构建应用。AI 积分在实例级别分配每次执行 AI 操作时消耗按定价计划配置每月自动补充未使用的积分不会滚存到下月会在每个计费周期结束时过期。4.1 积分消耗标准标准操作Standard Operations以下 AI 辅助操作每次消耗3 个积分生成或编辑单个 UI 组件生成或修改查询编写业务逻辑调试辅助生成数据库表批量修改组件样式生成或修改多组件布局基于文档提供指引高级构建Advanced Builds整站应用 UI 生成消耗10 个积分。4.2 积分计算与分配规则AI 积分依据定价计划计算并且按实例中的每个 builder 分配分配后的积分在实例内所有工作区、由所有用户共享使用。这与源码中 PLAN_DETAILS 各计划的 AI 配额一致Basic 为每月 30 个共享积分Pro 为每 builder 200 积分/月Team 为每 builder 500 积分/月Enterprise 支持自定义积分。在服务端AI 积分余额由 AI 模块暴露的getCreditsBalance能力键GET_CREDITS_BALANCE对外提供查询AI 功能本身的开关则受许可证的ai特性位控制LicenseBase.aiFeature获取器即 Basic 计划下该功能不可用。五、更新 License Key 的操作步骤收到 ToolJet 团队提供的许可证密钥后按以下步骤更新所需角色Super Admin进入实例的 Settings 页面示例 URLhttps://app.corp.com/instance-settings/license。在 license key 页签中填入提供的许可证密钥。在 Settings 页面的 license 页签下可以进入 limit配额子页签查看当前可用的总用户数、builder 数、end user 数以及许可证密钥的到期日期。从源码结构看上述操作最终落到 licensing 模块的 LicenseController路由前缀licenseupdateLicense方法接收LicenseUpdateDto完成密钥更新能力键FEATURE_KEY.UPDATE_LICENSE标识该操作权限而getAccess/getLicenseTerms等端点则向前端返回当前特性开关与配额对应LICENSE_FIELD枚举中的allUsers、appCount、usersCount、oidcEnabled、expiry等字段这正是 limit 页签所展示数据的来源。六、常见问题与注意事项Q订阅过期后会怎样如果付费或试用许可证到期实例将回退到 Basic 计划失去 OpenID SSO 登录、审计日志等高级功能的访问权限但不会丢失任何数据随时续费即可恢复高级功能。该行为与源码中 LicenseBase 的实现完全一致——isExpired为真时licenseType返回LICENSE_TYPE.BASIC各特性获取器随即切换到BASIC_PLAN_TERMS中全部关闭的开关而应用、数据源等持久化数据不受影响。重要安全提示许可证密钥属于私有资产严禁分享给任何第三方。七、小结Self-Hosted ToolJet 提供Basic免费/ Trial14 天/ Paid订阅计划三类许可证付费计划按 builder 计费并可配置自定义配额许可证解析、过期回退、特性裁剪与配额下发均由服务端 licensing 模块 中的License/LicenseBase与各 guard 实现Basic 计划的裁剪条款集中在 BASIC_PLAN_TERMSAI 积分按 builder 分配、全实例共享、按月重置且不滚存标准操作 3 积分、整站 UI 生成 10 积分换发密钥只需 Super Admin 在 Settings 的 license 页签中更新并可在 limit 页签核对用户配额与到期日。【免费下载链接】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),仅供参考