Cloudflare Pages 是一项完全免费的静态网站托管服务,部署成功后会为你分配一个 *.pages.dev 的免费二级域名 。以下是完整的操作步骤。
一、注册 Cloudflare 账号
-
点击注册,填写邮箱和密码完成账号创建
-
登录后进入 Cloudflare 仪表盘
二、准备网站源码
你需要有一个准备部署的网站项目。可以是你自己写的静态 HTML 网站,也可以是用 React、Vue、Next.js、Hugo、Hexo 等框架生成的项目。
注意:Cloudflare Pages 免费版单个站点最多可包含 20,000 个文件。
三、将代码上传到 GitHub
Cloudflare Pages 支持直接从 GitHub 仓库部署。
-
打开 GitHub 并登录
-
点击右上角“+”→“New repository”新建代码仓库
-
填写仓库名称(建议选 Private 私密模式,防止代码被公开)
-
在本地项目根目录执行 Git 命令将代码推送到 GitHub
四、在 Cloudflare Pages 创建项目
-
登录 Cloudflare 仪表盘,在左侧菜单找到 “计算” 分类,点击 Pages(或直接点击 Workers & Pages)
-
点击 创建应用程序 → 选择 Pages 标签 → 点击 导入现有 Git 仓库
-
连接你的 GitHub 账号,授权 Cloudflare 访问仓库
-
选择刚才上传的 GitHub 仓库,点击 开始设置
⚠️ 注意:如果找不到你的仓库,可能是因为设置了私密模式。点击“去 GitHub 上为 Cloudflare Page 应用配置仓库访问权限”,在 GitHub 授权页面选择你的仓库并保存即可。
五、配置构建设置
-
项目名称:输入一个名称(如
my-portfolio),这将决定你的最终域名 ——https://my-portfolio.pages.dev -
生产分支:通常保持默认的
main或master -
构建设置:
-
如果使用框架(如 Next.js、Vue 等),在 框架预设 中选择对应的框架,系统会自动填入构建命令和输出目录
-
如果是纯静态 HTML 网站,构建命令填
exit 0,构建输出目录填你的网站文件所在目录(如.或public)
-
-
点击 保存并部署
六、等待部署完成
Cloudflare Pages 会自动拉取代码、安装依赖、执行构建并部署。部署过程通常只需要 1-2 分钟。
部署成功后,你会看到一个 https://<你的项目名>.pages.dev 的链接—— 这就是你免费获得的 .pages.dev 域名!
点击链接即可访问你的网站。如果首次访问报错,可能是因为 SSL 证书还在签发中,等待 5-10 分钟再刷新就好了。
七、自动部署(CI/CD)
Cloudflare Pages 的一大优势是 自动部署。以后每次你推送新代码到 GitHub 仓库,Cloudflare Pages 都会自动重新构建并部署你的网站。每次新提交都会触发一次构建,免费版每月有 500 次构建额度。
常见问题
1. 访问 .pages.dev 域名出现 404 错误?
确保你的网站根目录下有一个 index.html 文件,这是 Pages 默认访问的入口文件。
2. 可以绑定自己的域名吗?
可以。在项目页面点击 自定义域 → 设置自定义域,按提示添加你的域名并配置 CNAME 记录指向 <你的项目>.pages.dev 即可。
3. 免费版有哪些限制?
-
每月构建次数:500 次
-
并发构建:每次 1 个
-
站点文件数:最多 20,000 个文件
-
带宽:无限免费带宽
-
站点数量:可创建多达 100 个项目
-
Workers 请求:每天 100,000 次
4. 国内访问速度怎么样?
Cloudflare 拥有全球 CDN 网络,在国内访问速度相比 GitHub Pages 有明显优势。但由于网络环境差异,部分地区访问 .pages.dev 域名可能不稳定,建议绑定自己的域名以获得更稳定的访问体验。