compute-engine/README.云超服.md

compute-engine（算力引擎 new-api）— 云超服微服务

定位：云超服后端服务群中的算力引擎微服务。提供 OpenAI 兼容 /v1 模型中继 + 额度/令牌/token 流水。 仅作服务被消费（relay /v1 + 程序化管理 API）；其自带的 web 管理页面 / 用户页面不使用，算力相关管理全部在云超服 admin管理平台（自研）。 部署形态：随服务群部署、不做本地推理，全部渠道为云厂商代理（OpenAI / DeepSeek / 通义千问 / Claude / Gemini 等），无需 GPU 主机。

📍 原位于 reference/new-api/，已迁移为本微服务。上游：QuantumNous/new-api（AGPLv3，One API fork）。

---

一、启动命令

方式 1 · Docker Compose（推荐，含 Redis + 数据库）

cd code/compute-engine

# 1) 配置（必改：SESSION_SECRET 随机串；生产改 postgres/redis 密码）
cp .env.example .env

# 2) 编辑 docker-compose.yml：
#    - ports 改为 "127.0.0.1:3000:3000"（仅本机，不对外暴露）
#    - 取消注释 SESSION_SECRET 并填随机值
#    - 生产修改 postgres/redis 默认密码

# 3) 启动
docker compose up -d

# 4) 验证
curl http://127.0.0.1:3000/api/status

方式 2 · SQLite 单容器（开发 / 最小部署）

cd code/compute-engine
mkdir -p data
docker run --name compute-engine -d --restart always \
  -p 127.0.0.1:3000:3000 \
  -e TZ=Asia/Shanghai \
  -e SESSION_SECRET="$(openssl rand -hex 32)" \
  -v "$(pwd)/data:/data" \
  calciumion/new-api:latest

方式 3 · 源码编译（Go 1.22+）

cd code/compute-engine
go build -o bin/new-api main.go
SQLITE_PATH=./data/new-api.db SESSION_SECRET="$(openssl rand -hex 32)" ./bin/new-api --port 3000

---

二、server-core 对接

• 算力服务（server-core 的 compute_client，规划中）经 loopback 调本引擎：
  • 模型中继：http://127.0.0.1:3000/v1/*（OpenAI 兼容）
  • 管理 API：http://127.0.0.1:3000/api/*（建号 / 发 token / 额度调整 / 日志，程序化，管理令牌）
• 引擎不直接暴露给公网 / 前端；前端算力页面经 server-core → 算力服务 → 引擎。

三、首次配置（一次性）

引擎首次启动后，需建立初始管理员并添加云厂商渠道（由算力服务程序化完成，或临时用管理 API）：

# 初始化管理员（示例）
curl -X POST http://127.0.0.1:3000/api/setup -H 'Content-Type: application/json' \
  -d '{"username":"admin","password":"<强密码>"}'

# 添加渠道（示例：DeepSeek；渠道类型、Key 由算力服务统一管理）
# POST /api/channel  见 docs/

说明：按「仅服务」原则，云超服不暴露 new-api 自带面板；渠道/额度/用户全部由自研算力服务 + admin管理平台接管。

四、环境变量要点

变量	说明
SESSION_SECRET	鉴权签名密钥，必填（多机需一致）
SQL_DSN / SQLITE_PATH	主库连接（默认 SQLite）
REDIS_CONN_STRING	缓存（推荐开启）
PORT	监听端口（默认 3000）

完整配置见 .env.example。