Reactive Resume 本地部署与简历导出完整教程-平芜编程栈

Reactive Resume 本地部署与简历导出完整教程

【免费下载链接】reactive-resumeA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!项目地址: https://gitcode.com/GitHub_Trending/re/reactive-resume

Reactive Resume 是一款开源免费的简历构建工具：选模板、填内容、实时预览，直接导出 PDF。这篇教程带你从零跑通本地环境，做出并导出第一份可用简历，适合想自己掌控求职数据的求职者与开发者。

什么场景下它会救你

你连着投了十几个岗位，每改一次目标职位就要手动重排一遍简历格式——在这里每份简历是独立文件，复制一份、改名、改内容，互不干扰。

你不想把学历、经历、联系方式交给某个 SaaS 平台的云端——Reactive Resume 可以整站跑在你自己的机器上，数据只存在本地容器里。

导出的 PDF 到手后还要丢进 Word 微调——这里四种导出格式一次给齐，PDF、DOCX、Markdown、JSON 各管一段。

简历内容写得干瘪，又懒得自己逐句打磨——内置 AI 集成 OpenAI、Google Gemini、Anthropic Claude，直接在编辑器里改写工作经历。

🚀 第一次跑起来：从克隆到看见页面

3 条命令，你就能在浏览器里打开登录页和仪表盘。

前置清单，缺一样就先装好：

Docker（v20.10 或更高）与 Docker Compose（v2.0 或更高）
Git
一个浏览器

git clone https://gitcode.com/GitHub_Trending/re/reactive-resume

把代码仓库克隆到本地。

cd reactive-resume

进入项目根目录，后面的命令都在这里执行。

docker compose up -d

后台启动 PostgreSQL、Redis、SeaweedFS 和应用本体四个服务。自 v5.1.0 起 PDF 在浏览器端生成，不再需要额外的打印服务。

验证方式：打开 http://localhost:3000，用 GitHub、Google 或邮箱登录。你会看到简历仪表盘——空列表上方有一张Create a new resume卡片，这就是你的起点。想确认服务状态，执行docker compose ps，全部 healthy 即正常。

如果你要改源码而不是跑成品，改用 pnpm 开发模式，参考 docs/contributing/development.mdx。

📦 从空白页到导出的第一件成品

按下面四步走，10 分钟内你会拿到第一份 PDF。

第一步：选模板。点击Create a new resume卡片，填写名称和 slug，点击Create建空白简历，或从下拉菜单选Create a Sample Resume用示例内容先看效果。

进入编辑器后，打开右侧边栏的Template分区切换模板。内置 15 个模板，切换不丢失任何内容：

创意类岗位：Gengar、Pikachu 视觉表现更鲜明
金融、法律等正式场合：Onyx、Ditto 更克制
技术、创业方向：Chikorita、Leafish 疏密平衡

第二步：填核心信息。左侧面板按顺序填：姓名、职位、联系方式；专业摘要写 3-5 行；工作经历按时间倒序，每条突出一个可量化的成果；技能用星级标注熟练度。

第三步：盯实时预览。中间画布随输入即时刷新，所见即最终 PDF。内容超出一页时，先在 Page 设置里换 A4/Letter 或收紧间距，别急着加内容。

第四步：导出。点击编辑器右上角的Download按钮，在弹出的对话框里选格式：

格式	适用场景	注意点
PDF	投递、发招聘方邮件、打印	严格匹配当前模板与排版，求职首选
DOCX	后续在 Word、Google Docs 里编辑	视觉布局与 PDF 可能有细微差异
Markdown	纯文本修改、喂给 AI 工具改写	保留标题、列表与链接结构
JSON	备份、日后恢复或跨账户导入	仅在 Resume 页签可用，不含求职信

详细规则见 docs/guides/exporting-your-resume.mdx。

让它脱颖而出的三个招

第一招是自定义样式。路径：编辑器 →Design→Custom Styles。这里用的是一套面向 PDF 的 Semantic CSS，只改样式、不动内容。上手片段：

@version 1; section[type="experience"] > section-heading { color: #0f766e; text-transform: uppercase; }

状态显示 Valid 后，预览和导出都会生效。完整选择器参考 docs/applying-custom-styles.mdx。

第二招是AI 内容辅助。路径：编辑器内点击 AI 入口，选择 OpenAI、Google Gemini 或 Claude 任一服务商，输入"把这段经历改写得更突出协作能力"这类提示词，生成结果直接落回表单。

第三招是多版本管理。路径：回到仪表盘，为每个目标岗位建一份简历；已有内容想复用，用仪表盘里的复制功能生成副本，再用标签筛选归组。

想更进一步

用 API 接自己的脚本。登录后进入 Settings → API Keys 创建密钥，请求头带x-api-key即可访问，接口挂在/api/openapi下，能把简历数据拉进自己的自动化流程。细节见 docs/guides/using-the-api.mdx。

把整套服务部署到服务器。仓库根目录的 compose.yml 定义了完整生产栈：PostgreSQL 存数据、Redis 支撑 AI Agent、SeaweedFS 管文件。上线前把 AUTH_SECRET 换成强随机值即可，完整步骤见 docs/self-hosting/docker.mdx。

常见问题

Q：3000 或 3001 端口被占用，启动失败？A：在环境变量里改端口，例如PORT=3002 SERVER_PORT=3003后重新启动，或先停掉占用进程。

Q：不装 Docker，纯 pnpm 能跑吗？A：能。用docker compose -f compose.dev.yml up -d只起基础设施，再执行pnpm install和pnpm dev，流程见 docs/getting-started/quickstart.mdx 对应的开发指南。

Q：换模板会丢已经填的内容吗？A：不会。模板只管呈现方式，内容、章节、设置原样保留，随时来回切换。

打开终端，跑起你的 Reactive Resume，今晚就能导出第一份 PDF。