自托管
本地开发
使用 Docker Compose 运行本地依赖，通过 Wrangler 启动应用。
根目录 docker-compose.yml 提供本地 Postgres、MinIO 和可观测性后端。
应用通过 Cloudflare 开发适配器运行；API 的 Node 服务运行在本地 Cloudflare Container 中。
启动开发拓扑
准备 Node.js 22+、pnpm 和 Docker，在仓库根目录执行：
pnpm install
pnpm infra:up
cp apps/server/.env.example apps/server/.env
cp apps/trigger-worker/.env.example apps/trigger-worker/.env
cp apps/worker/.env.example apps/worker/.env把示例密钥替换为本地开发值，并配置所需的供应商 OAuth 应用。
不要提交 .env 文件。随后初始化本地数据库、发布目录并启动应用：
pnpm db:migrate
pnpm tools:publish-catalog
pnpm dev| 应用 | 本地地址 |
|---|---|
| API Worker + Container | http://localhost:3000 |
| 控制台 | http://localhost:3001 |
| 营销站 | http://localhost:3002 |
| 文档站 | http://localhost:4000 |
| Trigger Worker | http://localhost:8788 |
| 计费 Worker | http://localhost:8799 |
Container 通过 Docker host gateway 访问本地数据库、OTLP 和 S3 端点。 定时 Worker 使用本地 Hyperdrive 模拟器。本地 Trigger 对账无需生产 Queue 凭证即可恢复 持久任务，原生 Queue 投递由 workerd 测试覆盖。
用 curl http://localhost:3000/ 确认返回 OK，再验证控制台和经认证的工具调用。
停止应用进程后，用 pnpm infra:stop 停止依赖并保留本地数据。
本地数据库与密钥应和生产环境分离。
自己的生产账户请使用部署到 Cloudflare。