Cloudflare cf 使用入门：安装授权、AI 部署与迁移注意事项

曲速指南2026-10-01发布 WarpEdit

Cloudflare cf 是操作 Cloudflare API 和 Workers 项目的命令行工具，能让可执行命令的 AI 助手衔接网站部署、DNS 和资源管理。它仍处于 Beta；开始前需要 Cloudflare 账号、Node.js 22.18 或更新版本及本人登录授权。已经用 AI 做好小网站的人可以先了解这条流程，正式上线仍要检查项目适配、权限和费用。

cf 与 AI 各做什么

Cloudflare 提供网站运行、域名解析、存储和安全等服务。cf 是操作这些服务的命令行工具。AI 助手则负责理解你的要求、寻找命令，并在获得权限后调用它。

也就是说，你说“帮我把这个作品集上线”，AI 需要先看懂项目，再借助 cf 操作 Cloudflare。cf 本身不是一个聊天机器人，也不会让任意 AI 聊天窗口自动获得部署能力。

Cloudflare 在 2026 年 9 月 28 日宣布 cf 开放 Beta。官方公告称，它覆盖超过 3,000 项 API 操作；当前文档则写明有超过 2,900 条命令。API 操作数和命令数是两个口径，不宜混为一个数字。

能力覆盖的范围包括：

网站和应用：创建、开发和部署 Workers 项目；Workers 是在 Cloudflare 平台运行网站和程序的一种服务。
域名解析：查看和管理 DNS 记录，也就是域名该指向哪里。
数据与安全：管理存储、数据库及相关安全设置。

这里的价值，在于 AI 可以通过一个较统一的入口，衔接原本分散的操作。至于某项操作能否执行，还取决于账号权限、具体服务条件和项目是否适配。

Cloudflare 官方文档的工具定位与 Beta 说明 — 来源：Cloudflare CLI 官方文档，2026 年 10 月 1 日截图。Beta 期间命令和配置仍可能变化。

从本地到上线

想象你用 AI 做好了一个作品集。页面里有图片、介绍和联系方式，本地已经能打开。接下来，你希望它有一个可以分享的地址。

从本地网页到上线链接的假设流程 — 假设场景：AI 整理方案，你确认后再部署并检查。AI 生成示意图，不是本文的部署实测。

一个合理的协作过程是：

先检查项目：确认它是静态网页，还是需要后台程序、数据库的应用。
列出上线方案：用哪项服务、部署到哪个账号、使用什么地址，是否涉及付费。
你确认后部署：AI 调用相应命令，提交文件和配置。
打开网址验收：检查页面、图片和功能，再决定是否绑定正式域名。

这些是建议的工作步骤，不代表本文已替你完成过部署。官方公告确实介绍了静态网站的部署入口 cf deploy，但“有一个部署命令”不等于任何项目都能原样运行。

如果项目依赖传统服务器环境，或者有数据库、上传、登录等功能，AI 还要检查兼容性和配置。cf 能帮助执行 Cloudflare 的操作，不能替代这一步判断。

给 AI 的要求，最好包含验收标准

比起只说“帮我上线”，可以这样表达：

请先检查这个网站是否适合部署到 Cloudflare，说明需要哪些服务、权限和费用。先给我看部署方案和检查结果，确认后再上线。不要购买域名、覆盖已有网站或删除资源。完成后给我访问地址，并检查图片和链接是否正常。

这段话是一个任务要求示例，可以按自己的项目调整。它的作用是把“做完”的标准说清楚，也让涉及费用和已有资源的决定留在你手里。

安装与账号授权

让 AI 帮忙操作之前，需要先准备好运行环境和账号权限。官方入门文档列出的前提是：Cloudflare 账号、Node.js 22.18 或更新版本，以及登录授权。

Node.js 是运行这个工具所需的软件环境。官方当前不支持用 Bun 运行 cf：涉及 cloudflare.config.ts 的命令会失败。如果你还没用过终端，不必把这篇理解成“所有人照抄就能完成”的教程，可以先了解流程，再让熟悉环境的人协助。

官方安装命令是：

npm install --global cf

安装后检查命令是否可用：

cf --version

它应显示版本号；若提示找不到命令，先检查 Node.js 环境和终端 PATH。登录使用：

cf auth login

这一步会打开浏览器，让你批准访问自己的 Cloudflare 账号。官方给 AI 助手的文档也明确要求，这个批准步骤由用户本人完成。之后用下面的命令检查登录状态：

cf auth whoami
cf zones list

先核对 whoami 返回的身份与预期账号是否一致，再查看 zones list 返回的可访问区域 JSON。没有域名区域时可能返回空数组；这不等于登录失败。身份正确、查询正常后，才算完成安装与账号准备。

Cloudflare 官方入门文档的登录说明 — 来源：Cloudflare CLI 官方入门文档，2026 年 10 月 1 日截图。授权前确认账号和访问范围。

还要注意两个容易忽略的细节：

cf 使用自己的登录凭证，不会直接复用 Wrangler 的登录。
安装包提供 cf 和 cloudflare 两个等价命令；如果电脑上已有另一个叫 cf 的工具，可以使用后者避免冲突。

无人值守的自动化通常需要 API Token。官方建议只授予任务所需的权限。Token 相当于访问凭证，不应直接贴进文章、公开仓库或普通聊天内容里。

搜索命令与预演

cf 面向 AI 的一个设计，是允许它按任务搜索命令。例如官方文档给出的：

cf cli search "create a DNS record"

这条命令在本地搜索，不需要登录凭证，会返回最多五个匹配结果。AI 可以先找到候选命令，再查看参数说明，减少凭记忆猜命令的情况。

结果默认以 JSON 这类结构化数据返回，便于程序提取字段。对普通使用者来说，更容易理解的好处是：AI 可以把返回的信息整理成你看得懂的说明，而不是要求你自己逐行读终端输出。

但工具更好调用，并不代表 AI 不会选错账号、域名或操作。把事情交给它之前，建议区分这三类任务：

要做的事	建议的授权方式
查看域名、配置和状态	先从查询开始
新建测试项目、部署页面	先看方案，再确认执行
删除资源、改正式域名、购买服务	明确对象、影响和费用后单独确认

查询、修改与高影响操作的权限区分 — 这是本文建议的协作方式，不是 cf 自带的三档权限开关。AI 生成示意图。

官方文档还提供了预演能力：例如生成的 API 命令可用 –dry-run 查看请求而不发送；cf deploy –dry-run 会构建并验证项目，但不上传。预演有助于检查准备执行什么，不能保证正式运行一定成功，也不代表本地文件完全不会变化。

别让 AI 遇到阻碍就随手加上 –force。官方提醒，有些命令里的这个参数会改变删除行为，可能影响被其他项目引用的资源。

费用与旧项目迁移

装好工具，不等于后续服务全免费

Cloudflare 的不同服务有自己的套餐和用量规则。以 Workers 为例，官方提供 Free 方案；Paid 方案的账号最低费用为每月 5 美元，超出所含用量还可能继续计费。

因此，不宜把“有免费方案”理解成“AI 可以随意创建任何服务”。如果项目还涉及存储、数据库或域名，需要分别核对条件。你使用的 AI 助手本身，也可能有订阅或调用费用。

第一次尝试时，我更建议从一个不含敏感资料的小页面开始，先确认服务选择、使用限制和访问效果，再决定是否迁移正式网站。

已经用 Wrangler 的项目，别直接换命令

Wrangler 是 Cloudflare 原有的开发工具。cf 的覆盖范围更广，但现有项目不应因此直接把所有命令替换成 cf。

官方文档提醒：如果项目仍使用 wrangler.jsonc、wrangler.json 或 wrangler.toml 配置，未迁移前不要直接运行 cf dev、cf build 或 cf deploy。它们可能生成忽略旧设置的新配置，或者运行失败。

迁移前还要检查项目条件：安装项目依赖；使用 Wrangler bundler 时，需要 Wrangler 4.136.0 或更新版本；Git 仓库中的已跟踪和未跟踪改动应先提交或暂存，否则正式迁移会停止写文件。不要为跳过这项检查直接加 –force。

如果确实要迁移，先备份项目，再用 cf migrate –dry-run 查看将生成什么。确认后运行 cf migrate，并处理 cloudflare.config.ts 中的 TODO(@cloudflare) 项；必需项目未解决时，构建会失败。查资源的 cf 命令可以和旧项目并存，项目的构建与部署则需要另外判断。

截至本文核查时，cf 仍处于 Beta，命令、配置和构建输出可能调整。对新测试项目，可以尝试；对已经稳定运行的网站，更合适的做法是先在副本里验证。

我认为 cf 值得关注的地方，是它把“AI 做出一个页面”和“把页面放到网上”之间的操作衔接得更完整。对于完全不碰网站和 Cloudflare 的人，目前没必要专门安装；已经在用 AI 做作品集、小工具或活动页面的人，可以先从一次范围明确的测试部署了解它。