# Pages

Build full-stack, serverless applications globally with minimal configuration

> Links below point directly to Markdown versions of each page. Any page can also be retrieved as Markdown by sending an `Accept: text/markdown` header to the page's URL without the `index.md` suffix (for example, `curl -H "Accept: text/markdown" https://cloudflaredoc.ubitools.com/pages/`).
>
> For other Cloudflare products, see the [Cloudflare documentation directory](https://cloudflaredoc.ubitools.com/llms.txt).

## Overview

- [Cloudflare Pages](https://cloudflaredoc.ubitools.com/pages/index.md): 使用 Pages 将全栈应用即时部署到 Cloudflare 全球网络。

## Functions

- [Functions](https://cloudflaredoc.ubitools.com/pages/functions/index.md): 使用 Pages Functions 在 Cloudflare Pages 上构建全栈应用。
- [高级模式](https://cloudflaredoc.ubitools.com/pages/functions/advanced-mode/index.md): 使用 _worker.js 文件而非 /functions 目录开发 Pages Functions。
- [API 参考](https://cloudflaredoc.ubitools.com/pages/functions/api-reference/index.md): 了解 Pages Functions 中使用的 API。
- [绑定（binding）](https://cloudflaredoc.ubitools.com/pages/functions/bindings/index.md): 将 Pages Functions 连接到 KV、R2、D1 和 Durable Objects 等 Cloudflare 资源。
- [调试与日志](https://cloudflaredoc.ubitools.com/pages/functions/debugging-and-logging/index.md): 使用 Cloudflare 仪表板或 Wrangler CLI 访问 Pages Functions 日志。
- [使用中间件进行 A/B 测试](https://cloudflaredoc.ubitools.com/pages/functions/examples/ab-testing/index.md): 通过基于 cookie 控制提供的页面来设置 A/B 测试。此版本支持将请求传递到源站进行测试和对照。
- [添加 CORS 标头](https://cloudflaredoc.ubitools.com/pages/functions/examples/cors-headers/index.md): 用于附加 CORS 标头的 Pages Functions。
- [快速入门](https://cloudflaredoc.ubitools.com/pages/functions/get-started/index.md): 在 Cloudflare Pages 上创建并部署你的第一个 Pages Function。
- [本地开发](https://cloudflaredoc.ubitools.com/pages/functions/local-development/index.md): 使用 Wrangler 在本地运行和测试 Pages 应用。
- [指标](https://cloudflaredoc.ubitools.com/pages/functions/metrics/index.md): 查看 Pages Functions 的请求和性能指标。
- [中间件](https://cloudflaredoc.ubitools.com/pages/functions/middleware/index.md): 使用中间件为 Pages Functions 添加可复用逻辑，如错误处理和身份验证。
- [模块支持](https://cloudflaredoc.ubitools.com/pages/functions/module-support/index.md): 在 Pages Functions 中导入 ES 模块、WebAssembly、文本和二进制文件。
- [Pages Plugin](https://cloudflaredoc.ubitools.com/pages/functions/plugins/index.md): 使用包含内置路由和功能的可分发 Plugin 扩展 Pages Functions。
- [Cloudflare Access](https://cloudflaredoc.ubitools.com/pages/functions/plugins/cloudflare-access/index.md): 使用此 Plugin 在 Pages Functions 中验证 Cloudflare Access JWT 断言。
- [社区 Plugin](https://cloudflaredoc.ubitools.com/pages/functions/plugins/community-plugins/index.md): 浏览社区维护的 Pages Plugin，包括资源协商、反向代理等。
- [Google Chat](https://cloudflaredoc.ubitools.com/pages/functions/plugins/google-chat/index.md): 使用 Pages Plugin 创建 Google Chat 机器人，用于响应消息和发送警报。
- [GraphQL](https://cloudflaredoc.ubitools.com/pages/functions/plugins/graphql/index.md): 使用 GraphQL Pages Plugin 在 Cloudflare Pages 上设置 GraphQL 服务器。
- [hCaptcha](https://cloudflaredoc.ubitools.com/pages/functions/plugins/hcaptcha/index.md): 使用 hCaptcha Pages Plugin 在 Pages Functions 中验证 hCaptcha 令牌。
- [Honeycomb](https://cloudflaredoc.ubitools.com/pages/functions/plugins/honeycomb/index.md): 使用此 Plugin 将 Pages Functions 的 trace 发送到 Honeycomb 以进行可观测性分析。
- [Sentry](https://cloudflaredoc.ubitools.com/pages/functions/plugins/sentry/index.md): 使用 Sentry Pages Plugin 在 Pages Functions 中捕获和记录异常。
- [Static Forms](https://cloudflaredoc.ubitools.com/pages/functions/plugins/static-forms/index.md): 使用 Static Forms Plugin 在 Pages Functions 中拦截和处理 HTML 表单提交。
- [Stytch](https://cloudflaredoc.ubitools.com/pages/functions/plugins/stytch/index.md): 使用 Stytch Pages Plugin 在 Pages Functions 中验证 Stytch 会话令牌。
- [Turnstile](https://cloudflaredoc.ubitools.com/pages/functions/plugins/turnstile/index.md): 使用 Turnstile Plugin 在 Pages Functions 中验证 Cloudflare Turnstile 令牌。
- [vercel/og](https://cloudflaredoc.ubitools.com/pages/functions/plugins/vercel-og/index.md): 使用 @vercel/og Pages Plugin 在 Pages Functions 中生成社交图片。
- [定价](https://cloudflaredoc.ubitools.com/pages/functions/pricing/index.md): Pages Functions 的请求按 Cloudflare Workers 请求计费，适用于免费和付费计划。
- [路由](https://cloudflaredoc.ubitools.com/pages/functions/routing/index.md): 了解 Pages Functions 如何使用基于文件的路由将 URL 模式映射到函数文件。
- [Smart Placement](https://cloudflaredoc.ubitools.com/pages/functions/smart-placement/index.md): 自动在更靠近后端基础设施的位置运行 Pages Functions，以降低延迟。
- [Source map 与堆栈跟踪](https://cloudflaredoc.ubitools.com/pages/functions/source-maps/index.md): 为 Pages 添加 source map 并生成堆栈跟踪。
- [TypeScript](https://cloudflaredoc.ubitools.com/pages/functions/typescript/index.md): 使用 TypeScript 编写 Pages Functions，并使用 Wrangler 配置类型生成。
- [配置](https://cloudflaredoc.ubitools.com/pages/functions/wrangler-configuration/index.md): 使用 Wrangler 配置文件或 Cloudflare 仪表板配置 Pages Functions 设置。

## 教程

- [教程](https://cloudflaredoc.ubitools.com/pages/tutorials/index.md): 帮助你在 Cloudflare Pages 上构建和部署项目的引导式教程。
- [使用 Formspree 添加 React 表单](https://cloudflaredoc.ubitools.com/pages/tutorials/add-a-react-form-with-formspree/index.md): 了解如何使用 Formspree（处理表单提交和存储的后端服务）添加 React 表单。
- [使用 Formspree 添加 HTML 表单](https://cloudflaredoc.ubitools.com/pages/tutorials/add-an-html-form-with-formspree/index.md): 了解如何使用 Formspree（处理表单提交和存储的后端服务）添加 HTML 表单。
- [使用 Nuxt.js 和 Sanity.io 在 Cloudflare Pages 上构建博客](https://cloudflaredoc.ubitools.com/pages/tutorials/build-a-blog-using-nuxt-and-sanity/index.md): 使用 Nuxt.js 和 Sanity.io 构建博客应用并部署到 Cloudflare Pages。
- [使用 Pages Functions 为前端构建 API](https://cloudflaredoc.ubitools.com/pages/tutorials/build-an-api-with-pages-functions/index.md): 本教程使用 React 框架构建全栈 Pages 应用。
- [创建 HTML 表单](https://cloudflaredoc.ubitools.com/pages/tutorials/forms/index.md): 本教程简要介绍 HTML 表单基础知识，并大量使用 Cloudflare Pages 及其 Workers 集成。
- [使用 HTMLRewriter 本地化网站](https://cloudflaredoc.ubitools.com/pages/tutorials/localize-a-website/index.md): 本教程使用 Cloudflare Workers 平台的 HTMLRewriter 功能叠加 i18n 层，根据用户语言自动翻译站点。
- [将 R2 用作 Cloudflare Pages 的静态资源存储](https://cloudflaredoc.ubitools.com/pages/tutorials/use-r2-as-static-asset-storage-for-pages/index.md): 本教程将教你如何使用 R2 作为 Pages 应用的静态资源存储桶。

## 演示与架构

- [演示与架构](https://cloudflaredoc.ubitools.com/pages/demos/index.md): 探索 Cloudflare Pages 的演示应用和参考架构。

## configuration

- [REST API](https://cloudflaredoc.ubitools.com/pages/configuration/api/index.md): 使用 REST API 以编程方式管理 Cloudflare Pages 项目、部署和构建。
- [分支构建控制](https://cloudflaredoc.ubitools.com/pages/configuration/branch-build-controls/index.md): 控制 Cloudflare Pages 项目中哪些 branch 触发自动部署。
- [构建缓存](https://cloudflaredoc.ubitools.com/pages/configuration/build-caching/index.md): 通过在部署之间缓存依赖和构建输出，加快 Cloudflare Pages 构建速度。
- [构建配置](https://cloudflaredoc.ubitools.com/pages/configuration/build-configuration/index.md): 为 Cloudflare Pages 项目设置构建命令、输出目录和框架预设。
- [构建镜像](https://cloudflaredoc.ubitools.com/pages/configuration/build-image/index.md): 查看 Cloudflare Pages 构建镜像中支持的语言、工具和环境变量。
- [构建监视路径](https://cloudflaredoc.ubitools.com/pages/configuration/build-watch-paths/index.md): 配置哪些文件路径在推送更改时触发或跳过 Cloudflare Pages 构建。
- [自定义域名](https://cloudflaredoc.ubitools.com/pages/configuration/custom-domains/index.md): 为 Cloudflare Pages 项目添加自定义域名和子域名。
- [调试 Pages](https://cloudflaredoc.ubitools.com/pages/configuration/debugging-pages/index.md): 排查常见的 Cloudflare Pages 构建错误和部署失败问题。
- [Deploy Hooks](https://cloudflaredoc.ubitools.com/pages/configuration/deploy-hooks/index.md): 使用唯一 webhook URL 从外部事件源触发 Cloudflare Pages 部署。
- [Early Hints](https://cloudflaredoc.ubitools.com/pages/configuration/early-hints/index.md): 使用 Early Hints 预加载资源，提升 Cloudflare Pages 上的页面加载性能。
- [Git 集成](https://cloudflaredoc.ubitools.com/pages/configuration/git-integration/index.md): 将 GitHub 或 GitLab 仓库连接到 Cloudflare Pages，在推送时自动构建和部署。
- [GitHub 集成](https://cloudflaredoc.ubitools.com/pages/configuration/git-integration/github-integration/index.md): 将 GitHub 仓库连接到 Cloudflare Pages，实现自动部署、预览 URL 和检查运行。
- [GitLab 集成](https://cloudflaredoc.ubitools.com/pages/configuration/git-integration/gitlab-integration/index.md): 将 GitLab 仓库连接到 Cloudflare Pages，实现自动部署和提交状态检查。
- [构建故障排除](https://cloudflaredoc.ubitools.com/pages/configuration/git-integration/troubleshooting/index.md): 解决与部署和安装相关的常见 Cloudflare Pages git 集成错误。
- [标头](https://cloudflaredoc.ubitools.com/pages/configuration/headers/index.md): 使用 _headers 文件为 Cloudflare Pages 站点设置自定义 HTTP 响应标头。
- [Monorepo](https://cloudflaredoc.ubitools.com/pages/configuration/monorepos/index.md): 从单个 monorepo 仓库部署多个 Cloudflare Pages 项目。
- [预览部署](https://cloudflaredoc.ubitools.com/pages/configuration/preview-deployments/index.md): 在生产部署前，通过唯一 URL 预览 Cloudflare Pages 项目的新版本。
- [重定向](https://cloudflaredoc.ubitools.com/pages/configuration/redirects/index.md): 使用 _redirects 文件为 Cloudflare Pages 站点定义 URL 重定向。
- [回滚](https://cloudflaredoc.ubitools.com/pages/configuration/rollbacks/index.md): 立即将 Cloudflare Pages 项目恢复到之前的生产部署。
- [提供 Pages 服务](https://cloudflaredoc.ubitools.com/pages/configuration/serving-pages/index.md): 了解 Cloudflare Pages 如何处理路由匹配、404 行为、SPA 渲染和缓存。

## framework-guides

- [Blazor](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-blazor-site/index.md): 将 Blazor WebAssembly 应用部署到 Cloudflare Pages。
- [Brunch](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-brunch-site/index.md): 将 Brunch 站点部署到 Cloudflare Pages。
- [Docusaurus](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-docusaurus-site/index.md): 将 Docusaurus 文档站点部署到 Cloudflare Pages。
- [Gatsby](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-gatsby-site/index.md): 将 Gatsby 站点部署到 Cloudflare Pages。
- [Gridsome](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-gridsome-site/index.md): 将 Gridsome 站点部署到 Cloudflare Pages。
- [Hexo](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-hexo-site/index.md): 将 Hexo 静态站点部署到 Cloudflare Pages。
- [Hono](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-hono-site/index.md): 将 Hono Web 应用部署到 Cloudflare Pages。
- [Hugo](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-hugo-site/index.md): 将 Hugo 静态站点部署到 Cloudflare Pages。
- [Jekyll](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-jekyll-site/index.md): 将 Jekyll 站点部署到 Cloudflare Pages。
- [Nuxt](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-nuxt-site/index.md): 使基于 Vue.js 的开发简单且强大的 Web 框架。
- [Pelican](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-pelican-site/index.md): 将 Pelican 静态站点部署到 Cloudflare Pages。
- [Preact](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-preact-site/index.md): 将 Preact 应用部署到 Cloudflare Pages。
- [Qwik](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-qwik-site/index.md): 将 Qwik City 应用部署到 Cloudflare Pages。
- [React](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-react-site/index.md): 将 React 应用部署到 Cloudflare Pages。
- [Remix](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-remix-site/index.md): 将 Remix 应用部署到 Cloudflare Pages，或迁移到 React Router。
- [SolidStart](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-solid-start-site/index.md): 将 SolidStart 应用部署到 Cloudflare Pages。
- [Sphinx](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-sphinx-site/index.md): 将 Sphinx 文档站点部署到 Cloudflare Pages。
- [SvelteKit](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-svelte-kit-site/index.md): 了解如何使用 create-cloudflare CLI 创建 SvelteKit 应用并部署到 Cloudflare Pages
- [Vite 3](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-vite3-project/index.md): 将 Vite 3 前端项目部署到 Cloudflare Pages。
- [VitePress](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-vitepress-site/index.md): 将 VitePress 静态站点部署到 Cloudflare Pages。
- [Vue](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-vue-site/index.md): 将 Vue 应用部署到 Cloudflare Pages。
- [Zola](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-a-zola-site/index.md): 将 Zola 静态站点部署到 Cloudflare Pages。
- [Analog](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-an-analog-site/index.md): 基于 Vite 和 Nitro 的 Angular 全栈元框架。
- [Angular](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-an-angular-site/index.md): 将 Angular 应用部署到 Cloudflare Pages。
- [Astro](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-an-astro-site/index.md): 将 Astro 站点部署到 Cloudflare Pages。
- [Elder.js](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-an-elderjs-site/index.md): 将 Elder.js 静态站点部署到 Cloudflare Pages。
- [Eleventy](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-an-eleventy-site/index.md): 将 Eleventy 静态网站部署到 Cloudflare Pages。
- [Ember](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-an-emberjs-site/index.md): 将 Ember.js 应用程序部署到 Cloudflare Pages。
- [MkDocs](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-an-mkdocs-site/index.md): 将 MkDocs 文档站点部署到 Cloudflare Pages。
- [Static HTML](https://cloudflaredoc.ubitools.com/pages/framework-guides/deploy-anything/index.md): 在不使用框架的情况下将任意静态 HTML 网站部署到 Cloudflare Pages。
- [Next.js](https://cloudflaredoc.ubitools.com/pages/framework-guides/nextjs/index.md): 用于构建全栈 Web 应用的 React 框架。
- [静态网站](https://cloudflaredoc.ubitools.com/pages/framework-guides/nextjs/deploy-a-static-nextjs-site/index.md): 将使用 Next.js 构建的静态网站部署到 Cloudflare Pages。

## get-started

- [C3 CLI](https://cloudflaredoc.ubitools.com/pages/get-started/c3/index.md): 使用 C3（`create-cloudflare` CLI）设置并部署新应用，通过框架专用设置指南确保每个新应用遵循 Cloudflare 及第三方部署最佳实践。
- [直接上传](https://cloudflaredoc.ubitools.com/pages/get-started/direct-upload/index.md): 将预构建资源上传到 Pages，并通过 Wrangler CLI 或 Cloudflare 仪表板部署。
- [Git 集成](https://cloudflaredoc.ubitools.com/pages/get-started/git-integration/index.md): 将 Git 提供商连接到 Pages。

## how-to

- [添加自定义 HTTP 标头](https://cloudflaredoc.ubitools.com/pages/how-to/add-custom-http-headers/index.md): 使用 Workers 函数在 Cloudflare Pages 上自定义 HTTP 标头。
- [为各分支设置构建命令](https://cloudflaredoc.ubitools.com/pages/how-to/build-commands-branches/index.md): 在 Cloudflare Pages 项目的特定分支上运行不同的构建命令。
- [为分支添加自定义域](https://cloudflaredoc.ubitools.com/pages/how-to/custom-branch-aliases/index.md): 将自定义域指向 Cloudflare Pages 项目特定分支部署。
- [部署静态 WordPress 站点](https://cloudflaredoc.ubitools.com/pages/how-to/deploy-a-wordpress-site/index.md): 了解如何使用 Cloudflare Pages 部署静态 WordPress 站点。
- [启用 Zaraz](https://cloudflaredoc.ubitools.com/pages/how-to/enable-zaraz/index.md): 使用自定义域名在 Cloudflare Pages 项目上设置 Zaraz。
- [安装私有包](https://cloudflaredoc.ubitools.com/pages/how-to/npm-private-registry/index.md): 在 Cloudflare Pages 构建中使用自定义 npm 注册表和私有依赖。
- [使用 Cloudflare Tunnel 预览本地项目](https://cloudflaredoc.ubitools.com/pages/how-to/preview-with-cloudflare-tunnel/index.md): 使用 Cloudflare Tunnel 通过公共 URL 共享本地运行的 Pages 项目。
- [将 *.pages.dev 重定向到自定义域](https://cloudflaredoc.ubitools.com/pages/how-to/redirect-to-custom-domain/index.md): 使用 Bulk Redirects 将 pages.dev 子域重定向到自定义域。
- [将 Worker 重构为 Pages Function](https://cloudflaredoc.ubitools.com/pages/how-to/refactor-a-worker-to-pages-functions/index.md): 将现有 Cloudflare Worker 迁移为 Pages 项目的 Pages Function。
- [在持续集成中使用 Direct Upload](https://cloudflaredoc.ubitools.com/pages/how-to/use-direct-upload-with-continuous-integration/index.md): 在 CI/CD 流水线中使用 Wrangler 将预构建资源部署到 Cloudflare Pages。
- [在 Pages 中使用 Pages Functions 进行 A/B 测试](https://cloudflaredoc.ubitools.com/pages/how-to/use-worker-for-ab-testing-in-pages/index.md): 使用 Pages Functions 和 Cookie 在 Cloudflare Pages 中实现 A/B 测试。
- [启用 Web Analytics](https://cloudflaredoc.ubitools.com/pages/how-to/web-analytics/index.md): 通过一键配置在 Pages 项目上设置 Cloudflare Web Analytics。
- [将 www 重定向到 apex 域名](https://cloudflaredoc.ubitools.com/pages/how-to/www-redirect/index.md): 使用 Bulk Redirects 在 Cloudflare Pages 上将 www 子域名重定向到 apex 域名。

## migrations

- [从 Firebase 迁移](https://cloudflaredoc.ubitools.com/pages/migrations/migrating-from-firebase/index.md): 本教程说明如何将现有 Firebase 应用迁移到 Cloudflare Pages。
- [从 Netlify 迁移到 Pages](https://cloudflaredoc.ubitools.com/pages/migrations/migrating-from-netlify/index.md): 了解如何从 Netlify 迁移到 Cloudflare。本指南包括迁移重定向和标头的说明。
- [从 Vercel 迁移到 Pages](https://cloudflaredoc.ubitools.com/pages/migrations/migrating-from-vercel/index.md): 在本教程中，你将学习如何将 Vercel 应用部署到 Cloudflare Pages。
- [从 Workers Sites 迁移到 Pages](https://cloudflaredoc.ubitools.com/pages/migrations/migrating-from-workers/index.md): 了解如何将现有 Workers Sites 应用迁移到 Cloudflare Pages。
- [将基于 Jekyll 的站点从 GitHub Pages 迁移](https://cloudflaredoc.ubitools.com/pages/migrations/migrating-jekyll-from-github-pages/index.md): 了解如何将基于 Jekyll 的站点从 GitHub Pages 迁移到 Cloudflare Pages。

## platform

- [更新日志](https://cloudflaredoc.ubitools.com/pages/platform/changelog/index.md): Cloudflare Pages 的最新变更与更新。
- [已知问题](https://cloudflaredoc.ubitools.com/pages/platform/known-issues/index.md): Cloudflare Pages 构建、部署和配置的当前 bug 和限制。
- [限制](https://cloudflaredoc.ubitools.com/pages/platform/limits/index.md): 按套餐类型划分的 Cloudflare Pages 构建、部署和自定义域名限制。
- [选择数据或存储产品](https://cloudflaredoc.ubitools.com/workers/platform/storage-options/index.md): 比较 Cloudflare Pages 应用可用的数据和存储产品。

## 迁移到 Workers

- [迁移到 Workers](https://cloudflaredoc.ubitools.com/workers/static-assets/migration-guides/migrate-from-pages/index.md): 将 Cloudflare Pages 项目迁移到带静态资源的 Cloudflare Workers。