Skip to main content
自托管模式下，Web 应用完全跑在浏览器里。简历数据持久化在名为 MagicResumeDB 的 IndexedDB 里。没有鉴权、没有后端（gateway / platform-api / agent-service），也不会发送产品埋点事件。AI 完全不可用 —— AI Lab 和 AI PDF 导入都会代理到后端、需要已登录用户，这里用不了。 这是改造代码本身时推荐的模式。

​
前置条件

  • Node.js 20+
  • pnpm 10.28.1（packageManager 里钉死的版本）。其他版本能跑，但 lockfile 漂移要你自己负责。
1

克隆仓库

2

安装依赖

必须从 仓库根目录 运行 —— pnpm 需要看到 pnpm-workspace.yaml 才能解析 workspace:* 依赖。
3

配置环境变量

自托管模式的最小配置是：
如果 NEXT_PUBLIC_APP_MODE 没设置，并且 NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY 也没设置，应用会自动判断为 self-hosted。显式设置一下只是更清楚。
4

启动开发服务器

Turbo 会把每个有 dev 脚本的 workspace 都拉起来，Web 应用监听 http://localhost:3000。（本文档是独立的 Mintlify 站点，用 npx mint dev 本地预览。）只跑 Web 应用：

​
没有后端时能用什么

纯自托管模式下没有 AI —— 每个 AI 功能都会代理到后端、且要求已登录用户。把完整后端跑起来、切到云端模式才能用；那时你可以自带 API Key（只存浏览器本地）代替平台额度。

​
环境变量速查

完整的云端模式变量列表见 云端模式。