SuperAPI AI 工具集

cloudflare-pages

部署与运维

查看项目

更新于 10-16 06:19

技能介绍

用途:在 Cloudflare 全球网络上托管静态站点、JAMstack 与含无服务器函数的全栈应用,支持 Git 集成或直接上传部署,并提供分支/PR 预览部署。

主要能力:Git 集成用于 GitHub/GitLab 的 CI/CD(注意选中后不能改为直接上传);直接上传适合预构建产物与 CI 流水线(Wrangler 限制 2 万文件、单文件 25 MiB);C3 CLI 用于新建项目脚手架。Pages Functions 采用 /functions 目录下的文件路由,如 /functions/api/users.js 映射到 /api/users,/functions/users/[id].js 映射到 /users/:id。可导出 onRequest、onRequestGet、onRequestPost 等处理函数,通过 EventContext 访问 request、env、params、data,并可调用 waitUntil 与 next。

使用方式:常用命令为 npx wrangler pages project create my-project、npx wrangler pages deploy ./dist、npx wrangler pages deploy ./dist --branch=feature-x,以及本地开发 npx wrangler pages dev ./dist(可加 --kv=MY_KV --d1=MY_DB=<ID>)。构建产物目录可在 wrangler.jsonc 中用 pages_build_output_dir 指定;构建期可读取 CF_PAGES=1、CF_PAGES_BRANCH、CF_PAGES_COMMIT_SHA、CF_PAGES_URL 等变量。绑定通过 context.env 访问 KV、R2、D1、Workers AI。头与重定向写在构建输出的 _headers、_redirects 文件中;_routes.json 控制 Functions 调用范围。

限制与注意:_headers/_redirects 不作用于 Pages Functions 响应,需在代码中附加头;直接上传项目不能转为 Git 集成;重定向上限为 2000 条静态加 100 条动态,且代理不得使用绝对 URL;使用 Wrangler 配置时绑定以文件为准,不要在 wrangler.toml 中存放密钥;预览部署默认带 X-Robots-Tag: noindex。其他配置细节与相关绑定技能资料暂未在本文展开。