文档

gateway.docs选择你的路径users → configure → observe → deploy

OctaFuse 是可自托管的 AI 能力网关与运营控制面。文档按工作流组织：先跑起来，再配置上游、模型、图片生成、Agent Tools、路由和 Key；需要联调时看 Playground / Simulator 和日志；需要 API、迁移、架构细节时回到 gateway 仓库的权威技术参考。

01我只想先用起来本地 D1 → Cloudflare 一键上云、登录 Admin、打一条测试请求。02我要接入自己的系统区分 Proxy / Admin、用户 Key / Master Key、门户后台自动开通流程。03我要上线到生产Cloudflare Workers（默认）、Docker 自托管、数据落点与迁移顺序。

推荐阅读顺序

快速开始 → 供应商 → 模型 → 路由 → 用户 → API Key → Simulator → 部署。需要字段、SQL、架构或排障细节时，再打开 GitHub 技术参考。

界面速览

Dashboard：安装后先看运行概况、请求量、Token、费用与最近错误。

Routes：把客户端传入的 model 映射到供应商、上游模型名和路由组。

Playground：上线前先对单条路由直连上游试跑，快速确认配置。

配置流水线

1Providers上游端点与多 Key2Models模型目录与定价3Routes路由、分组、故障切换4Images图片生成与按张/Token 价5Tools可扩展 Agent 工具6Users账户、预算、周期7API Keys发放、吊销、调用凭证

常用入口

快速开始 本地 D1 → Cloudflare 上云

系统集成 Proxy / Admin / Key 边界

图片生成 / 编辑 Images 与 token / 按张计费

Agent Tools 可扩展工具 API；当前含联网类

Playground 单条路由直连上游试跑

Simulator 用真实 Key 验证完整 Proxy 链路

Cloudflare 部署 Worker + Admin + D1（推荐）

Docker 部署 自托管、Postgres / MySQL、镜像

排障与治理

我想…	去哪
看调用是否成功	请求日志
看用量与成本趋势	Analytics
看预算、Key 生命周期和用户侧审计	审计日志
配置管理密钥、业务时区、计费币种、告警	系统配置
查 API、迁移、架构、计费细节	GitHub 技术参考