ToolJet 开源低代码平台零基础安装教程
什么是ToolJet?
ToolJet 是一个功能强大的开源低代码平台,可以帮助开发者和企业快速构建内部工具和应用程序。它提供了直观的拖拽式界面,支持连接到多种数据源(如PostgreSQL、MongoDB、Elasticsearch等),并且可以部署在任何基础设施上。
安装前的准备
在开始安装ToolJet之前,您需要确保系统满足以下基本要求:

如果您还没有合适的服务器,可以考虑使用CIUIC云服务器,它提供稳定可靠的云计算服务,非常适合部署ToolJet等应用程序。
安装步骤
1. 安装Docker和Docker Compose
首先,我们需要安装Docker和Docker Compose。以下是在Ubuntu系统上的安装命令:
# 更新软件包索引sudo apt-get update# 安装必要的依赖sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common# 添加Docker官方GPG密钥curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg# 添加Docker仓库echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null# 安装Docker引擎sudo apt-get updatesudo apt-get install -y docker-ce docker-ce-cli containerd.io# 安装Docker Composesudo curl -L "https://github.com/docker/compose/releases/download/v2.12.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose# 验证安装docker --versiondocker-compose --version2. 克隆ToolJet仓库
接下来,我们克隆ToolJet的官方GitHub仓库:
git clone https://github.com/ToolJet/ToolJet.gitcd ToolJet3. 配置环境变量
ToolJet需要一些环境变量才能正常运行。复制示例环境文件并进行编辑:
cp .env.example .envnano .env在.env文件中,您至少需要配置以下关键参数:
# 数据库配置PG_DB=tooljetPG_USER=postgresPG_PASSWORD=your_secure_passwordPG_HOST=postgresPG_PORT=5432# 其他重要配置SECRET_KEY_BASE=your_secret_key_baseLOCKBOX_MASTER_KEY=your_lockbox_master_keySERVER_HOST=your_server_ip_or_domainENABLE_SIGNUP=true # 设置为false以禁用公开注册4. 使用Docker Compose启动ToolJet
配置完成后,使用以下命令启动ToolJet:
docker-compose up -d这将启动所有必要的容器,包括PostgreSQL数据库、前端和后端服务。
5. 访问ToolJet
启动完成后,您可以通过以下URL访问ToolJet:
前端界面:http://your_server_ip:3000API服务:http://your_server_ip:8080如果您使用的是CIUIC云服务器,请确保在安全组中开放了3000和8080端口。
生产环境部署建议
对于生产环境,我们建议进行以下额外配置:
使用Nginx作为反向代理:配置SSL证书和HTTP/2支持设置定期备份:特别是数据库备份监控和日志:设置适当的监控和日志收集资源限制:为Docker容器设置适当的资源限制常见问题解决
1. 端口冲突
如果3000或8080端口已被占用,您可以在.env文件中修改以下配置:
SERVER_PORT=新的后端端口FRONTEND_PORT=新的前端端口2. 数据库连接问题
确保PostgreSQL容器正常运行,并且.env文件中的数据库配置正确。
3. 内存不足
如果服务器内存不足,可以尝试增加交换空间:
sudo fallocate -l 4G /swapfilesudo chmod 600 /swapfilesudo mkswap /swapfilesudo swapon /swapfileToolJet是一个功能强大且灵活的低代码平台,通过本教程,您应该已经成功在服务器上部署了ToolJet。无论是使用本地服务器还是CIUIC云服务器,ToolJet都能为您提供快速构建内部工具的能力。
随着您对ToolJet的熟悉,可以进一步探索其高级功能,如自定义插件开发、API集成等。ToolJet的活跃社区和丰富文档也是学习和解决问题的好资源。


