ToolJet V2 升级迁移指南多页面、多环境与可选项功能配置全解析【免费下载链接】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/ToolJetToolJet Version 2V2是一次面向自托管部署的重要版本升级带来了多页面应用、多环境支持、Forms 表单组件等核心能力并引入了需要显式开启的 ToolJet Database 与 Marketplace 两个可选功能。本文基于 ToolJet 2.50.0-LTS 版本的官方迁移指南完整梳理 V2 的部署升级路径、数据迁移触发机制、可选功能的配置项以.env环境变量为核心以及版本弃用清单帮助你在升级前评估改动、升级时一次性配置到位、升级后快速验证新功能是否生效。V2 带来了什么核心新特性总览根据 v2-migration.md 官方迁移指南ToolJet V2 的主要新特性集中在以下五个方面特性说明是否需要额外配置Multi page多页面在单个应用内创建、管理、导航多个页面一个应用可以承载多样化的功能否默认可用Multi env多环境支持按环境管理数据源连接与配置便于区分开发、测试、生产否默认可用Forms widget表单组件提供动态表单构建能力配合 Tabs 组件可实现多页表单否默认可用ToolJet Database内置数据存储用类似电子表格的界面维护表数据开箱即用是需ENABLE_TOOLJET_DBtrueopt-inMarketplace插件市场可安装自定义数据源插件到工作区是需ENABLE_MARKETPLACE_FEATUREtrueopt-in其中ToolJet Database与Marketplace属于需要显式开启opt-in的能力这也是升级 V2 时唯一需要额外关注的配置变更点。其余三个特性在默认部署中直接可用无需任何额外配置。部署升级默认部署可直接升级无需额外配置对于已经按照官方 setup 文档 完成部署的用户V2 的升级路径非常简单无论你此前选择了哪种部署方式Docker Compose、Kubernetes、ECS、Helm 等默认配置下都可以直接部署 V2无需任何额外配置变更。唯一的例外是上文提到的两个可选功能ToolJet Database 与 Marketplace它们需要按照各自的功能文档额外配置。以最常见的 Docker Compose 部署为例升级流程与全新部署完全一致仅需更新镜像后重启# 1. 拉取最新镜像 docker compose pull # 2. 重建并后台启动容器 docker-compose up -d注意在 Linux 服务器上docker命令可能需要sudo权限此时请使用sudo docker-compose up -d。仓库中对应 V2 的默认部署模板可以参考 docker-compose-db.yaml内置 PostgreSQL 的推荐方案其中tooljet服务使用tooljet/tooljet-ce:latest镜像通过env_file: .env加载环境变量并依赖postgres与postgrest两个服务。升级时的数据迁移服务器启动阶段自动完成V2 升级涉及一批数据迁移data migrations这是部署过程中需要特别留意的一点由于 V2 的变更需要执行若干数据迁移首次部署/升级后服务器可能需要一些时间才能就绪并处理 HTTP 请求。该迁移会在服务器启动server boot阶段自动触发无需人工干预。从源码看数据迁移的加载逻辑定义在>openssl rand -hex 32ToolJet 服务端配置ToolJet 服务端需要追加以下环境变量变量说明ENABLE_TOOLJET_DBtrue或false功能总开关TOOLJET_DB数据库名默认值为tooljet_dbTOOLJET_DB_HOST数据库主机TOOLJET_DB_USER数据库用户名TOOLJET_DB_PASS数据库密码TOOLJET_DB_PORT数据库端口PGRST_JWT_SECRETJWT 密钥须与 PostgREST 侧一致PGRST_HOSTPostgREST 数据库主机两点使用提示自动建库启用该功能后TOOLJET_DB指定的数据库名会在服务器启动过程中自动创建适用于所有生产部署方式若需手动触发可在 ToolJet 服务端执行npm run db:create。连接串形式若希望使用连接字符串且连接不支持 SSL可使用TOOLJET_DB_URL格式为postgres://username:passwordhostname:port/database_name?sslmodedisable。完整的变量清单与说明同样维护在 env-vars.md 与 tooljet-database.md 中。在 Docker Compose 部署下PostgREST 容器会以postgrest/postgrest:v12.0.2镜像运行并通过PGRST_SERVER_PORT80、PGRST_DB_PRE_CONFIGpostgrest.pre_config等变量接入参见 docker-compose-db.yaml。功能价值启用后ToolJet Database 允许你在仅组织内可访问的安全数据库中维护数据表以类电子表格的界面编辑、搜索、过滤、排序数据像使用任何其他数据源一样快速编写查询构建应用无需额外搭建将数据库 Schema 导出为 JSON 文件通过主键Primary Keys唯一标识记录、通过外键Foreign Keys建立表间关联并维护引用完整性。可选功能二开启 Marketplace插件市场ToolJet Marketplace 允许用户为工作区安装自定义插件数据源实现与 ToolJet 的深度集成。它同样是 opt-in 功能需要显式开启。启用方式在.env文件中添加ENABLE_MARKETPLACE_FEATUREtrue本地运行 ToolJet 时需要在启动服务器之前先构建好 marketplace确保所有插件可用。此外还有两个辅助变量变量说明ENABLE_MARKETPLACE_FEATUREtrue或false功能总开关ENABLE_MARKETPLACE_DEV_MODEtrue或false开发者插件调试模式权限要求只有管理员Administrator角色可以访问 Marketplace 页面。使用流程进入市场登录后点击仪表盘左下角的设置图标在菜单中选择Marketplace。页面包含Installed已安装与Marketplace市场两个标签页。安装插件在 Marketplace 标签页浏览可用插件列表点击插件卡片上的Install按钮安装完成后状态会从Install变为Installed。使用插件进入仪表盘的Data sources数据源标签页滚动到Plugins分组即可看到所有已安装的 Marketplace 插件将其配置为数据源使用。仓库的 marketplace/plugins 目录内置了大量插件包如anthropic、openai、github、gmail、salesforce等每个插件包都遵循统一的结构package.json、lib源码、README.md、icon.svg等安装后即可作为新的数据源类型出现在工作区中。更详细的插件开发与安装说明可参考 build-plugin-for-marketplace.md。弃用项Docker Compose 自动 SSL 部署被移除V2 还包含一项明确的弃用声明Docker Compose 部署中带自动 SSLauto SSL的部署方式已被弃用deprecated。即旧版文档1.x.x中「Docker 部署 自动 SSL」的组合不再推荐使用。如果你此前依赖该方式提供 HTTPS升级 V2 前应提前规划替代方案例如在 Docker Compose 前放置独立的反向代理/负载均衡器来终结 TLS再以 HTTP 转发到 ToolJet 服务避免升级后证书自动续期与入口 TLS 中断。升级前的检查清单结合 V2 的变更点升级前建议逐项核对确认功能需求是否需要 ToolJet Database 或 Marketplace不需要则保持默认关闭减少配置面与资源占用。准备环境变量如需开启可选功能提前准备好ENABLE_TOOLJET_DB、TOOLJET_DB_*、PGRST_JWT_SECRET、ENABLE_MARKETPLACE_FEATURE等变量并写入.env参考 env-vars.md。生成密钥使用openssl rand -hex 32生成PGRST_JWT_SECRET若此前已有则保持一致即可。处理弃用项若当前使用 Docker Compose 自动 SSL 部署提前切换到外部反向代理方案。预留迁移窗口为首次启动的数据迁移预留足够时间迁移期间不要强制中断服务。升级后验证服务就绪后登录确认多页面应用创建正常、多环境切换可用并逐一验证已开启的可选功能是否生效。帮助与支持升级过程中如遇问题可加入 ToolJet 的Slack 社区寻求帮助或发送邮件至hellotooljet.com如果确认是 Bug请在GitHub Issues中提交问题反馈。此外V2 的完整变更细节可通过 ToolJet 官方发布的changelog查看仓库根目录的 update-version.js 等脚本可用于版本管理场景。本文涉及的关键参考文件汇总V2 迁移指南原文环境变量参考Docker Compose 部署指南ToolJet Database 概览Marketplace 概览多页面概念说明数据迁移配置内置 PostgreSQL 的 Docker Compose 模板【免费下载链接】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），仅供参考