跳转到内容

静态内容站

纯文档站、官网、博客优先用 Pages 或 Workers Static Assets。文档站旁边还要接接口、评论或表单时,用 Workers Static Assets + 动态接口更顺手。大量图片、附件、导出物放 R2;普通站内搜索用 Pagefind;私有后台或预览环境用 Access / Tunnel。

入口适用场景判断依据
Workers Static Assets文档站旁边还会有接口、D1、R2、Queues、AI Gateway 或评论服务。Worker 和静态资产同一部署模型,长期更适合 Cloudflare-first 项目。
Pages纯静态文档、官网、博客、营销页、PR 预览优先的项目。Git 工作流轻,静态资产请求同样免费;动态函数按 Workers 计费。
路径推荐处理方式成本和风险
//docs/*/assets/*静态资产直接返回。静态资产请求免费且不限量,不交给 Worker 脚本。
/pagefind/*构建期搜索索引。用户搜索在浏览器本地完成,不消耗后端请求。
动态接口Worker。按 Workers 请求和 CPU 计费,需要日志、限流和错误处理。
/files/*Worker + R2。Worker 做权限和签名,文件本体进 R2。
/admin/*Worker + Access / Tunnel。Access 校验通过后进入后台。

成本主要来自动态路径和数据能力。文档、官网、博客的主流量应停在 Workers Static Assets / Pages;评论、表单、第三方回调和小接口才进入 Worker。站点构建包只放页面和前端资源,大量图片、附件、导出物进 R2。R2 仍然计算存储和操作,公开下载热点要看读取操作。D1 适合评论、表单和小型后台,高频分析和大表扫描走分析或数据管道。

  • 首页、文章页、404、CSS / JS / 图片都能访问。
  • 搜索索引存在,线上搜索能搜到文章。
  • 只有接口、评论、上传、后台等必要路径交给 Worker。
  • 文件上传由 Worker 生成签名或受控入口,R2 存储桶不开放任意写入。
  • 管理后台先用 Access / Tunnel 挡在前面,再做业务权限。
  • 日志能定位问题,但不记录密钥、登录凭证和正文隐私。