Cloudflare recommends migrating from Pages to Workers
9 months ago
- #Cloudflare
- #Serverless
- #Migration
- Cloudflare Workers允许部署全栈应用程序，包括前端静态资源、后端API和服务器端渲染页面(SSR)。
- 相比Pages，Workers提供更广泛的功能集，例如Durable Objects、Cron Triggers和全面的可观测性工具。
- 从Pages迁移到Workers需要切换适配器、创建Wrangler配置文件并显式设置静态资源目录。
- 对于单页应用(SPA)或自定义404页面，Workers需要显式配置，而Pages支持自动检测功能。
- Workers需通过.assetsignore文件手动排除node_modules等目录，Pages则会自动排除这些文件。
- 使用Pages Functions的全栈框架需更新配置以适配Workers，同时需迁移或忽略_worker.js文件。
- 除非配置assets.run_worker_first参数，否则Workers默认会优先响应静态资源请求而非执行Worker脚本。
- Workers提供可定制的静态资源绑定方式，不同于Pages自动生成的ASSETS绑定。
- 开发命令从wrangler pages dev/deploy变更为wrangler dev/deploy，可选支持Vite插件。
- Workers的预览环境需手动启用预览URL和非生产分支构建，可选配置Cloudflare访问保护。
- 若静态资源目录包含_headers和_redirects文件，Workers将原生支持这些配置规则。
- Workers提供workers.dev子域名，并支持自定义域名和路由部署方案。
- 迁移完成并验证无误后，可删除原Pages项目。
- 兼容性矩阵清晰展示了Workers与Pages的功能支持差异，部分特性需变通方案或暂不支持。