ToolJet 快速试用指南一条 Docker 命令在本地跑起完整版 ToolJet内置 PostgreSQL 与 AI 能力【免费下载链接】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 3.0.0-LTS 官方试用文档讲解如何用一条docker run命令在本机一键启动 ToolJet容器内已预装 PostgreSQL、Redis、PostgREST数据落盘到 Docker 卷还内置了 ToolJet AI 功能开关。读完本文你将掌握默认端口启动、动态端口切换、环境变量覆盖、数据持久化与容器生命周期管理等完整的本地试用实操方案。为什么选择 Try ToolJet 镜像tooljet/try:ee-lts-latest是 ToolJet 官方为快速体验场景准备的专用镜像它与正式部署镜像setup/docker.md 中讲解的 Docker Compose 方式最大的区别在于所有依赖组件都被打进了同一个容器你不需要提前准备任何数据库或缓存服务拉取镜像后即可直接使用。从仓库中的镜像定义文件 docker/LTS/ee/ee-try-tooljet-lts.Dockerfile 可以看到它的构建思路基础镜像直接继承正式版tooljet/tooljet:ee-lts-latest内置 PostgreSQL 16含postgresql-client与 Redis复制 PostgREST v12.2.0 可执行文件到/bin用于将 ToolJet 数据库暴露为 REST API安装supervisor作为进程管理器同时托管 ToolJet 服务、PostgREST 与 Redis 三个进程默认开启ENABLE_TOOLJET_DBtrueToolJet Database 功能与ENABLE_AI_FEATUREStrueAI 功能。也就是说这个试用容器本质是一个开箱即用的全栈环境非常适合第一次接触 ToolJet 的开发者、做 PoC 验证或者跑本地开发。快速开始一条命令启动 ToolJet在满足 x8664 位架构的 Linux 机器上Windows 请使用 WSL2 或虚拟机详见 system-requirements.md执行以下命令即可docker run \ --name tooljet \ --restart unless-stopped \ -p 80:80 \ --platform linux/amd64 \ -v tooljet_data:/var/lib/postgresql/13/main \ tooljet/try:ee-lts-latest启动完成后浏览器访问http://localhost或服务器 IP即可打开 ToolJet 界面。命令参数逐项拆解参数作用--name tooljet为容器命名后续docker stop/docker start/docker logs等命令都直接使用该名称--restart unless-stopped容器异常退出时自动重启只有手动 stop 后才不会拉起-p 80:80将容器内 80 端口映射到宿主机 80 端口--platform linux/amd64显式指定 linux/amd64 平台避免在 Apple Silicon 等 arm64 机器上因平台不匹配导致拉取或运行异常-v tooljet_data:/var/lib/postgresql/13/main将 PostgreSQL 数据目录挂载为 Docker 命名卷tooljet_data实现数据持久化容器启动流程入口脚本做了什么镜像的入口脚本 docker/LTS/ee/ee-try-entrypoint-lts.sh 完整展示了容器启动时的初始化链路修改pg_hba.conf将本地postgres用户与all用户的认证方式改为trust随后启动 PostgreSQL 服务通过pg_isready轮询等待数据库就绪若tooljet数据库角色不存在则创建超级用户tooljet密码postgres导出默认端口export PORT${PORT:-80}并强制开启ENABLE_AI_FEATUREStrue以supervisord启动 ToolJet、PostgREST、Redis 三个进程日志统一输出到/dev/stdout因此你可以直接通过docker logs tooljet观察全部服务的运行状态。试用容器的内部构成与默认配置镜像在 docker/LTS/ee/ee-try-tooljet-lts.Dockerfile 中通过ENV指令固化了一整套默认值理解它们有助于你判断需要覆盖哪些变量类别默认值说明服务端口PORT80TOOLJET_HOSThttp://localhostTOOLJET_SERVER_URLhttp://localhostToolJet 服务监听端口与对外地址主数据库PG_DBtooljet_production、PG_USERtooljet、PG_PASSpostgres、PG_HOSTlocalhost、PG_PORT5432ToolJet 主应用数据库应用定义、加密后的数据源凭据、用户认证数据ToolJet DatabaseTOOLJET_DBtooljet_db、ENABLE_TOOLJET_DBtrue可选的内置数据库功能由 PostgREST 以 REST API 方式对外提供PostgRESTPGRST_HOSThttp://localhost:3000、PGRST_DB_URIpostgres://tooljet:postgreslocalhost/tooljet_db、PGRST_JWT_SECRETr9iMKoe5CRMgvJBBtp4HrqN7QiPpUToj用于把 ToolJet 数据库暴露为 REST 接口RedisREDIS_HOSTlocalhost、REDIS_PORT6379内置 Redis供多人在线协作编辑与后台任务使用功能开关ENABLE_MARKETPLACE_FEATUREtrue、ENABLE_AI_FEATUREStrue市场插件与 AI 功能默认开启平台标识DEPLOYMENT_PLATFORMdocker:local标记部署来源用于遥测与平台识别说明试用镜像为方便一键体验内置了固定的LOCKBOX_MASTER_KEY与SECRET_KEY_BASE占位值。生产环境请务必使用openssl rand -hex 32与openssl rand -hex 64重新生成这两个变量分别用于加密数据源凭据与会话 Cookie详见 env-vars.md。通过环境变量定制试用环境容器启动时支持--env单个变量与--env-file变量文件两种方式传入配置用于覆盖镜像内置的默认值。例如调整主机地址、数据库名称或功能开关docker run \ --name tooljet \ --restart unless-stopped \ -p 80:80 \ --platform linux/amd64 \ -e TOOLJET_HOSThttp://192.168.1.100 \ -e USER_SESSION_EXPIRY120 \ -v tooljet_data:/var/lib/postgresql/13/main \ tooljet/try:ee-lts-latest完整的环境变量清单可参考 env-vars.md试用阶段最常用的几个TOOLJET_HOSTToolJet 的公开访问地址必须带http://或https://前缀LOCKBOX_MASTER_KEY32 字节十六进制字符串用于加密数据源凭据SECRET_KEY_BASE64 字节十六进制字符串用于加密会话 CookieDISABLE_SIGNUPStrue关闭开放注册仅允许被邀请用户注册USER_SESSION_EXPIRY用户会话过期时间分钟默认 10 天DISABLE_TOOLJET_TELEMETRYtrue关闭默认开启的遥测上报。动态端口在指定端口运行 ToolJet默认情况下容器把 80 端口映射到宿主机 80 端口。若宿主机 80 端口已被占用或你希望多个实例并存可通过PORT环境变量切换容器内监听端口同时调整-p映射docker run \ --name tooljet \ --restart unless-stopped \ -p 8080:8080 \ -e PORT8080 \ --platform linux/amd64 \ -v tooljet_data:/var/lib/postgresql/13/main \ tooljet/try:ee-lts-latest执行后 ToolJet 服务将监听 8080 端口浏览器访问http://localhost:8080即可。原理上入口脚本中的export PORT${PORT:-80}会读取-e PORT8080传入的值supervisord管理的 ToolJet 进程随之在 8080 端口提供服务宿主机侧的-p 8080:8080则将流量转发进容器。若同时更改宿主机端口例如映射为-p 3000:8080也可让容器内 8080 对应宿主机的任意端口。启用 ToolJet AI 功能域名白名单ToolJet AI 功能AI 智能体、AI 生成应用等依赖 ToolJet 官方的 AI 网关服务。文档明确要求要在 ToolJet 部署中启用 ToolJet AI 功能请将https://api-gateway.tooljet.ai加入白名单。这适用于两种场景本地试用如果部署环境存在出站防火墙、代理或网络安全组需要放行对https://api-gateway.tooljet.ai的 HTTPS 请求容器内部通过ENABLE_AI_FEATUREStrue默认开启 AI 功能见 docker/LTS/ee/ee-try-entrypoint-lts.sh。服务器部署若在云服务器如 AWS EC2、GCP上运行需在安全组 / 防火墙规则中允许该域名的出站流量否则 AI 相关能力将不可用。数据持久化与容器生命周期管理数据存在哪里试用容器把 PostgreSQL 的数据目录挂载到了命名卷tooljet_data即宿主机的/var/lib/postgresql/13/main数据目录。这意味着停止并重新启动容器docker start tooljet应用、数据源配置与用户数据全部保留即使删除容器docker rm tooljet只要卷tooljet_data还在重新用同样的-v参数创建容器即可恢复数据需要备份时可用docker run --rm -v tooljet_data:/data -v $(pwd):/backup alpine tar czf /backup/tooljet_data.tar.gz -C /data .之类的命令将卷内容打包导出。常用运维命令docker stop tooljet # 停止容器数据保留在卷中 docker start tooljet # 再次启动容器 docker logs -f tooljet # 实时查看 ToolJet / PostgREST / Redis 的运行日志 docker ps # 查看容器状态由于设置了--restart unless-stopped容器在 Docker 重启或进程崩溃后会自动拉起只有执行docker stop才会让它保持停止状态。从试用走向正式部署试用镜像适合本地体验与功能验证若要在生产服务器上长期运行建议切换到正式部署方式Docker Compose 部署官方提供两份生产级编排文件——内置 PostgreSQL 的 docker-compose-db.yaml 与对接外部 PostgreSQL 的 docker-compose.yaml完整步骤见 setup/docker.md系统要求参考x86 架构 Linux、至少 2GB 内存、1 vCPU、8GiB 存储system-requirements.md环境变量规范生产环境必须生成强随机的LOCKBOX_MASTER_KEY与SECRET_KEY_BASE并显式配置TOOLJET_HOST、PG_*、TOOLJET_DB_*、PGRST_*等变量env-vars.md版本升级LTS 版本每 3–5 个月发布一次升级前务必对数据库做完整备份详见 upgrade-to-lts.md。常见问题速查现象排查方向访问http://localhost无响应确认 80 端口未被占用检查docker ps容器状态与docker logs tooljet中 PostgreSQL 是否完成初始化Apple Silicon 上启动失败确保命令中包含--platform linux/amd64arm64 架构不受官方支持重启后数据丢失确认每次启动都使用了相同的-v tooljet_data:/var/lib/postgresql/13/main参数与容器名AI 功能不可用检查部署环境的出站防火墙是否放行https://api-gateway.tooljet.ai端口冲突改用动态端口方案-e PORT端口与-p 端口:端口保持一致至此你已经可以通过一条命令完整体验 ToolJet 的应用构建、数据源连接、ToolJet Database 与 AI 能力当本地验证通过后再按正式部署文档平滑迁移到生产环境即可。【免费下载链接】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），仅供参考 ToolJet 快速试用指南：一条 Docker 命令在本地跑起完整版 ToolJet（内置 PostgreSQL 与 AI 能力）
ToolJet 快速试用指南一条 Docker 命令在本地跑起完整版 ToolJet内置 PostgreSQL 与 AI 能力【免费下载链接】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 3.0.0-LTS 官方试用文档讲解如何用一条docker run命令在本机一键启动 ToolJet容器内已预装 PostgreSQL、Redis、PostgREST数据落盘到 Docker 卷还内置了 ToolJet AI 功能开关。读完本文你将掌握默认端口启动、动态端口切换、环境变量覆盖、数据持久化与容器生命周期管理等完整的本地试用实操方案。为什么选择 Try ToolJet 镜像tooljet/try:ee-lts-latest是 ToolJet 官方为快速体验场景准备的专用镜像它与正式部署镜像setup/docker.md 中讲解的 Docker Compose 方式最大的区别在于所有依赖组件都被打进了同一个容器你不需要提前准备任何数据库或缓存服务拉取镜像后即可直接使用。从仓库中的镜像定义文件 docker/LTS/ee/ee-try-tooljet-lts.Dockerfile 可以看到它的构建思路基础镜像直接继承正式版tooljet/tooljet:ee-lts-latest内置 PostgreSQL 16含postgresql-client与 Redis复制 PostgREST v12.2.0 可执行文件到/bin用于将 ToolJet 数据库暴露为 REST API安装supervisor作为进程管理器同时托管 ToolJet 服务、PostgREST 与 Redis 三个进程默认开启ENABLE_TOOLJET_DBtrueToolJet Database 功能与ENABLE_AI_FEATUREStrueAI 功能。也就是说这个试用容器本质是一个开箱即用的全栈环境非常适合第一次接触 ToolJet 的开发者、做 PoC 验证或者跑本地开发。快速开始一条命令启动 ToolJet在满足 x8664 位架构的 Linux 机器上Windows 请使用 WSL2 或虚拟机详见 system-requirements.md执行以下命令即可docker run \ --name tooljet \ --restart unless-stopped \ -p 80:80 \ --platform linux/amd64 \ -v tooljet_data:/var/lib/postgresql/13/main \ tooljet/try:ee-lts-latest启动完成后浏览器访问http://localhost或服务器 IP即可打开 ToolJet 界面。命令参数逐项拆解参数作用--name tooljet为容器命名后续docker stop/docker start/docker logs等命令都直接使用该名称--restart unless-stopped容器异常退出时自动重启只有手动 stop 后才不会拉起-p 80:80将容器内 80 端口映射到宿主机 80 端口--platform linux/amd64显式指定 linux/amd64 平台避免在 Apple Silicon 等 arm64 机器上因平台不匹配导致拉取或运行异常-v tooljet_data:/var/lib/postgresql/13/main将 PostgreSQL 数据目录挂载为 Docker 命名卷tooljet_data实现数据持久化容器启动流程入口脚本做了什么镜像的入口脚本 docker/LTS/ee/ee-try-entrypoint-lts.sh 完整展示了容器启动时的初始化链路修改pg_hba.conf将本地postgres用户与all用户的认证方式改为trust随后启动 PostgreSQL 服务通过pg_isready轮询等待数据库就绪若tooljet数据库角色不存在则创建超级用户tooljet密码postgres导出默认端口export PORT${PORT:-80}并强制开启ENABLE_AI_FEATUREStrue以supervisord启动 ToolJet、PostgREST、Redis 三个进程日志统一输出到/dev/stdout因此你可以直接通过docker logs tooljet观察全部服务的运行状态。试用容器的内部构成与默认配置镜像在 docker/LTS/ee/ee-try-tooljet-lts.Dockerfile 中通过ENV指令固化了一整套默认值理解它们有助于你判断需要覆盖哪些变量类别默认值说明服务端口PORT80TOOLJET_HOSThttp://localhostTOOLJET_SERVER_URLhttp://localhostToolJet 服务监听端口与对外地址主数据库PG_DBtooljet_production、PG_USERtooljet、PG_PASSpostgres、PG_HOSTlocalhost、PG_PORT5432ToolJet 主应用数据库应用定义、加密后的数据源凭据、用户认证数据ToolJet DatabaseTOOLJET_DBtooljet_db、ENABLE_TOOLJET_DBtrue可选的内置数据库功能由 PostgREST 以 REST API 方式对外提供PostgRESTPGRST_HOSThttp://localhost:3000、PGRST_DB_URIpostgres://tooljet:postgreslocalhost/tooljet_db、PGRST_JWT_SECRETr9iMKoe5CRMgvJBBtp4HrqN7QiPpUToj用于把 ToolJet 数据库暴露为 REST 接口RedisREDIS_HOSTlocalhost、REDIS_PORT6379内置 Redis供多人在线协作编辑与后台任务使用功能开关ENABLE_MARKETPLACE_FEATUREtrue、ENABLE_AI_FEATUREStrue市场插件与 AI 功能默认开启平台标识DEPLOYMENT_PLATFORMdocker:local标记部署来源用于遥测与平台识别说明试用镜像为方便一键体验内置了固定的LOCKBOX_MASTER_KEY与SECRET_KEY_BASE占位值。生产环境请务必使用openssl rand -hex 32与openssl rand -hex 64重新生成这两个变量分别用于加密数据源凭据与会话 Cookie详见 env-vars.md。通过环境变量定制试用环境容器启动时支持--env单个变量与--env-file变量文件两种方式传入配置用于覆盖镜像内置的默认值。例如调整主机地址、数据库名称或功能开关docker run \ --name tooljet \ --restart unless-stopped \ -p 80:80 \ --platform linux/amd64 \ -e TOOLJET_HOSThttp://192.168.1.100 \ -e USER_SESSION_EXPIRY120 \ -v tooljet_data:/var/lib/postgresql/13/main \ tooljet/try:ee-lts-latest完整的环境变量清单可参考 env-vars.md试用阶段最常用的几个TOOLJET_HOSTToolJet 的公开访问地址必须带http://或https://前缀LOCKBOX_MASTER_KEY32 字节十六进制字符串用于加密数据源凭据SECRET_KEY_BASE64 字节十六进制字符串用于加密会话 CookieDISABLE_SIGNUPStrue关闭开放注册仅允许被邀请用户注册USER_SESSION_EXPIRY用户会话过期时间分钟默认 10 天DISABLE_TOOLJET_TELEMETRYtrue关闭默认开启的遥测上报。动态端口在指定端口运行 ToolJet默认情况下容器把 80 端口映射到宿主机 80 端口。若宿主机 80 端口已被占用或你希望多个实例并存可通过PORT环境变量切换容器内监听端口同时调整-p映射docker run \ --name tooljet \ --restart unless-stopped \ -p 8080:8080 \ -e PORT8080 \ --platform linux/amd64 \ -v tooljet_data:/var/lib/postgresql/13/main \ tooljet/try:ee-lts-latest执行后 ToolJet 服务将监听 8080 端口浏览器访问http://localhost:8080即可。原理上入口脚本中的export PORT${PORT:-80}会读取-e PORT8080传入的值supervisord管理的 ToolJet 进程随之在 8080 端口提供服务宿主机侧的-p 8080:8080则将流量转发进容器。若同时更改宿主机端口例如映射为-p 3000:8080也可让容器内 8080 对应宿主机的任意端口。启用 ToolJet AI 功能域名白名单ToolJet AI 功能AI 智能体、AI 生成应用等依赖 ToolJet 官方的 AI 网关服务。文档明确要求要在 ToolJet 部署中启用 ToolJet AI 功能请将https://api-gateway.tooljet.ai加入白名单。这适用于两种场景本地试用如果部署环境存在出站防火墙、代理或网络安全组需要放行对https://api-gateway.tooljet.ai的 HTTPS 请求容器内部通过ENABLE_AI_FEATUREStrue默认开启 AI 功能见 docker/LTS/ee/ee-try-entrypoint-lts.sh。服务器部署若在云服务器如 AWS EC2、GCP上运行需在安全组 / 防火墙规则中允许该域名的出站流量否则 AI 相关能力将不可用。数据持久化与容器生命周期管理数据存在哪里试用容器把 PostgreSQL 的数据目录挂载到了命名卷tooljet_data即宿主机的/var/lib/postgresql/13/main数据目录。这意味着停止并重新启动容器docker start tooljet应用、数据源配置与用户数据全部保留即使删除容器docker rm tooljet只要卷tooljet_data还在重新用同样的-v参数创建容器即可恢复数据需要备份时可用docker run --rm -v tooljet_data:/data -v $(pwd):/backup alpine tar czf /backup/tooljet_data.tar.gz -C /data .之类的命令将卷内容打包导出。常用运维命令docker stop tooljet # 停止容器数据保留在卷中 docker start tooljet # 再次启动容器 docker logs -f tooljet # 实时查看 ToolJet / PostgREST / Redis 的运行日志 docker ps # 查看容器状态由于设置了--restart unless-stopped容器在 Docker 重启或进程崩溃后会自动拉起只有执行docker stop才会让它保持停止状态。从试用走向正式部署试用镜像适合本地体验与功能验证若要在生产服务器上长期运行建议切换到正式部署方式Docker Compose 部署官方提供两份生产级编排文件——内置 PostgreSQL 的 docker-compose-db.yaml 与对接外部 PostgreSQL 的 docker-compose.yaml完整步骤见 setup/docker.md系统要求参考x86 架构 Linux、至少 2GB 内存、1 vCPU、8GiB 存储system-requirements.md环境变量规范生产环境必须生成强随机的LOCKBOX_MASTER_KEY与SECRET_KEY_BASE并显式配置TOOLJET_HOST、PG_*、TOOLJET_DB_*、PGRST_*等变量env-vars.md版本升级LTS 版本每 3–5 个月发布一次升级前务必对数据库做完整备份详见 upgrade-to-lts.md。常见问题速查现象排查方向访问http://localhost无响应确认 80 端口未被占用检查docker ps容器状态与docker logs tooljet中 PostgreSQL 是否完成初始化Apple Silicon 上启动失败确保命令中包含--platform linux/amd64arm64 架构不受官方支持重启后数据丢失确认每次启动都使用了相同的-v tooljet_data:/var/lib/postgresql/13/main参数与容器名AI 功能不可用检查部署环境的出站防火墙是否放行https://api-gateway.tooljet.ai端口冲突改用动态端口方案-e PORT端口与-p 端口:端口保持一致至此你已经可以通过一条命令完整体验 ToolJet 的应用构建、数据源连接、ToolJet Database 与 AI 能力当本地验证通过后再按正式部署文档平滑迁移到生产环境即可。【免费下载链接】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），仅供参考