ToolJet 自托管实例许可（License）完整指南：试用、商业与企业版配置与续期实战-开发者社区

ToolJet 自托管实例许可（License）完整指南：试用、商业与企业版配置与续期实战

【免费下载链接】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 自托管（Self-Hosted）实例的付费许可配置展开，涵盖三种许可证类型（Trial 试用、Business 商业、Enterprise 企业）的获取方式、License Key 更新流程、许可证有效期规则与到期后的行为，并结合仓库源码说明许可证在服务端如何被存储、解密与强制执行。读完本文，你将能在自己的 ToolJet 实例上完成试用许可激活、升级到付费计划、查看剩余天数以及处理到期与续期的完整流程。

三类许可证：适用场景与获取方式

ToolJet 为自托管平台提供三种许可证，分别面向不同的使用阶段与规模需求（详见 server/src/modules/licensing/constants/index.ts 中LICENSE_TYPE枚举对basic | trial | business | enterprise的定义）：

许可证类型	费用	有效期	获取方式	适用场景
Trial License（试用）	免费	14 天	新用户在 onboarding 引导中选择；老用户联系销售或支持团队索取试用 Key	在购买前体验全部高级功能
Business License（商业）	付费	3 个月（可续期）	在 ToolJet 定价页直接购买	需要 SSO、审计日志、Git 同步等团队级能力的正式使用
Enterprise License（企业）	付费（可定制）	按合同定制	联系销售团队	多实例部署、Air-gapped 离线部署、自定义数据保留策略等企业场景

说明：从源码结构看，许可证类型对应的计划套餐在 PLAN_DETAILS 中有完整定义——basic对应免费 Basic Plan（2 个 Builder、50 个 End User、2 个应用），business对应 Team 计划（无限 End User 与无限应用，含 SSO、自定义用户组、审计日志、Git 同步、多环境等），enterprise为自定义定价并额外提供自定义 AI 额度、多实例部署、Air-gapped 部署与高级 SLA。

新用户：如何启用 14 天试用

在首次完成实例部署与注册时，按照 onboarding 流程选择14 天试用即可自动激活试用许可。
试用期内即可完整使用 OpenID SSO 登录、审计日志（Audit Logs）等高级功能，以便充分评估平台能力。

存量用户：如何申请试用 Key

已经运行中的实例，需要向 ToolJet 销售或支持团队申请试用许可证 Key。
收到 Key 后，按下文「更新 License Key」一节中的步骤填入实例即可生效。

更新 License Key（适用于试用与正式许可）

无论是激活试用、从试用升级到商业版，还是续期企业版，操作路径完全一致：

以Super Admin（超级管理员）身份登录实例，确保访问的是正确的实例 URL。
进入Settings（设置）页面。
在License Key选项卡中，将官方提供的许可证 Key 粘贴并保存。
在 Settings 页面的 License 选项卡中可切换到Limit（限额）子页签，查看当前实例可用资源状态，包括：
- Super Admins（超级管理员）数量
- Builders（构建者，源码中对应users.editor席位）数量
- End Users（终端用户，源码中对应users.viewer席位）数量

关于席位口径：从 LICENSE_LIMITS_LABEL 可以看到，内部以editor/viewer命名的席位对外统一显示为Builders/End Users，UI 文案从不暴露「editor/viewer」字眼，理解限额时请以用户可见名称（Builders、End Users、Super Admins）为准。

服务端如何存储与读取 License Key

在服务端，License Key 保存在instance_settings表中key = 'LICENSE_KEY'的记录里（见 server/src/modules/licensing/repository.ts）。其读取逻辑有两个值得注意的实现细节：

请求级缓存：getLicense()会通过RequestContext在同一请求内缓存读取结果（memo key 为tj_license_setting），避免一次请求中多次访问数据库；
事务旁路：当调用方传入事务绑定的manager时，会绕过缓存直接从事务内查询，保证迁移等场景下的数据隔离一致性。

从 server/src/modules/licensing/services/init.service.ts 可知，社区版（CE）的许可证初始化是一个「空实现」——License.Reload('')加载空 Key 后判定为无效，所有 Getter 自动回退到社区版BASIC_PLAN_TERMS（功能开关全部关闭、多数限额为 UNLIMITED）。而企业版（EE，自托管）才会真正解密 Key 并依据其内容激活对应功能与限额。

购买正式许可证

当你确定需要的付费计划后，按下述流程完成购买与激活。

方案 A：选择 Business（商业）计划

在定价页完成购买并支付。
等待 ToolJet 团队在24-48 小时内联系你完成 onboard（入驻引导）。
收到商业版 License Key 后，按上文「更新 License Key」步骤填入即可激活。

⚠️ 重要提醒：商业版 License Key 有效期为3 个月。到期前需续期才能继续完整使用 ToolJet 的全部功能。

方案 B：选择 Enterprise（企业）计划

提交意向后，销售团队会在24-48 小时内响应并安排 onboard。
收到企业版 License Key 后，同样按上文步骤更新。
企业版剩余可用天数会直接展示在实例的**仪表盘（Dashboard）**上，方便你随时掌握授权状态。

许可证有效期与到期行为

各类型有效期一览

许可证类型	有效期
Trial（试用）	14 天
Business（商业）	3 个月
Enterprise（企业）	按合同定制

到期后会发生什么

试用 Key 到期后，OpenID SSO 登录、审计日志等高级功能将被限制访问，但不会丢失任何数据。
商业版或企业版 Key 到期后，实例将自动回退为免费计划：你依然可以创建无限数量的应用、工作区并添加用户，但 OpenID 与审计日志等高级功能不再可用。
任何类型的许可证到期都不会影响既有应用与数据的安全性。

从源码角度看，这种「静默回退」是刻意设计的容错机制：expiry字段格式为YYYY-MM-DD，有效期截止到当日23:59:59；当 Key 过期或无法解析时，LicenseBase 会让所有 Getter 回退到注入的BASIC_PLAN_TERMS，全程不抛出硬错误，实例始终可用（见 server/src/modules/licensing/AGENTS.md 的 invariants 说明）。

功能管控的底层实现

许可证对高级功能的强制管控在服务端通过license guards实现（目录 server/src/modules/licensing/guards）：

feature.guard.ts在对应功能开关（feature term）为假时抛出HTTP 451状态码拒绝访问——选用 451 而非 403 正是为了让前端能够识别「因许可受限」这一语义并展示升级引导；
sso.guard.ts、auditLog.guard.ts、workflow.guard.ts等则是在FeatureGuard之上绑定固定的LICENSE_FIELD（如OIDC、AUDIT_LOGS），实现按资源的精确管控；
功能开关的定义集中在 LICENSE_FIELD，涵盖 OIDC、LDAP、SAML、审计日志、Git 同步、多环境、自定义用户组、自定义域名、白标（white labelling）等数十个维度。

常见问题（FAQ）

1) 如何升级或续期我的许可证？

当商业版或企业版 Key 临近到期时：

点击实例内出现的Upgrade / Renew（升级或续期）按钮——除 Settings 页面外，部分其他页面也会展示升级/续期的横幅或 CTA；
或发送邮件至 hello@tooljet.com 获取延期后的 License Key；
如果需要增加用户数量，请先联系官方渠道确认当前套餐的容量方案，再提出扩容请求。

2) 我的许可证有效期是多久？

持有有效许可证时，可以在 Settings 页面查看有效期。各类型期限请参考上文「各类型有效期一览」表格。

3) 许可证到期了怎么办？

到期后实例自动回退为免费计划，应用、工作区与用户数据不受影响；
重新购买或续期后，填入新的 License Key 即可恢复高级功能；
官方对试用到期的建议是在 14 天内完成升级，以便持续体验全部高级能力。

4) 如何增加用户数量？

方式一：直接续购商业计划（购买前请确认该计划包含的高级功能清单是否满足需求）；
方式二：通过官方 Slack 或邮件（hello@tooljet.com）联系支持团队，说明你的用户规模需求，团队会协助调整许可容量。

⚠️ 最后提醒：你的 License Key 属于私有信息，严禁与任何第三方分享。Key 泄露可能导致授权被滥用，影响实例的正常使用与续期。

总结

ToolJet 自托管实例的许可证体系设计得非常务实：14 天试用让新用户可以无门槛体验全部高级功能，商业版与企业版则分别覆盖团队级与组织级的规模需求；到期回退到免费计划而非直接停机，保证了业务连续性。在服务端，许可证以LICENSE_KEY形式存储在实例设置表中，由许可模块统一解密并物化为功能开关与席位限额，再通过 451 状态码对未授权功能进行精细化管控——理解这一机制，能帮助你在配置、升级与排障时做到心中有数。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

ToolJet 自托管实例许可（License）完整指南：试用、商业与企业版配置与续期实战