Appsmith项目服务器端开发环境搭建指南

Appsmith项目服务器端开发环境搭建指南

appsmith appsmithorg/appsmith: Appsmith 是一个开源的无代码开发平台，允许用户通过拖拽式界面构建企业级Web应用程序，无需编写任何后端代码，简化了软件开发流程。 项目地址: https://gitcode.com/gh_mirrors/ap/appsmith

前言

Appsmith是一个开源的低代码开发平台，允许开发者快速构建内部工具和管理面板。本文将详细介绍如何搭建Appsmith服务器端的开发环境，包括Docker方式和本地开发方式两种方案。

方案一：使用Docker快速搭建

Docker方式是最简单快捷的启动Appsmith服务器的方法，适合想要快速体验或测试的开发人员。

准备工作

1. 确保已安装Docker和Docker Compose
2. 准备至少2GB的可用磁盘空间

操作步骤

1. 获取Appsmith项目代码
2. 进入docker部署目录
3. 执行启动命令

cd deploy/docker
docker-compose up -d

此命令会启动包含以下服务的容器：

• Appsmith服务器
• MongoDB数据库
• Redis缓存服务

注意事项

• 默认情况下，服务会占用8080端口
• 数据会持久化存储在容器中
• 可以通过修改docker-compose.yml文件自定义配置

方案二：本地开发环境搭建

本地开发方式适合需要对Appsmith进行二次开发或深度定制的开发者。

系统要求

基础软件要求

• OpenJDK 17
• Maven 3.6+
• MongoDB 5.0+
• Redis最新版
• IntelliJ IDEA（推荐）

数据库服务配置

MongoDB配置

1. 使用Docker启动MongoDB实例：

docker run -d -p 127.0.0.1:27017:27017 --name appsmith-mongodb --hostname=localhost -e MONGO_INITDB_DATABASE=appsmith -v /本地数据存储路径:/data/db mongo --replSet rs0

2. 初始化副本集：

mongosh
rs.initiate({"_id": "rs0", "members" : [{"_id":0 , "host": "localhost:27017" }]})

Redis配置

docker run -d -p 127.0.0.1:6379:6379 --name appsmith-redis redis

项目构建与运行

1. 克隆项目代码
2. 进入服务器目录
3. 初始化构建环境

mvn clean compile

4. 配置环境变量

cp envs/dev.env.example .env

5. 修改.env文件中的数据库连接配置
6. 构建项目

./build.sh -Dmaven.test.skip

7. 启动开发服务器

./scripts/start-dev-server.sh

常见问题解决

1. 磁盘空间不足：确保Docker数据目录有至少2GB可用空间
2. 权限问题：在Linux环境下可能需要使用sudo执行构建命令
3. 副本集配置错误：检查MongoDB连接字符串中的副本集名称是否正确

IntelliJ IDEA开发配置

必要插件安装

1. 安装EnvFile插件（用于加载环境变量）

运行配置

1. 设置VM选项：

-Dpf4j.mode=development -Dpf4j.pluginsDir=appsmith-plugins

2. 正确配置工作目录
3. 通过EnvFile标签加载.env文件

测试配置

1. 确保Redis服务正在运行
2. 执行测试命令：

cd app/server
mvn clean package

平台特定说明

Windows系统

推荐使用WSL2进行开发，配置步骤与Linux类似，但需要注意：

1. 安装Docker Desktop并启用WSL后端
2. 在WSL环境中安装Java和Maven
3. MongoDB数据目录应指向Windows文件系统路径

Apple Silicon芯片

需要使用ARM64架构的Docker镜像：

• MongoDB：arm64v8/mongo
• Redis：arm64v8/redis

结语

本文详细介绍了Appsmith服务器端的两种搭建方式。Docker方式适合快速部署和体验，而本地开发方式更适合进行二次开发和定制。无论选择哪种方式，都建议仔细阅读相关配置说明，确保各服务正常运行。如果在搭建过程中遇到问题，可以参考常见问题解决部分或寻求社区帮助。

appsmith appsmithorg/appsmith: Appsmith 是一个开源的无代码开发平台，允许用户通过拖拽式界面构建企业级Web应用程序，无需编写任何后端代码，简化了软件开发流程。 项目地址: https://gitcode.com/gh_mirrors/ap/appsmith