私有化部署

两种形态: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_URLorchestrator / llm-gateway 指向 console-api(启用设备→智能体解析与渠道路由)
OA_GATEWAY_URL / OA_RAG_URL / OA_LLM_BASE_URL服务互连地址
OA_OPEN_RPM开放 API 每租户每分钟限流(默认 30)

数据与升级