cf有两个好东西,pages,workers。pages托管网站,workers托管无服务器代码,而wrangler负责开发、构建、部署到cf边缘节点。当然你也可以用cf管理后台手动部署,这里可以通过wrangler命令工具集成到ci/cd平台,实现手动触发部署/自动化部署。当然wrangler只是一个选择,其它自动化部署的方式还有很多,本文只讲wrangler。
一、什么是wrangler?
wrangler是cloudflare专门为workers开发的命令行工具,主要用来构建、部署、本地运行workers,也可以适用于cloudflare pages
二、安装
1 | pnpm add -g wrangler |
其它方式:wrangler安装与更新
三、使用
3.1 授权cf帐户
1 | wrangler login |
3.2 添加wrangler.toml
在pages项目根目录添加wrangler.toml,这样在pages项目执行deploy命令时会自动检测文件的配置,并且不会进入交互式询问(更加方便shell调用),下面是示例
1 | name = "muqiuren" |
上面分别设置了:
- name: 对应pages站点的名称,例如[name].pages.dev
- pages_build_output_dir: 项目构建结果的输出目录
- compatibility_date: 使用哪个版本的workers运行,如果你的pages不需要workers,那这里随便添加即可,格式需为:YYYY-MM-DD
3.3 部署
如果你的本地pages开发目录有git管理,–commit-dirty=true允许你部署未提交的commit
1 | wrangler pages depoly --commit-dirty=true |
不出意外的话,你将看到下面类似的输出信息

四、参考链接
- 本文作者: 暮秋人
- 本文链接: https://muqiuren.pages.dev/2025/05/cloudflare-pages-wrangler/
- 版权声明: 本博客所有文章除特别声明外,均采用 MIT 许可协议。转载请注明出处!