开发者指南
自托管与运行模式
理解 Backend serve/work、数据库边界和本地 Runtime 的部署职责。
Backend
同一份 Backend 代码有两种模式:serve 提供公共 HTTP/tRPC/Agent 网关,work 消费 GBrain/Minions 队列且不开放 HTTP。生产环境应分别扩缩容,但保持相同版本。
数据库
DRAPUB_DATABASE_URL:DraPub 业务域与最终统一后的认证、账单数据。GBRAIN_RUNTIME_DATABASE_URL:页面、分块、向量、事实与任务队列。- 迁移期旧
DATABASE_URL只用于旧 Web Auth/Billing 兼容,新代码不要扩大边界。
Runtime
Go Runtime 是独立执行平面,主动连接 Backend。它不接触业务数据库或 GBrain,也不复制 Backend 状态机。
安全建议
分离数据库权限、对象存储和模型密钥;公网 AgentRun 使用共享调用密钥鉴权;保留审核门和最小权限,不要因自托管而关闭安全状态。