快速开始

本文目标是完成最小闭环：启动 GeekAI → 迁移数据库 → 接入中转站 → 添加聊天模型 → 完成首次对话。

1. 前置要求

• Linux 服务器，建议至少 2 核 CPU、4 GB 内存。
• 已安装 Docker 24+ 与 Docker Compose v2。
• 已开放 Web 访问端口，生产环境准备域名和 HTTPS。
• 已获得 GeekAI Plus 部署包或源码授权。

2. 启动服务

进入部署目录，按交付包中的环境变量说明设置 MySQL、Redis、JWT 与站点参数，然后执行：

docker compose up -d
docker compose ps

首次启动需要等待 MySQL、Redis、API 和 Web 完成初始化。容器显示 Up 后，再通过日志确认 API 已开始监听：

docker compose logs --tail=100 api

3. 打开系统

登录凭据以你的部署配置或交付说明为准。首次登录后立即修改默认管理员密码，不要继续使用示例密码。

4. 执行数据库维护

进入 系统设置 → 数据库维护（/admin/config/migration），点击 开始版本迁移，等待五个阶段完成。

详细说明见安装后必做：数据库维护。

5. 添加中转站 API-KEY

1. 登录 https://api2.geekai.pro，创建可调用目标聊天模型的令牌。
2. 回到 GeekAI 后台 API-KEY（/admin/apikey），点击 新增。
3. 类型选择 对话。
4. API URL 填 https://api2.geekai.pro，API KEY 填刚创建的令牌。
5. 提交并保持启用。

6. 添加聊天模型

1. 进入 模型管理（/admin/chat/model），点击 新增。
2. 模型名称填写用户可见名称。
3. 模型值填写中转站模型列表中的精确 ID。
4. 设置算力，绑定上一步的 API-KEY，保持启用并提交。

7. 完成首次对话

先准备一个前台用户：

• 已在 系统设置 → 基础配置 → 用户与安全 开放注册时，从前台 /register 注册。
• 不开放公开注册时，由管理员进入 用户管理（/admin/user）创建测试用户。

然后：

1. 打开前台 /login 登录测试用户。
2. 进入 /chat，新建对话。
3. 选择刚添加的模型并发送一个短问题。
4. 确认收到回复，再到后台 用户算力日志 和中转站调用日志核对记录。

8. 常见问题

• Unknown column / Table doesn't exist：重新执行数据库维护中的版本迁移。
• 前台没有模型：检查模型与绑定 API-KEY 是否同时启用。
• 401：令牌错误、过期或上游余额不足。
• 404：优先使用 Base URL https://api2.geekai.pro，检查模型 ID。
• 容器正常但页面打不开：检查安全组、端口映射和反向代理。

完成首次对话后，按后台配置总览逐项启用生图、视频、支付等功能。