手动安装

手动安装让你完全控制每个组件。这种方式适用于无法使用 Docker 的环境，或需要精细配置的场景。

前置条件

组件	要求
Java	JDK 17 或更高版本
Node.js	22 LTS
MySQL	8.0 或更高版本
Redis	7.0 或更高版本
Go	1.24（用于构建 Agent）

安装 MySQL

Ubuntu/Debian
CentOS/RHEL

sudo apt update
sudo apt install mysql-server-8.0
sudo systemctl enable mysql
sudo systemctl start mysql
sudo mysql_secure_installation

sudo dnf install mysql-server
sudo systemctl enable mysqld
sudo systemctl start mysqld
sudo mysql_secure_installation

创建数据库和用户：

CREATE DATABASE easyshell CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'easyshell'@'localhost' IDENTIFIED BY '你的密码';
GRANT ALL PRIVILEGES ON easyshell.* TO 'easyshell'@'localhost';
FLUSH PRIVILEGES;

安装 Redis

Ubuntu/Debian
CentOS/RHEL

sudo apt install redis-server
sudo systemctl enable redis-server
sudo systemctl start redis-server

sudo dnf install redis
sudo systemctl enable redis
sudo systemctl start redis

构建并运行 Server

cd easyshell-server
./gradlew bootJar

通过编辑 application.yml 或传递环境变量来配置 Server：

export SPRING_DATASOURCE_URL=jdbc:mysql://localhost:3306/easyshell
export SPRING_DATASOURCE_USERNAME=easyshell
export SPRING_DATASOURCE_PASSWORD=你的密码
export SPRING_REDIS_HOST=localhost
export SPRING_REDIS_PORT=6379

java -jar build/libs/easyshell-server-0.1.0-SNAPSHOT.jar --server.port=18080

构建并运行 Web 前端

cd easyshell-web
npm install
npm run build
npm run preview

在生产环境中，使用 Nginx 提供构建后的静态文件。参见生产环境部署指南。

验证安装

打开 http://localhost:18880（Docker）或配置的 URL
使用 easyshell / easyshell@changeme 登录
检查系统状态页面确认服务连接正常