部署

使用 Node、Docker 或 Cloudflare Workers 构建并部署 BlendDuck。

文档负责人:
BlendDuck Documentation
最近复核:

Node

pnpm build
pnpm start

生产服务输出到 .output/server/index.mjs。运行多个应用实例时，应使用 PostgreSQL 和共享对象存储。

Docker

docker compose up --build

容器入口会在服务启动前执行当前数据库迁移。采用多副本部署前，请先确认迁移只会由一个受控流程执行。

Cloudflare Workers

pnpm cf:build
pnpm db:d1:migrate
pnpm cf:deploy

Cloudflare 环境使用 D1 和 R2 Binding。请显式审核并执行 D1 迁移；生产部署命令不会自动生成或应用数据库结构变更。

生产环境边界

  • APP_URL 必须是唯一的公开 HTTPS 地址。
  • Secret 必须保存在托管平台的密钥服务中。
  • 反向代理必须保留 Authorization 和 MCP 协议 Header。
  • 持久任务必须使用配置好的 Worker 后端，不能假设 HTTP 响应完成后临时进程仍会继续运行。

Webhook

创建组织级事件订阅，验证签名并跟踪重试与重放。

自托管

明确选择并验证数据库、对象存储和任务执行后端。