Last updated: 2026-06-30

Last verified: 2026-06-30 for Cloudflare Pages, Pages Functions, and Workers official documentation. Cloudflare platform behavior, limits, pricing, storage products, and runtime details must be re-checked before implementation.

OnlyPat 建站指南 is an independent guide-site project. This draft is not Cloudflare official documentation and does not imply affiliation with Cloudflare.

先说结论

静态工具站不一定需要后端。只要工具能在浏览器本地完成计算，不需要账号、数据库、私密文件、服务端密钥或跨用户状态，就应该先保持静态。后端只在有明确服务端职责时加入，而不是为了显得像“完整产品”提前加入。

适合 / 不适合

判断项 不需要后端 需要考虑后端
输入输出 文本、URL、时间、颜色、JSON 等本地转换 文件上传、私密数据、跨设备历史记录
状态 页面刷新后无需保存 需要账号、项目、收藏、订单、记录
密钥 不调用私密 API key 必须保护服务端 token 或第三方凭据
计算 浏览器能快速完成 计算量大、耗时长、需要排队或后台任务
OnlyPat 当前状态 tool.onlypat.com 第一版保持 browser-only 只有真实服务端需求才单独设计

30 分钟开工版

  1. 写下这个工具的输入、输出和是否需要保存数据。
  2. 判断计算能不能完全在浏览器完成。
  3. 检查是否有任何不能暴露给前端的密钥或账号信息。
  4. 判断用户是否需要登录、同步、历史记录或团队权限。
  5. 判断是否需要处理文件上传、长任务、队列或 webhook。
  6. 如果答案都是否，先做静态工具页。
  7. 如果有一个答案是 yes，再判断是 Pages Functions、Workers 还是外部后端。
  8. 把后端触发条件写进工具 roadmap，不要在第一版默认创建。

做到这里就可以停。不要先接数据库、登录、支付、存储桶或 API token。先把 browser-only 版本做成可用工具。

详细判断

工具站的第一版，最容易犯的错是把“以后可能有用”的能力提前做成系统复杂度。下面按输入、状态、密钥、性能、隐私和增长路径来判断。

1. 本地转换类工具优先静态

这些工具通常不需要后端：

  • JSON 格式化；
  • YAML / CSV 转换；
  • URL 编解码；
  • Base64 编解码；
  • 时间戳转换；
  • 颜色转换；
  • 文本清理；
  • QR Code 生成；
  • 搜索摘要预览；
  • ads.txt 行生成。

它们的共同点是：输入在浏览器里，输出也在浏览器里，站点不需要知道用户输入了什么。

2. 有账号和跨用户状态时才进入后端

后端的价值通常来自状态管理。

例如：

  • 用户要保存多个项目；
  • 多台设备要同步；
  • 团队要共享配置；
  • 需要权限和审计；
  • 要保存历史记录；
  • 要生成私密下载链接。

如果没有这些需求，先做后端只会增加部署、日志、安全、隐私和维护成本。

3. 有服务端密钥时不能硬塞前端

只要涉及不能公开的 API key、第三方 token、服务端凭据，就不能直接写进静态前端。

这时可以考虑：

  • Pages Functions：当前 Pages 项目里的轻量服务端路径；
  • Workers：独立 API、跨站复用、后台任务或更清楚的服务边界；
  • 外部服务：如果功能已经由成熟平台承担。

但“需要保护密钥”不等于马上做完整账号系统。先做最小服务端边界。

4. 长任务和文件处理要谨慎

工具站如果要处理大文件、批量任务、队列、第三方 API 调用或后台生成，就已经不是普通静态工具了。

这类功能需要先回答：

  • 文件是否会上传到服务器；
  • 是否需要删除策略；
  • 是否涉及个人数据；
  • 是否需要排队、重试和限流；
  • 是否需要日志和错误追踪；
  • 是否有成本和滥用风险。

没有这些答案，不要上线。

5. 后端不是 GEO 前置条件

AI 搜索和普通搜索更需要的是可理解、可抓取、可引用的页面说明。工具本身是否有后端，不是 GEO 的核心条件。

对工具页来说，更重要的是：

  • 页面说明工具用途；
  • 输入输出清楚；
  • 常见错误清楚；
  • 相关 guide 有内链；
  • WebApplication 结构化数据存在；
  • 工具能稳定运行。

常见误区

不要把“工具站”自动等同于“需要后端”。

不要为了保存用户输入而过早引入账号系统。

不要把私密 API key 写进前端。

不要在没有隐私政策更新时收集用户数据。

不要为了 SEO 或 GEO 增加无意义的服务端渲染。

不要把用户输入日志化，除非有明确目的、告知和安全处理。

不要把第一版做成数据库、队列、账号、支付、后台管理全套系统。

OnlyPat 实操备注

tool.onlypat.com 当前的路线是 browser-only developer workbench。UTM、搜索摘要、ads.txt、JSON、时间戳、URL 编码、QR Code 等工具都可以先在浏览器本地运行。

这条路线的好处是：

  • 部署简单；
  • 不处理用户私密数据；
  • 不需要数据库；
  • 不需要账号系统；
  • 工具页可以和 guide 内容互相支撑；
  • sitemap、robots、ads.txt、AdSense 和结构化数据保持清楚。

未来如果要做服务端能力，应该按功能逐个立项，而不是把整个 tool 站一次性重构成后端应用。

官方来源

  • Cloudflare Pages documentation: https://developers.cloudflare.com/pages/
  • Cloudflare Pages Functions: https://developers.cloudflare.com/pages/functions/
  • Cloudflare Workers documentation: https://developers.cloudflare.com/workers/

下一步

下一步先打开 https://tool.onlypat.com/，把每个工具按“本地转换”“需要密钥”“需要保存状态”“需要长任务”四类标记。只要工具属于本地转换，就继续保持静态优先。

如果你发现某个工具必须上传文件、调用私密 API、保存用户历史或处理后台任务，再回到 Cloudflare Pages 什么时候需要 Workers，判断应该用 Pages Functions、Workers，还是暂时不做。