3.1 KiB
3.1 KiB
快速开始
环境要求
| 工具 | 最低版本 | 说明 |
|---|---|---|
| Go | 1.21+ | 后端编译运行（需 CGO 支持 SQLite） |
| Node.js | 18+ | 前端构建 |
| npm | 9+ | 包管理 |
| gcc/clang | - | CGO 编译 SQLite 需要 |
检查环境
go version # >= 1.21
node -v # >= 18
gcc --version # macOS 自带 clang
安装
1. 克隆仓库
git clone https://gitee.com/attacker/aiops.git
cd aiops
2. 安装依赖
make install
# 或手动安装
cd backend && go mod download && cd ..
cd frontend cd app &&cd app && npm install && cd ..
3. 配置（可选）
默认使用 SQLite，无需任何额外配置即可启动。
如需使用 MySQL 等其他数据库，编辑 backend/config.yaml：
database:
driver: mysql # 改为 mysql / postgres
host: localhost
port: 3306
user: root
password: your_password
dbname: aiops
启动
方式一：一键启动（推荐）
chmod +x run.sh
./run.sh start
输出示例：
[INFO] ========== AIOps 启动脚本 ==========
[INFO] 正在启动后端服务...
[INFO] 编译 Go 程序...
[SUCCESS] 后端服务已启动 (PID: 12345, 端口: 8080)
[INFO] 正在启动前端服务...
[SUCCESS] 前端服务已启动 (PID: 12346, 端口: 5173)
[SUCCESS] ========== 所有服务已启动 ==========
[INFO] 前端地址: http://localhost:5173
[INFO] 后端地址: http://localhost:8080
[INFO] 健康检查: http://localhost:8080/health
方式二：分别启动
# 仅后端
./run.sh backend
# 仅前端
./run.sh frontend
方式三：使用 Makefile
make dev # 启动
make status # 查看状态
make stop # 停止
访问
| 地址 | 说明 |
|---|---|
| http://localhost:5173 | 前端界面 |
| http://localhost:8080/health | 后端健康检查 |
| http://localhost:8080/version | 版本信息 |
| http://localhost:8080/api/v1/auth/login | 登录接口 |
常用命令
./run.sh status # 查看服务状态
./run.sh stop # 停止所有服务
./run.sh restart # 重启所有服务
./run.sh help # 查看帮助
make logs # 查看实时日志
make build # 构建生产包
make clean # 清理构建产物
日志位置
| 服务 | 日志文件 |
|---|---|
| 后端 | backend/logs/server.log |
| 前端 | frontend/logs/dev.log |
| 数据库 | backend/data/aiops.db（SQLite 文件） |
数据库
默认使用 SQLite，数据库文件位于 backend/data/aiops.db，首次启动时自动创建表结构（AutoMigrate）。
重置数据库
./run.sh stop
rm -f backend/data/aiops.db
./run.sh start
常见问题
Q: CGO 编译失败？
SQLite 需要 CGO 支持。确保环境变量 CGO_ENABLED=1：
export CGO_ENABLED=1
Q: Go 模块下载慢？
设置国内代理：
export GOPROXY=https://goproxy.cn,direct
Q: 端口被占用？
./run.sh stop # 先停止
./run.sh start # 再启动
# 或强制释放端口
lsof -ti:8080 | xargs kill -9
lsof -ti:5173 | xargs kill -9