Cloudflare 部署

本指南介绍如何将 AR Docs 项目部署到 Cloudflare Pages。

准备工作

注册 Cloudflare 账号
将代码推送到 Git 仓库（GitHub / GitLab）

部署步骤

1. 创建 Pages 项目

登录 Cloudflare Dashboard
进入 Workers & Pages
点击 Create application > Pages > Connect to Git
选择你的仓库

2. 配置构建设置

设置项	值
Framework preset	Astro
Build command	`npm run build`
Build output directory	`dist`
Node.js version	18+

3. 配置环境变量

在项目的 Settings > Environment variables 中添加：

NODE_VERSION=18

4. 部署

点击 Save and Deploy，等待构建完成。

自定义域名

进入项目设置
选择 Custom domains
添加你的域名
按提示配置 DNS 记录

提示
Cloudflare Pages 支持自动 HTTPS 和全球 CDN 加速。

常见问题

构建失败

检查 Node.js 版本是否为 18+
确认构建命令为 npm run build
查看构建日志定位具体错误

页面 404

确认输出目录设置为 dist
检查路由配置是否正确