ToolJet 开源低代码平台零基础搭建实战指南

什么是ToolJet？

ToolJet 是一个开源的现代低代码平台，可以帮助开发者快速构建内部工具和业务应用。它提供了可视化构建器，支持连接到各种数据源（如PostgreSQL、MongoDB、Elasticsearch等），并且允许通过JavaScript自定义逻辑。ToolJet非常适合需要快速开发内部管理后台、仪表盘或简单业务应用的企业和个人开发者。

准备工作

在开始搭建ToolJet之前，您需要准备以下环境：

ToolJet 开源低代码平台零基础搭建实战指南

一台Linux服务器（推荐Ubuntu 20.04或更高版本）Docker和Docker Compose已安装Node.js (v14或更高版本)基本的命令行操作知识

如果您还没有合适的服务器，可以考虑使用Ciuic云服务器，它提供了稳定可靠的云计算服务，非常适合部署此类应用。

安装步骤

1. 安装Docker和Docker Compose

# 更新软件包索引sudo apt-get update# 安装必要的依赖sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common# 添加Docker官方GPG密钥curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -# 添加Docker仓库sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"# 安装Dockersudo apt-get updatesudo apt-get install docker-ce docker-ce-cli containerd.io# 验证Docker安装sudo docker run hello-world# 安装Docker Composesudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose

2. 部署ToolJet

ToolJet提供了基于Docker Compose的一键部署方案：

# 创建项目目录mkdir tooljet && cd tooljet# 下载docker-compose.yml文件wget https://raw.githubusercontent.com/ToolJet/ToolJet/main/deploy/docker-compose/docker-compose.yml# 启动服务docker-compose up -d

这个过程会拉取并启动以下容器：

ToolJet主应用PostgreSQL数据库Redis缓存

3. 配置环境变量

创建.env文件并配置必要的环境变量：

cp .env.example .envnano .env

主要配置项包括：

SECRET_KEY_BASE - 应用密钥LOCKBOX_MASTER_KEY - 加密密钥数据库连接信息SMTP邮件服务配置

4. 初始化数据库

docker-compose run server rake db:createdocker-compose run server rake db:migrate

5. 访问ToolJet

服务启动后，您可以通过以下地址访问ToolJet：

前端：http://您的服务器IP:3000后端：http://您的服务器IP:8080

基本使用指南

1. 创建第一个应用

登录ToolJet后：

点击"Create new application"选择空白模板或从预设模板开始为应用命名并保存

2. 添加数据源

ToolJet支持多种数据源：

点击左侧边栏的"Data Sources"选择要添加的数据源类型填写连接信息并测试连接

3. 构建界面

使用可视化构建器：

从右侧组件库拖拽组件到画布配置组件属性使用查询编辑器连接数据源通过JavaScript添加自定义逻辑

高级配置

1. 配置HTTPS访问

为了提高安全性，建议配置HTTPS访问。您可以使用Nginx作为反向代理并配置SSL证书：

server {    listen 443 ssl;    server_name your-domain.com;    ssl_certificate /path/to/cert.pem;    ssl_certificate_key /path/to/key.pem;    location / {        proxy_pass http://localhost:3000;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;        proxy_set_header X-Forwarded-Proto $scheme;    }}

2. 备份与恢复

定期备份您的ToolJet数据：

# 备份数据库docker-compose exec db pg_dump -U postgres tooljet_development > backup.sql# 恢复数据库cat backup.sql | docker-compose exec -T db psql -U postgres tooljet_development