edgequake

环境要求

• 已安装并运行 Docker（含 Docker Compose）
• 无需安装 Rust 或 Node.js，也不需要本地编译
• 准备 OpenAI API Key，或本地使用 Ollama 提供模型
• 可选：自备 PostgreSQL 实例（仅 API 模式需要）
• 可访问外网以拉取脚本与镜像

安装与启动步骤

1. 1一键快速启动

   执行官方 quickstart 脚本，交互式向导会引导选择模型提供方（OpenAI / Ollama）、选择模型，并拉起整套服务。

   curl -fsSL https://raw.githubusercontent.com/raphaelmansuy/edgequake/edgequake-main/quickstart.sh | sh

   复制

2. 2打开 Web 界面

   容器启动后浏览器访问 http://localhost:3000 即可进入，无需登录（快速启动以开放 API 模式运行）。

3. 3下载 Compose 文件

   如果不想用向导，可直接使用官方提供的 quickstart compose 文件，先下载到当前目录。

   curl -fsSL https://raw.githubusercontent.com/raphaelmansuy/edgequake/edgequake-main/docker-compose.quickstart.yml -o docker-compose.quickstart.yml

   复制

4. 4用 Compose 启动

   在下载好 compose 文件的目录执行，后台启动全部服务，效果与一键脚本一致。

   docker compose -f docker-compose.quickstart.yml up -d

   复制

5. 5无交互环境启动

   CI 或无终端场景下，用环境变量传入提供方与密钥，避免向导交互。需先有 quickstart compose 文件。

   EDGEQUAKE_LLM_PROVIDER=openai OPENAI_API_KEY=sk-xxxxxxxx docker compose -f docker-compose.quickstart.yml up -d

   复制

6. 6仅启动 API 服务

   只跑后端 API 容器，映射 8080 端口，数据库需自备并传入 DATABASE_URL，适合已有 PostgreSQL 的场景。

   docker run -d --name edgequake -p 8080:8080 -e DATABASE_URL="postgres://user:pass@your-db:5432/edgequake" -e EDGEQUAKE_LLM_PROVIDER=openai -e OPENAI_API_KEY="sk-xxxxxxxx" ghcr.io/raphaelmansuy/edgequake:latest

   复制

7. 7全栈预构建镜像

   进入仓库 docker 目录，复制环境变量模板后启动预构建全栈（API 8080、前端 3000、PostgreSQL 5432）。

   cd edgequake/docker
   cp .env.example .env
   docker compose -f docker-compose.prebuilt.yml up -d

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:3000 能正常进入 Web UI（无需登录）即为启动成功；仅 API 模式则端口为 8080。

常见问题

注意事项

• 快速启动通过 EDGEQUAKE_DEV_MODE=true 以开放 API 运行、无登录，适合本地试用，不要直接暴露到公网。
• 仅 API 模式需要你自备可用的 PostgreSQL，并正确填写 DATABASE_URL。
• 预构建全栈镜像涉及端口 3000（前端）、8080（API）、5432（PostgreSQL），启动前确认未被占用。
• 镜像版本示例为 0.21.0 与 :latest，生产环境建议固定具体版本标签而非 latest。