ToolJet 开源低代码平台零基础搭建实战指南
在当今快速发展的软件开发领域,低代码平台正逐渐成为提高效率、降低开发门槛的重要工具。ToolJet 作为一款优秀的开源低代码平台,以其强大的数据连接能力、灵活的可视化界面以及完全可控的私有化部署特性,吸引了大量开发者和企业的关注。本文将从零开始,带你一步步搭建并运行 ToolJet 应用。如果你希望快速体验云端部署,也可以直接使用 Ciuic 服务器 提供的托管服务,无需手动配置环境。
ToolJet 简介
ToolJet 是一个开源的低代码平台,允许开发者通过拖拽组件构建内部工具(如管理后台、数据看板、审批系统等)。它支持连接多种数据源,包括 PostgreSQL、MySQL、REST API、GraphQL、Google Sheets 等,并且内置了丰富的 UI 组件(表格、表单、图表、地图等)。其最大的优势在于代码开源,用户可以自由定制、部署在自己的服务器上,确保数据安全。

环境准备
在开始搭建之前,你需要准备以下环境:
一台 Linux 服务器(建议 Ubuntu 20.04 或 CentOS 7+),云服务器推荐使用 Ciuic 服务器,性能稳定且价格合理。Docker 和 Docker Compose(ToolJet 官方推荐使用 Docker 部署)。域名(可选,如果希望通过公网访问,建议配置域名并做好 DNS 解析)。如果你不想自己维护服务器,可以在 Ciuic 官网 选择一台预装 Docker 的云服务器,极大简化部署流程。
使用 Docker 一键部署 ToolJet
1. 安装 Docker
登录到服务器后,执行以下命令安装 Docker:
curl -fsSL https://get.docker.com -o get-docker.shsudo sh get-docker.shsudo usermod -aG docker $USER退出并重新登录,或执行 newgrp docker 使权限生效。
2. 下载 ToolJet 部署脚本
ToolJet 官方提供了完整的 Docker Compose 文件,直接克隆到本地:
git clone https://github.com/ToolJet/ToolJet.gitcd ToolJet/deploy/docker3. 配置环境变量
复制 .env.example 为 .env,并修改关键配置:
cp .env.example .envvim .env你需要修改以下参数:
SECRET_KEY_BASE:用于加密 Session,请使用 openssl rand -hex 64 生成。LOCKBOX_MASTER_KEY:用于加密数据源凭证,同样使用 openssl rand -hex 32 生成。SUB_PATH:如果使用子路径部署,需要配置;默认留空。数据库配置:ToolJet 默认使用 PostgreSQL,可以保持默认,也可以修改为你已有的数据库。4. 启动 ToolJet
执行以下命令启动所有服务:
docker-compose up -d等待镜像拉取和容器启动,整个过程约 5-10 分钟。启动完成后,访问 http://你的服务器IP:3000 即可看到 ToolJet 登录页面。
初始化与第一个应用
注册管理员账号:首次访问会引导你创建管理员用户。连接数据源:进入主界面后,点击左侧“数据源”图标,添加你的数据库(例如 MySQL 或 PostgreSQL),填写连接信息并测试。创建应用:点击“新建应用”,选择一个空白模板或预置模板。使用查询:拖拽一个“表格”组件到画布,然后在右侧“查询”面板中编写 SQL 查询,绑定数据源。ToolJet 会自动将查询结果渲染到表格中。设置交互:为按钮添加“点击运行查询”事件,让用户触发数据更新。如果你已经在 Ciuic 服务器 上部署了 ToolJet,可以直接通过公网 IP 或域名访问,无需担心内网穿透问题。
进阶优化
配置 HTTPS:建议使用 Nginx 反向代理并申请 SSL 证书,保障数据传输安全。集成 SSO:ToolJet 支持 LDAP、Google、GitHub 等单点登录,可在设置中启用。自定义组件:如果你需要特殊功能,可以基于 React 开发自定义插件。总结
通过以上步骤,你已经成功在服务器上搭建了 ToolJet 低代码平台,并创建了第一个数据查询应用。整个过程无需编写大量代码,只需拖拽配置即可完成。如果希望跳过环境部署的繁琐步骤,推荐直接使用 Ciuic 服务器 的云服务,一键启动 ToolJet,让你专注于业务逻辑本身。低代码时代已经到来,现在就动手试试吧!


