开发者
自托管与运行模式
理解静态站、公共后端、后台任务和执行节点的职责，以及本地启动前的要求。
更新于
如果准备自己运行 DraPub，先了解下面几个进程分别做什么，再准备数据库和外部服务配置。本页适用于已经取得源码、能够维护运行环境的开发者。
| 部分 | 职责 |
|---|---|
| Site | 静态官网、博客与帮助文档 |
| Web | 浏览器控制台，通过 Backend 访问业务能力 |
| Backend serve | 公共 HTTP、tRPC 与 Agent 流式请求 |
| Backend work | 消费后台队列，执行异步业务任务 |
| 桌面或远程执行节点 | 领取并执行授权任务，不直接访问业务数据库 |
| 托管云端 Agent | 按任务调用授权的工具与模型服务 |
先安装仓库要求的 Bun 和依赖，按 apps/backend/.env.example 配置本地环境。Backend 业务数据使用 DRAPUB_DATABASE_URL，检索运行数据使用 GBRAIN_RUNTIME_DATABASE_URL。还需要按当前功能配置认证、存储、队列或模型服务。
数据库创建、迁移与权限必须按当前仓库说明完成。不要将例子中的本地默认密码带到生产，也不要靠改旧迁移文件修复已部署数据库。
配置完成后，可在仓库根目录分别启动 API 和 Worker。
bun run dev:api
bun run dev:worker它们是两个长驻进程，需要分别运行。只启动 API 不代表异步处理已经可用。
公共网关默认端口为 4320。4111 是内部兼容入口，不应作为额外的公开 Agent 服务暴露。静态站部署与 Backend 服务配置分开管理。
生产上线还需要 HTTPS、访问控制、备份、监控和外部服务配置。桌面本地工作区、远程节点和完整自托管 Backend 是不同部署范围，不能互相替代。
验证访问时从只读 CLI 检查开始，再逐项检查实际业务流程。