ToolJet 版本选择指南:LTS、Pre-Release 与 Past 版本的正确选型与部署实践

ToolJet 版本选择指南:LTS、Pre-Release 与 Past 版本的正确选型与部署实践 ToolJet 版本选择指南LTS、Pre-Release 与 Past 版本的正确选型与部署实践【免费下载链接】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 的三大版本发行线——Long-Term Support (LTS)、Pre-Release、Past versions帮助你在生产部署、功能尝鲜与历史兼容之间做出正确决策。读完本文你将掌握 ToolJet 版本号与 Docker 镜像 Tag 的命名规律、各 LTS 版本对应的拉取命令、不同版本线的维护边界以及基于 Docker Compose 完成 LTS 部署和升级的完整实操路径。本文内容基于仓库中 version-2.50.0-LTS 文档线并结合仓库内 Docker 构建与部署脚本源码进行佐证。ToolJet 版本体系总览三条发行线ToolJet 的版本被划分为三种主要类型理解这三者的差异是选型的第一步类型定位维护状态生产环境适用性LTS长期支持绝大多数用户的推荐选择优先修复 Bug、持续更新、保持稳定强烈推荐Pre-Release预发布尝鲜最新特性实验性质可能包含未成熟功能与缺陷不建议Past过往版本已停止维护的旧版本不再接收更新、Bug 修复与安全补丁不推荐从仓库的 versions.json 可以看出当前被正式维护的文档线为3.0.0-LTS与2.50.0-LTS本文所属的 2.50.0-LTS 即其中一条仍在维护的 LTS 文档线其全部部署类文档位于 setup 目录。官方信息提示ToolJet 3.0 LTS 已正式发布官方鼓励所有用户升级以享受最新特性与改进相关变更细节可查阅 3.0 LTS 的 release notes并配合 upgrade-to-v3.md 与 v2-migration.md 完成迁移。一、LTS 版本生产环境的首选ToolJet 官方高度推荐大多数用户使用 LTS 版本。LTS 版本在 Bug 修复、功能更新与整体稳定性上享有最高优先级能够提供可靠的使用体验是生产环境对稳定性与持续性能有硬性要求的理想选择。LTS 版本的发布节奏与生命周期结合 docker.md 的升级章节 可以确认 LTS 的具体维护策略新的 LTS 版本每3–5 个月发布一次每个 LTS 版本的生命周期End-of-Life至少 18 个月LTS 镜像 Tag 遵循固定命名规范以LTS-前缀或EE-LTS/ee-lts标识后接版本号例如tooljet/tooljet:EE-LTS-latest。这一节奏意味着如果你正在运行某一 LTS 版本在 18 个月的支持窗口内都能持续获得维护更新无需频繁大版本迁移。2.50.0-LTS 文档线中的 LTS 版本列表以下表格完整列出该文档线收录的 LTS 版本及其发布信息。镜像统一托管于 Docker Hub 的tooljet/tooljet仓库命令可直接复制使用其中Latest EE-LTS为跟随最新 LTS 的滚动标签版本发布日期Docker 拉取命令Latest EE-LTSN/Adocker pull tooljet/tooljet:EE-LTS-latestv3.0.24-ee-ltsJanuary 3, 2025docker pull tooljet/tooljet:v3.0.24-ee-ltsv3.0.23-ee-ltsJanuary 2, 2025docker pull tooljet/tooljet:v3.0.23-ee-ltsv3.0.22-ee-ltsDecember 30, 2024docker pull tooljet/tooljet:v3.0.22-ee-ltsv3.0.21-ee-ltsDecember 20, 2024docker pull tooljet/tooljet:v3.0.21-ee-ltsv3.0.20-ee-ltsDecember 20, 2024docker pull tooljet/tooljet:v3.0.20-ee-ltsv3.0.19-ee-ltsDecember 17, 2024docker pull tooljet/tooljet:v3.0.19-ee-ltsv3.0.18-ee-ltsDecember 12, 2024docker pull tooljet/tooljet:v3.0.18-ee-ltsEE-LTS-2.50.9.48December 9, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.48EE-LTS-2.50.9.47November 27, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.47EE-LTS-2.50.9.46November 26, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.46EE-LTS-2.50.9.45October 24, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.45EE-LTS-2.50.9.44October 9, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.44EE-LTS-2.50.9.43October 3, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.43EE-LTS-2.50.9.42September 30, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.42EE-LTS-2.50.9.41September 24, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.41EE-LTS-2.50.9.40September 18, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.40EE-LTS-2.50.9.39September 12, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.39EE-LTS-2.50.9.38September 12, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.38EE-LTS-2.50.9.37September 11, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.37EE-LTS-2.50.9.36September 10, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.36EE-LTS-2.50.9.35September 3, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.35EE-LTS-2.50.9.34August 30, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.34EE-LTS-2.50.9.33August 26, 2024docker pull tooljet/tooljet:EE-LTS-2.50.9.33从命名上可以读出版本线的演进脉络EE-LTS-2.50.9.xx属于 2.50 系列 LTS 的补丁迭代而v3.0.x-ee-lts是 3.0 大版本新一代 LTS 基线的系列标签两者在文档表中并存反映了 2.50 → 3.0 的 LTS 迁移窗口期。从构建源码看 LTS 镜像的组成LTS 镜像并不是一个空壳容器而是集成了完整运行时的单容器发行。以仓库中的 ee-production.Dockerfile 为例可以印证 EE-LTS 镜像的核心组成Node.js 22 运行时构建阶段基于node:22.15.1运行阶段内置 Node v22.15.1并以TOOLJET_EDITIONee环境变量声明企业版PostgREST v12.2.0随镜像内置用于将 PostgreSQL 表暴露为 REST APIToolJet Database 的底层通道docker-compose.yaml 中也使用了postgrest/postgrest:v12.2.0Python 沙箱nsjail为工作流中的 Python 代码执行构建了隔离环境python3.11 预装 numpy、pandas、requests、httpx 等常用包配置文件位于 python-execution.cfg数据库客户端全家桶包含postgresql-client、redis、Oracle Instant Client含 11.2 与 21.10 两个版本、freetds-devSQL Server等支撑各类数据源连接Redis 与审计日志支持运行阶段内置 Redis 配置redis.conf与 rsyslog 审计目录。因此选择 LTS 版本不仅意味着「更稳的代码分支」也意味着一个经过生产级打磨的完整发行包。二、Pre-Release 版本面向尝鲜的预发布线Pre-Release 版本面向希望第一时间体验 ToolJet 最新特性与进展的用户。这类版本是实验性的可能包含尚未在 LTS 中落地的新功能但正因其实验性质也可能存在缺陷、缺乏 LTS 级别的稳定性。官方明确不建议在生产环境中使用 Pre-Release 版本。在 2.50.0-LTS 文档线中判定标准非常清晰所有2.60.x.x 及更高的版本均被视为 Pre-Release 版本。作为对照3.0.0-LTS 文档线中该边界更新为3.1.x.x可见预发布与 LTS 的分界线随大版本推进而整体上移。如果你的目标是验证新功能原型、为后续升级做评估Pre-Release 是合适的试验场但任何面向真实业务的生产实例都应停留在 LTS 线。三、Past 版本已停止维护的旧版本Past过往版本指不再被积极维护或支持的 ToolJet 版本。这些版本虽然仍可在镜像仓库中拉到但官方不推荐使用——尤其是生产环境因为它们不再接收功能更新、Bug 修复或安全补丁长期运行将面临已知漏洞无法修复的风险。在 2.50.0-LTS 文档线中判定标准为2.45.x.x 及更早的所有版本均被视为过往版本已不再维护。对于仍运行在这些版本上的实例应尽快规划升级先通过 upgrade-to-lts.md 评估升级路径再按部署方式执行迁移。四、LTS 版本的拉取与部署实操4.1 直接拉取 LTS 镜像按上一节表格选择目标版本后直接执行拉取即可# 始终跟随最新 LTS滚动标签推荐新装使用 docker pull tooljet/tooljet:EE-LTS-latest # 锁定具体版本如 3.0 LTS 系列 docker pull tooljet/tooljet:v3.0.24-ee-lts # 锁定 2.50 系列 LTS docker pull tooljet/tooljet:EE-LTS-2.50.9.48生产环境建议锁定具体版本号而非滚动标签以便在升级窗口内可控变更。4.2 基于 Docker Compose 部署 LTSToolJet 官方提供的 Docker Compose 部署方式有两种对应 deploy/docker 目录中的两个编排文件方案 A内建 PostgreSQL推荐——使用 docker-compose-db.yaml数据库随编排一起启动适合快速自托管。方案 B外部 PostgreSQL——使用 docker-compose.yaml适合对接 AWS RDS、Google Cloud SQL 等托管数据库服务。从 docker-compose.yaml 可见其典型服务拓扑client前端端口 8082、server后端端口 3000、postgrest端口 3001、postgres端口 5432与redis端口 6379并通过TOOLJET_EDITION环境变量切换 CE/EE 版本。部署前需要生成.env文件。仓库中的两个脚本揭示了密钥的生成规则这正是「选好版本之后」最关键的一步internal.sh内建数据库场景自动生成LOCKBOX_MASTER_KEYopenssl rand -hex 3232 字节十六进制用于加密数据源凭据的 lockbox 主密钥SECRET_KEY_BASEopenssl rand -hex 64会话签名等安全操作的密钥基底PGRST_JWT_SECRETopenssl rand -hex 32PostgREST 认证 JWT 密钥PG_PASS/TOOLJET_DB_PASS随机 16 位密码PGRST_DB_URI基于上述值拼接的postgres://postgres:passpostgresql/tooljet_db。external.sh外部数据库场景会交互式询问PG_USER、PG_HOST、PG_PASS、PG_DB并将同一组凭据同步写入TOOLJET_DB_*与PGRST_DB_URI。随后设置TOOLJET_HOST须以http://或https://开头可为服务器公网 IP 或自定义域名使用自定义域名时还需在 DNS 中添加指向服务器 IP 的 A 记录更多环境变量参考 env-vars.md。# 方案 A内建 PostgreSQL curl -LO https://tooljet-deployments.s3.us-west-1.amazonaws.com/docker/docker-compose-db.yaml mv docker-compose-db.yaml docker-compose.yaml mkdir postgres_data curl -LO https://tooljet-deployments.s3.us-west-1.amazonaws.com/docker/.env.internal.example curl -LO https://tooljet-deployments.s3.us-west-1.amazonaws.com/docker/internal.sh chmod x internal.sh mv .env.internal.example .env ./internal.sh docker-compose up -dLinux 服务器上若 docker 需要 sudo 权限可执行sudo docker-compose up -d也可参照 Docker 官方 post-install 文档配置免 root 运行。4.3 快速体验Try ToolJet LTS若只想在本地快速体验 LTS 版本仓库提供了 ee-try-tooljet-lts.Dockerfile。该镜像以tooljet/tooljet:ee-lts-latest为基础内置 PostgreSQL 16、Redis 与 PostgREST并通过 supervisor 统一管理postgrest、tooljet执行 init-db-boot.sh与redis三个进程默认环境为TOOLJET_HOSThttp://localhost——单条命令即可起一个完整的 LTS 环境是评估版本、跑通流程的轻量入口详细步骤见 try-tooljet.md。五、升级到 LTS前置条件与迁移路径5.1 升级前置条件根据 upgrade-to-lts.md 与 docker.md 升级章节升级前必须满足两点完整备份数据库升级过程存在数据变更务必先对数据库做全面备份以防数据丢失版本门槛版本早于v2.23.0-ee2.10.2的用户必须先升级到该版本才能继续升级到目标 LTS 版本。如果属于全新安装直接使用最新 LTS 即可无需执行本节流程。5.2 按部署方式选择升级指南升级过程因部署方式而异官方按部署形态提供了对应的升级指引均位于 2.50.0-LTS 文档线Docker 部署docker.md#升级到最新 LTSDigitalOceandigitalocean.mdAWS EC2ec2.mdAWS ECSecs.mdOpenShiftopenshift.mdHelmhelm.mdKubernetes原生/GKE/AKSkubernetes.md、kubernetes-gke.md、kubernetes-aks.mdAzure Container Appsazure-container.mdGoogle Cloud Rungoogle-cloud-run.md5.3 跨大版本迁移2.50 → 3.0 LTS由于 3.0 LTS 已正式上线且本文档线同时收录了 2.50 与 3.0 两个 LTS 系列跨大版本升级可参考仓库中的专项迁移文档upgrade-to-v3.md自托管实例 2.x → 3.0、cloud-v3-migration.mdToolJet Cloud → 3.0与 v2-migration.md。跨大版本升级前务必同时核对 system-requirements.md 确认硬件与依赖满足要求。六、选型决策速查综合全文给出一个可落地的决策流程生产环境优先选择当前最新 LTSEE-LTS-latest或锁定具体v3.0.x-ee-lts/EE-LTS-2.50.x标签并享受 18 个月以上的维护窗口功能评估 / 原型验证可短时使用 Pre-Release2.60.x.x 及以上体验新特性但不得直接承载生产流量存量旧实例运行于 2.45.x.x 及更早版本Past时应尽快备份数据并按部署方式完成到 LTS 的升级版本信息核对以 Docker Hub 的tooljet/tooljet镜像 Tag 列表为最终依据文档表格仅反映该文档线发布时的快照。掌握这三条发行线的边界与镜像命名规律你就能在任何时间点准确判断「该用哪个版本、怎么拉、怎么升」让 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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考