文档

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

OctaFuse 是可自托管的 AI 能力网关与运营控制面。文档按工作流组织：先跑起来，再配置供应商、模型、图片生成、智能体工具（Agent Tools）、路由和密钥；需要联调时使用调试台（Playground）、模拟器（Simulator）和日志；需要 API、迁移、架构细节时回到 gateway 仓库的权威技术参考。

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

推荐阅读顺序

快速开始 → 供应商（Providers）→ 模型（Models）→ 路由（Routes）→ 智能体工具 → 用户（Users）→ API 密钥（API Keys）→ 模拟器 → 部署。需要字段、SQL、架构或排障细节时，再打开 GitHub 技术参考。

界面速览

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

路由（Routes）：沿请求入口（Surface）→ 策略（Policy）→ 上游目标（Upstream targets）路径配置协议、路由组、策略、优先级和权重。

调试台（Playground）：上线前先对单个上游目标直连上游试跑，快速确认配置。

配置流水线

1供应商（Providers）上游端点、单密钥与状态2模型（Models）模型目录与定价3路由（Routes）请求入口、路由池、上游目标与策略4图片（Images）图片生成与按张 / Token 计价5工具（Tools）可扩展智能体工具6用户（Users）账户、预算、周期7API 密钥（API Keys）发放、吊销、调用凭证

常用入口

快速开始 本地 D1 → Cloudflare 上云

系统集成 代理服务、管理后台与密钥的边界

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

智能体工具 可扩展工具 API；当前含联网类

调试台 单条路由直连上游试跑

模拟器 用真实密钥验证完整代理链路

Cloudflare 部署 Worker + 管理后台 + D1（推荐）

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

排障与治理

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