0 Fork 0

Files

T

Logan.Li fd60361d93 chore: 统一本地服务器与远程仓库源码

- 合并 main 与 master 历史并以服务器结构为基线
- 保留迁移、数据保留、AWS 账单与部署安全能力
- 建立 SDD 规格和 CI 验证闭环

2026-08-05 20:03:25 +08:00

3.1 KiB

Raw Permalink Blame History

快速开始

环境要求

工具	最低版本	说明
Go	1.24+	后端编译（SQLite 需 CGO_ENABLED=1）
Node.js	18+	前端构建
npm	9+	包管理
gcc/clang	-	CGO 编译 SQLite
Docker	20+	可选，Compose/K8s 部署

检查环境

go version
node -v
./run.sh help

安装

1. 克隆仓库

git clone https://gitee.com/attacker/aiops.git
cd aiops

2. 安装依赖

make install
# 或
cd backend && go mod download && cd ..
cd frontend && npm install && cd ..

本地开发（推荐）

chmod +x run.sh
./run.sh dev

输出示例：

[OK] 后端已启动 (PID: ..., 端口: 8080)
[OK] 前端已启动 (PID: ..., 端口: 5173)

地址	说明
http://localhost:5173	前端界面（Vite 热重载）
http://localhost:8080	后端 API
http://localhost:8080/version	版本信息
http://localhost:8080/health	健康检查

默认账号

用户名：admin
密码：123456

常用命令

./run.sh dev        # 启动开发环境
./run.sh stop       # 停止
./run.sh restart    # 重启
./run.sh status     # 查看状态
./run.sh logs       # 实时日志
./run.sh help       # 完整帮助

独立二进制（本机试用）

./run.sh build tag v1.0.0    # 编译到 ./aiops
./aiops version
./aiops --mode local         # SQLite + redka，零外部依赖

数据文件与二进制同级：./sqlite3.db、./redka.db。

Docker Compose（单机演示）

./run.sh docker up
# 访问 http://localhost:8080

发版（构建 + 推送镜像）

docker login
./run.sh release v1.5.0

镜像：lghost/aiops:v1.5.0

日志位置

场景	日志
本地开发后端	`backend/logs/server.log`
本地开发前端	`frontend/logs/dev.log`
独立二进制	`logs/aiops.log`
Docker	`./run.sh docker logs`

数据库

开发模式

默认 SQLite。首次初始化请显式执行 ./aiops migrate up；服务启动不会自动修改数据库结构。详见数据库版本化迁移。 // Logan.Li

local 二进制模式

./aiops --mode local
# sqlite3.db / redka.db 在项目根目录

重置 local 数据

./run.sh binary stop
rm -f sqlite3.db redka.db
./run.sh binary upgrade

常见问题

CGO 编译失败

export CGO_ENABLED=1
export GOPROXY=https://goproxy.cn,direct

Go 模块下载慢

export GOPROXY=https://goproxy.cn,direct
export GOTOOLCHAIN=local

端口被占用

./run.sh stop
# 或
lsof -ti:8080 | xargs kill -9
lsof -ti:5173 | xargs kill -9

Mac 编译的二进制无法在 Linux 运行

./run.sh build 在 Mac 上产出 darwin 二进制。Linux 部署请使用：

./run.sh release v1.x（Docker 镜像）
或在 Linux 服务器上执行 ./run.sh build

下一步

部署指南 — 生产环境、版本管理、K8s
开发规范 — 代码规范
API 接口 — 后端 API

3.1 KiB Raw Permalink Blame History Unescape Escape