ToolJet 快速体验指南：用 Docker 一键启动与自定义端口部署

ToolJet 快速体验指南用 Docker 一键启动与自定义端口部署【免费下载链接】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 官方提供的tooljet/try:ee-latest一键体验镜像讲解如何在本地通过 Docker 在数分钟内启动一套完整的 ToolJet 平台并深入说明其内置组件PostgreSQL、Temporal、Redis、数据持久化原理、常用环境变量以及端口自定义方法。读完本文你将掌握 ToolJet 本地试玩的标准命令、容器生命周期管理技巧并能基于环境变量将体验实例灵活调整为适合自己机器的端口与配置为后续参考 正式部署方案 打下基础。一、体验镜像是什么一条命令背后的完整平台ToolJet 是一款开源的低代码应用构建平台用于快速搭建内部工具、仪表盘、业务应用、工作流与 AI Agent。官方为了让开发者最快上手发布了内置依赖的 try 系列体验镜像例如tooljet/try:ee-latest。与生产部署镜像tooljet/tooljet不同体验镜像把运行平台所需的全部组件都打包进了一个容器ToolJet ServerNestJS 实现的后端服务源码位于 server/src负责应用定义、数据源凭据加密与用户认证数据的管理内嵌 PostgreSQL 13数据库数据存放在 Docker 卷tooljet_data挂载到容器内/var/lib/postgresql/13/mainTemporal工作流执行引擎其 SQLite 数据存放在 Docker 卷temporal_sqlite挂载到/etc/temporal前端静态资源与 Nginx 反向代理由容器内 Nginx 同时负责托管前端/并把/api/、WebSocket/ws、/yjs等请求代理到后端 3000 端口参见 frontend/config/nginx.conf.template 中的location proxy { proxy_pass http://${SERVER_HOST}:3000; }配置Redis体验镜像默认附带并自启本地 Redis绑定 127.0.0.1:6379用于多人实时编辑与后台任务参见容器入口脚本 docker/ce-entrypoint.sh 中对redis-server的启动逻辑。也就是说只要机器上装了 Docker无需单独安装 PostgreSQL、Redis 或 Node.js一条命令即可获得可登录使用的完整平台。二、本地快速启动官方默认命令在终端中执行以下命令即可在本地拉起 ToolJet体验镜像对应 Enterprise Edition 最新版本docker run \ --name tooljet \ --restart unless-stopped \ -p 80:80 \ --platform linux/amd64 \ -v tooljet_data:/var/lib/postgresql/13/main \ -v temporal_sqlite:/etc/temporal \ tooljet/try:ee-latest各参数含义如下参数作用--name tooljet为容器命名后续可用docker stop tooljet/docker start tooljet管理--restart unless-stopped容器异常退出或 Docker 守护进程重启后自动拉起手动 stop 除外-p 80:80将容器内 80 端口映射到宿主机 80 端口--platform linux/amd64显式指定 x86_64 平台体验镜像基于 Linux x86 构建-v tooljet_data:/var/lib/postgresql/13/main内嵌 PostgreSQL 13 数据目录挂载到命名卷保证数据持久化-v temporal_sqlite:/etc/temporalTemporal 工作流引擎的 SQLite 数据持久化卷启动后的关键事实ToolJet Server 监听在宿主机的80 端口浏览器直接访问http://localhost即可打开登录/注册页容器内部已经配置好 PostgreSQL所有应用数据都会写入 Docker 卷tooljet_data即使容器被删除数据也不会丢失你可以通过--env或--env-file参数注入额外的环境变量用来测试各种配置项详见下文第三节与 环境变量完整参考停止容器使用docker stop tooljet之后再次启动使用docker start tooljet数据依然完好。三、端口自定义把体验实例跑在任意端口官方默认将服务绑定在 80 端口。如果你本机 80 端口已被占用或希望多个实例并存可以通过PORT环境变量配合端口映射实现动态端口例如运行在 8080docker run \ --name tooljet \ --restart unless-stopped \ -p 8080:8080 \ -e PORT8080 \ --platform linux/amd64 \ -v tooljet_data:/var/lib/postgresql/13/main \ -v temporal_sqlite:/etc/temporal \ tooljet/try:ee-latest要点解读-p 8080:8080完成宿主机到容器内端口的映射-e PORT8080将PORT环境变量设置为 8080ToolJet Server 据此监听 8080 端口。容器内的 Nginx 会通过代理把请求转发给该端口从而保证前端、/api/与 WebSocket 链路一致工作若改为其他端口如 3000、9000只需同步修改-p与-e PORT两个位置即可。从源码结构看PORT是 ToolJet Server 的标准监听端口配置在正式部署的 docker-compose 中同样以PORT: 80显式声明见 deploy/docker/docker-compose-db.yaml 中 tooljet 服务的 environment 段说明该变量是贯穿体验镜像与生产编排的一致约定。四、体验实例的内部启动流程为了理解一条命令为何能直接可用可以观察容器的实际启动逻辑。体验镜像以 docker/ce-entrypoint.sh 作为入口其工作流程大致如下检测 Redis 是否运行未运行则用/app/redis.conf启动本地 Redis仅绑定 127.0.0.1protected-mode yes配置生成逻辑见 docker/ce-production.Dockerfile 中的printf bind 127.0.0.1\nport 6379\n...若存在./.env则加载其中的环境变量根据server/dist是否存在选择生产或开发模式的数据库初始化命令npm run db:setup:prod或npm run db:setup解析PG_HOST/PG_PORT或从DATABASE_URL中提取通过wait-for-it.sh等待 PostgreSQL 就绪后执行数据库初始化建表、迁移、种子数据数据库就绪后exec $执行镜像定义的最终命令启动 ToolJet Server 与 Nginx。这意味着首次启动会自动完成数据库建库、迁移与应用初始化用户无需手动创建数据库或执行迁移命令这也是体验镜像开箱即用的根本原因。镜像构建时还打包了 Oracle Instant Client、freetds 等驱动依赖见 docker/ce-production.Dockerfile 的依赖安装段为后续连接 Oracle、SQL Server 等外部数据源做好准备。五、体验阶段最值得关注的环境变量通过-e KEYVALUE或--env-file .env注入环境变量可以在不重建容器的情况下测试平台的各种行为。下表整理自 环境变量参考文档是本地体验阶段最常用、影响最直接的几组变量是否必需说明TOOLJET_HOST必需ToolJet 客户端的公网地址例如https://app.tooljet.com本地试玩可设为http://localhostLOCKBOX_MASTER_KEY必需32 字节十六进制字符串用于加密数据源凭据可用openssl rand -hex 32生成SECRET_KEY_BASE必需64 字节十六进制字符串用于加密会话 Cookie可用openssl rand -hex 64生成PORT可选Server 监听端口默认 80动态端口部署时需与-p同步DISABLE_SIGNUPS可选设为true禁止开放注册仅允许邀请加入体验页仍可见但无法提交DISABLE_TOOLJET_TELEMETRY可选设为true关闭匿名使用统计上报CHECK_FOR_UPDATES可选设为0关闭每 24 小时的产品更新检查USER_SESSION_EXPIRY可选用户会话过期时间分钟默认 10 天例如设为120即 2 小时LANGUAGE可选默认语言代码如en、fr、es、zh等提示tooljet/try体验镜像内部已预置好可用的数据库与密钥配置日常试玩可直接使用默认命令上述变量主要用于按需测试行为开关如禁用注册、关闭遥测或为后续正式部署做准备。正式部署时官方脚本 deploy/docker/internal.sh 会自动用openssl rand生成LOCKBOX_MASTER_KEY、SECRET_KEY_BASE、PGRST_JWT_SECRET与数据库密码与文档中的生成建议一致。六、环境前提与进阶阅读运行前提体验镜像面向 Linux x86_6464 位平台具体参考 系统要求文档操作系统任意 Linux 发行版x86 架构arm64 不受支持Windows 用户建议使用 WSL2 或虚拟机资源建议至少 2GB 内存、1 vCPU、8GiB 磁盘本地试玩按需调整即可软件安装 Docker 引擎并确保当前用户有权限执行docker命令Linux 下必要时使用sudo数据库体验镜像内置 PostgreSQL 13无需单独安装。体验之后从试玩走向正式部署体验镜像适合快速验证功能若要将 ToolJet 用于长期运行或生产环境建议参考以下仓库内文档Docker Compose 生产部署提供内置 PostgreSQL与外部 PostgreSQL如 AWS RDS、Cloud SQL两种编排方式配合 docker-compose-db.yaml 模板 使用环境变量完整参考涵盖 Server、Client、PostgREST、SSO、SMTP、ToolJet Database 等全部配置项系统要求正式部署前的硬件与操作系统核对清单其余部署方式Kubernetes、Helm、云平台等可在 setup 目录 下按需查阅。结语tooljet/try:ee-latest体验镜像把 PostgreSQL、Temporal、Redis、Nginx 与 ToolJet Server 整合进单一容器配合命名卷实现数据持久化让开发者无需任何前置依赖即可在本地完整感受 ToolJet 的建站、工作流与 AI Agent 能力。掌握默认命令、PORT动态端口与常用环境变量这三件事就足以支撑起一次顺畅的本地体验当你想把它从试玩升级为部署时仓库中的 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），仅供参考