跳转到主要内容
云端模式启用 Clerk 鉴权、经 Core API 的简历同步,以及 agent-service 的对话、面试、翻译、JD 优化和 PDF 解析能力。后端独立部署,前端通过 NEXT_PUBLIC_API_URL 连接它的网关。 云端模式打开了自托管模式下关闭的三件事:
  1. Clerk 鉴权 —— 必须登录,每个 API 请求都带上 JWT。
  2. 云端同步 —— 简历经过一套 NestJS 写的 Core API 往返,附带版本历史和简历分享。
  3. agent-service(TypeScript,后端侧)—— 对话、面试、翻译、JD 优化、PDF 解析。

应用如何判定云端模式?

apps/web/src/lib/config/app.ts 解析当前模式:
src/middleware.ts 在模块加载时根据 APP_MODE 切换 Clerk 的 clerkMiddleware 或一个 no-op handler。没有运行时开关 —— 模式在构建时就定死了。
如果你设了 NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY 但忘了 NEXT_PUBLIC_API_URL,应用仍然会以云端模式启动,所有鉴权请求都会 404。两个一起设,或者两个都别设。

云端模式需要哪些环境变量?

云端模式如何连接后端服务?

后端(Core API + agent)独立部署,不在本 monorepo 内,前面统一挡着一个网关。本地开发云端模式时,把后端跑起来,然后用 NEXT_PUBLIC_API_URL 指向它的网关(dev 默认 http://localhost:3110)——前端永远只需要这一个 URL。如果你只想改前端,自托管模式更快。

云端请求如何鉴权?

  • Clerk 在登录时签发一个 JWT。
  • apps/web/src/lib/api/httpClient.ts 在 Axios 请求拦截器里(configureHttpClient)把这个 JWT 作为 Bearer token 附上。
  • httpClient.api 和 httpClient.agent 都指向同一个网关源、共用同一个拦截器 —— 你不应该手动传 token。
完整的请求路径见 架构 → HTTP 客户端。