Files
mnote/infra/convex/README.md
T
2026-02-01 08:47:40 +08:00

1.3 KiB
Raw Blame History

Convex 自托管(Windows 本机)

本目录用于在本机通过 Docker Compose 启动 Convex backend + dashboard,并使用 backend 自身的持久化卷存储(包含数据库与文件存储)。

启动

  1. 确保仓库根目录 .env.all 存在(全局唯一 env 文件)。
  2. 在本目录执行:
docker compose up -d

生成 Dashboard / CLI admin key

在本目录执行:

docker compose exec backend ./generate_admin_key.sh

访问地址(默认)

  • Dashboardhttp://localhost:6791
  • Backendhttp://127.0.0.1:3210
  • HTTP Actionshttp://127.0.0.1:3211
  • 文件存储:由 Convex 管理(Dashboard 的 Files 页面可查看)

快速验证(可选)

1) 验证 Convex functions 可用

wolai-frontend/ 执行:

npx convex dev --once --tail-logs disable --env-file ../.env.all --run ping:ping

2) 验证固定开发用户(阶段 3

启动前端后访问:http://127.0.0.1:3000/api/dev/whoami

3) 验证异步任务骨架(阶段 5

启动前端后:

  • POST http://127.0.0.1:3000/api/dev/jobs/demobody 可选:{ "ms": 800 })创建 demo job
  • GET http://127.0.0.1:3000/api/dev/jobs/demo?id=<jobId> 查询状态(queued/running/succeeded/failed