LeoAI

环境要求

无需单独安装数据库：内置 SQLite，首次启动自动初始化。 无需额外部署前端：Web 界面已打包至 JAR 文件中。

---

快速开始

Docker 启动

如果你不想折腾 Java 环境，直接用 Docker 一条命令启动即可。镜像构建时会自动从 Release 页面下载 JAR，不需要在本机装 JDK/Maven，也不会编译源码。

第一步：安装 Docker

安装完成后打开终端验证（任意目录均可）：

docker --version
docker compose version

只要能看到版本号即可。

提示：以下命令不需要 sudo 时尽量不用。Linux 下若提示 permission denied，把当前用户加入 docker 组（sudo usermod -aG docker $USER 后重新登录），或者命令前加 sudo。

第二步：获取项目代码

任选一种方式：

```bash

第二步：启动

java -jar --add-opens java.base/java.lang=ALL-UNNAMED LeoAi-0.0.6-SNAPSHOT.jar

--add-opens java.base/java.lang=ALL-UNNAMED 参数不可省略，用于开放 Java 模块系统内部访问权限。

方式 A：使用 git（推荐，便于后续更新）

git clone https://github.com/cha0upup/LeoAI.git cd LeoAI

查看运行状态

docker compose ps

查看实时日志（Ctrl+C 退出，容器继续运行）

docker compose logs -f

重新启动

docker compose start

数据库（SQLite，路径相对于运行目录）

spring.datasource.url=jdbc:sqlite:data.db

使用指南

配置 OpenAI 或兼容接口

OPENAI_API_KEY=sk-xxxxx OPENAI_BASE_URL=https://api.openai.com/v1

配置说明

配置 AI 模型

LeoAI 的 AI 功能需要接入 LLM 接口，支持两种配置方式：

方式一：Web 界面配置（推荐）

1. 登录后进入「管理后台 → AI 配置」
2. 点击「添加通道」
3. 填写通道名称、API Key、Base URL、模型名称
4. 点击「测试连接」验证后保存

方式二：环境变量

export OPENAI_API_KEY=your-api-key
export OPENAI_BASE_URL=https://api.openai.com/v1

java -jar --add-opens java.base/java.lang=ALL-UNNAMED LeoAi-0.0.6-SNAPSHOT.jar

主要配置项参考

web/src/main/resources/application.properties：

```properties

AI 配置（也可通过 Web 界面管理）

leo.ai.openai.api-key=${OPENAI_API_KEY:} leo.ai.openai.base-url=${OPENAI_BASE_URL:https://api.openai.com/v1} leo.ai.openai.model=gpt-4o leo.ai.openai.thinking-enabled=false ```

---

OPENAI_BASE_URL=https://api.deepseek.com

插件与脚本执行

• 统一执行控制台：「脚本与插件」模块同时承载脚本编辑与字节码执行
• 脚本编辑器：支持 JavaScript / Groovy / Python，临时执行无需保存；可一键「保存为插件」
• Java Class 执行：拖拽 .class 文件或直接粘贴 base64 字节码（自动清洗 URL-safe / 空白 / padding，自动校验 cafebabe magic），临时执行不持久化；可保存为 Java 插件
• 统一插件库：Java 字节码与 js/groovy/python 脚本插件并存，按类型徽章区分；脚本插件可一键「载入编辑器」再编辑后执行
• Java 插件热加载：动态加载和执行自定义 Java 插件
• AI Skills 内置插件：脚本执行、命令执行、WebLogic 密码获取、堆转储分析等开箱即用
• 导入/导出：单条 .plugin 或批量 .zip，导入时支持跳过/覆盖冲突策略

常见问题

Q：启动时报 InaccessibleObjectException

必须添加 --add-opens 参数，不可省略：

java -jar --add-opens java.base/java.lang=ALL-UNNAMED LeoAi-0.0.6-SNAPSHOT.jar

---

Q：AI 功能无响应或报错

1. 进入「管理后台 → AI 配置」检查通道配置
2. 点击「测试连接」验证 API Key 和 Base URL
3. 确认 API 配额和请求限制
4. 查看服务端日志获取详细错误信息

---

Q：节点连接失败

按以下顺序排查：

1. 确认目标 URL 可访问（curl 测试）
2. 确认通信协议与 Shell 实现一致
3. 确认节点密钥与 Shell 端配置一致
4. 若使用流量伪装，确认模板两端编解码逻辑匹配
5. 查看浏览器 Network 面板和服务端日志

---

Q：如何重置管理员密码

停止应用 → 删除（或备份）data.db → 重新启动 → 使用初始账号密码 admin / 54ikun 登录。

---

Q：支持 HTTPS 吗

建议通过前置 Nginx / Apache 反向代理层配置 SSL，将 HTTPS 请求转发至 LeoAI。

---

Q：data.db 文件在哪里

默认在 JAR 的运行目录下，可通过启动参数指定自定义路径：

--spring.datasource.url=jdbc:sqlite:/custom/path/data.db

---