reactive-resume：实践指南

团队讨论reactive-resume时，我会先把用途说清楚：一款独一无二的简历创建工具，可保护您的隐私，完全安全、可定制、可移植、开源且永久免费，今天就尝试一下吧。这类安全分析工具真正难在授权边界、证据完整性和误报需要同时控制，仓库说明只能作为第一层证据。更实际的做法是在明确授权的样例或离线靶场中验证，同时核对输入边界、证据链、误报率和安全中止机制，不要直接在关键项目上。编辑判断上，具备授权环境和复核能力的安全人员可以优先研究它；其他团队不必为了热门标签勉强接入。

[!IMPORTANT] 存储库已移动： Reactive Resume 现在位于 GitHub 上的 reactive-resume/reactive-resume。 Docker Hub 停留在 amruthpillai/reactive-resume。 GHCR 镜像发布到 ghcr.io/reactive-resume/reactive-resume。 GitHub 赞助商和 Open Collective 资金链接保持不变。

创建一个免费帐户，导入现有简历或重新开始，并在撰写时查看完成的页面。下载 PDF、Word、Markdown 或 JSON 文件，或通过公共链接分享您的简历。您还可以在自己的基础设施上运行整个应用程序。

您拥有您的数据。该代码库是在 MIT 许可证下开源的，没有跟踪，没有广告，也没有付费层。可选的 AI 功能使用您连接的提供商；托管和提供商的使用可能会产生各自的费用。

[!NOTE] 此分支包含即将发布的 v6 版本。请阅读 v6 中的新增功能和 发行说明 以了解完整的更改。现有的自托管安装应遵循 升级到 v6。

特点

编写、设计和检查

• 重新设计的编辑器，具有内联内容编辑和页面上的单击选择功能
• 由 Forme 提供支持的实时 PDF 预览和浏览器下载，在后台工作人员中呈现
• 富文本、自定义部分、拖放排序以及具有一致格式的结构化日期
• 自动保存、未保存的简历草稿的本地恢复以及最多 200 个撤消步骤
• 手机和平板电脑布局、键盘快捷键和可搜索命令栏

模板和定制

• 17 个模板，包括新的 Porygon 和 Smeargle，可使用您自己的内容进行预览
• 一列、两列和 ATS-safe 模板过滤器
• 字体预设、自定义字体、颜色、间距、A4 和信纸以及左侧或右侧边栏
• 通过调整密度、边距和文本大小来适应溢出的内容
• 自定义样式编写为语义 CSS，页面上带有元素选择器

恢复检查

• 可读性检查，并将结果固定到相关行
• 职位发布关键字匹配和招聘软件文本视图
• 检查导出的 PDF，以及可选的 AI 写作审核
• 公共 ATS 检查器，无需帐户即可在浏览器中读取 PDFs

文件和求职信

• 一个可搜索的简历和信件库，带有标签、排序以及网格或列表视图
• 具有自己的编辑器、导出和版本历史记录的独立求职信
• 将信件链接到简历，以保持发件人详细信息和设计同步，或独立自定义
• 您可以预览和恢复的自动和命名版本
• 具有撤消功能的垃圾箱和 30 天的恢复窗口

工作申请

• 列表、看板、见解和日历视图，用于跟踪从“已保存”到“要约”的申请
• 保存 URL 或粘贴的帖子中的职位；通过 Firecrawl、Tavily 或 Exa 进行可选关键字搜索
• 为已保存的工作定制简历并起草求职信
• 跟踪联系人、笔记、跟进、申请结果以及您发送的文档
• 安排面试、导出日历事件以及导入或导出应用程序为 CSV

AI 助理

• 您的简历或信件旁边的助理，对话与该文件相关
• 拟议的编辑显示了哪些变化以及原因；接受或拒绝每个建议
• 改进所选文本、评论写作以及起草简历和招聘启事中的信件
• 连接 OpenAI、Anthropic、Google Gemini、OpenRouter、Ollama 或其他支持的提供商和兼容端点
• 可选的网络搜索和页面阅读；自托管者可以配置共享 AI 和 Web 访问提供商

导入、导出和共享

• 导入反应式简历 JSON、JSON 简历、LinkedIn 数据导出、PDF 和 Word 文件
• JSON、LinkedIn 和可读的 PDF 导入无需 AI 即可工作； Word 导入需要连接的提供商
• 将简历和信件导出为 PDF、Word (DOCX)、Markdown 或 JSON
• 通过具有可选密码保护和 view/download 统计信息的公共链接共享简历
• REST API 和 MCP 服务器用于文档管理、导入、导出、检查和应用程序工作流程

隐私和控制

• 使用 Docker、Vercel 或 Cloudflare Workers 自托管
• 没有跟踪或广告；导出您的帐户数据或删除您的帐户
• 密钥、双因素身份验证和链接的登录提供商
• 多种界面语言、light/dark/system 主题和简化运动支持

模板

快速入门

使用 托管应用程序 开始编写，或使用 Docker 和 Docker Compose 在本地构建此结帐：

# Clone the repository
git clone --depth=1 https://github.com/reactive-resume/reactive-resume.git reactive-resume
cd reactive-resume

# Create your local configuration
cp .env.example .env
# Edit .env: set AUTH_SECRET and a separate ENCRYPTION_SECRET.
# Generate each secret with: openssl rand -hex 32

# Build the app and start PostgreSQL, Redis, and SeaweedFS
docker compose up -d --build

# Open http://localhost:3000 in your browser

这将构建签出的源。对于使用已发布映像的部署，请遵循 Docker 指南。对于源开发，请参阅 开发设置指南。

技术堆栈

文档

完整文档位于 docs.rxresu.me：

自托管

Reactive Resume 支持 Docker、Kubernetes、Vercel 和 Cloudflare Workers。每个部署都使用 PostgreSQL 运行相同的应用程序并上传存储。

Vercel 通过其部署向导配置 Neon PostgreSQL、私有 Blob 存储和 Upstash Redis。提供两个持久密钥并使用 Services 框架预设。静态资产在前端服务中运行，Hono 从后端服务提供应用程序路由和 APIs。有关设置、限制和可选 SMTP/OAuth 配置，请参阅 Vercel 指南。

Cloudflare 部署需要 Workers Paid 并通过 Hyperdrive 使用静态资产、私有 R2 存储、SQLite 耐用对象和 PostgreSQL。提供现有的 PostgreSQL 数据库并在部署之前应用迁移。有关设置和运行时限制，请参阅 Cloudflare 指南。

对于 Docker 和 Kubernetes，应用程序需要：

• PostgreSQL — 帐户、文档、应用程序和助理对话
• 上传存储 — 持久的本地目录或与 S3 兼容的存储桶，例如 SeaweedFS
• Redis（可选）——跨实例共享协调和可恢复的助理回复
• SMTP（可选）- 验证和密码重置电子邮件

v6 中的 PDF 生成在浏览器和服务器上使用 Forme。不需要无浏览器、Chromium 或外部打印服务。可以删除旧版 PRINTER_* 和 BROWSERLESS_* 环境变量。

已发布的版本可从 Docker Hub 和 GitHub 容器注册表获取（latest 跟踪最新的稳定版本）：

# Docker Hub
docker pull amruthpillai/reactive-resume:latest

# GitHub Container Registry
docker pull ghcr.io/reactive-resume/reactive-resume:latest

有关完整说明，请参阅 Docker 指南 或 Kubernetes 指南。自托管者还可以配置 共享 AI 和求职服务。

对于 v5 升级，请在应用 v6 迁移之前备份数据库并上传并停止所有 v5 实例。旧的视觉样式规则需要手动转换； API 和 MCP 集成也有更改。关注 升级到 v6。

支持

反应式简历始终是免费和开源的。如果它帮助您找到了工作或节省了您的时间，请考虑支持持续发展：

其他支持方式：

• 给这个仓库加星标
• 报告可重现的错误并建议可操作的功能
• 帮助 GitHub 讨论中的其他用户
• 改进文档
• 帮助翻译