私有化部署
两种形态:docker-compose(交付/评估)与 systemd 裸机(生产参考拓扑)| 全组件离线可跑:echo ASR / null TTS / echo LLM 兜底,无外部依赖即可演示
Docker Compose(最快路径)
git clone <交付包> openagent-os && cd openagent-os
cd deploy && docker compose up -d # 五服务 + 网关
curl -s http://localhost:8100/api/v1/plans | head
compose profile asr-tts 预留 FunASR/CosyVoice GPU 服务;
镜像化与卷布局见 deploy/docker-compose.yml 与各服务 Dockerfile。
生产拓扑(本站同款)
公网 80/443 ──► 边缘 TLS(Caddy 自动 ACME / 或 certbot)
▼
nginx 统一入口
├─ /v1/device/ws → gateway :8080(Go,设备 WS 长连接)
├─ /api/ → console-api :8100(管理面 + 商业化)
├─ /llm/ → llm-gateway :8300(模型出口)
├─ /rag/ → rag-kb :8400(知识库)
├─ /open/ → orchestrator :8200(开放对话 + 会话编排)
├─ /console/ → 控制台静态站(SPA)
└─ /docs/ / → 官网与本文档(纯静态)
服务间只走 127.0.0.1;/internal/ /admin/ 一律不对公网暴露。
关键环境变量(deploy/.env,chmod 600)
| OA_CONSOLE_SECRET | 控制台 JWT 签名密钥(32B 随机,setup_secrets.sh 生成) |
| OA_INTERNAL_TOKEN | 服务间内部令牌(console↔orchestrator↔llm-gateway 核验通道) |
| OA_DS_KEY / OA_QWEN_KEY / … | 静态模型商 Key(可选;渠道方式可免) |
| OA_CONSOLE_URL | orchestrator / llm-gateway 指向 console-api(启用设备→智能体解析与渠道路由) |
| OA_GATEWAY_URL / OA_RAG_URL / OA_LLM_BASE_URL | 服务互连地址 |
| OA_OPEN_RPM | 开放 API 每租户每分钟限流(默认 30) |
数据与升级
- 数据面:SQLite(console.db / rag.db),备份即拷贝;PG 版模型见
deploy/sql/001_saas_core.sql(RLS 行级隔离,供大规模替换)。 - 升级:单服务替换二进制/代码后
systemctl restart openagent-*;引导账号与 schema 迁移均幂等(重启安全)。 - 模型接入:控制台建渠道 + 设默认(推荐,免重启);或 .env 注入静态 Key 重启 llm-gateway。