01 · 介绍
Cloudflare 是什么
Cloudflare 运营着一个庞大的服务器网络,遍布数百个城市。当有人打开你的网站时,他们会先连接到离自己最近的 Cloudflare 服务器,由 Cloudflare 提供页面,或将请求转发出去。
对初学者来说,它主要承担两项工作:
- 管理你的域名。 它负责管理你的域名记录(DNS:一本“通讯录”,记录
yourname.com指向何处),免费为你提供 HTTPS,并拦截大部分攻击和机器人。 - 运行你的网站。 借助 Workers,你的网站代码运行在 Cloudflare 的网络上,因此你无需租用服务器,流量较少时也无需付费。
你会遇到的一些术语:
- Workers:你的网站代码运行的地方。每个项目就是一个 Worker。你会获得一个免费地址,例如
name.your-account.workers.dev。 - D1:Cloudflare 上的数据库(SQLite),Workers 用它来存储用户、订单和文章。
- R2:用于存储图片和上传文件的文件存储。
- Pages:用于托管静态网站。对于包含登录和支付功能的网站,通常选择 Workers。
- Wrangler:Cloudflare 的命令行工具。智能体使用它来创建数据库和部署。
02 · 适合什么场景
何时使用
- 你想要一个网站,但不想管理服务器。 Workers + D1 就能运行完整的网站(页面、登录、支付、后台管理),无需打补丁,也无需重启。
- 你买了域名,希望免费获得 HTTPS、全球快速加载,以及防机器人保护。
- 一个业余项目或第一个产品,希望在真正有人使用之前不花一分钱。
- 许多小型网站。 每一个都只是同一账户下的另一个 Worker。
如果你的代码需要长期运行的进程、大型传统数据库,或者每次请求都要进行大量计算,那么它就不太适合。这些仍然应该部署在普通服务器上。
03 · 配置
如何设置
- 创建账户,前往 dash.cloudflare.com。账户免费,只需要一个邮箱。
- 添加你的域名(可选)。 你可以在 Cloudflare 内直接购买域名(Domain Registration),也可以添加你在其他地方拥有的域名:Cloudflare 会给出两个 nameservers(域名服务器),你需要在购买域名的公司那里把旧的域名服务器替换掉。通常一小时内生效。
- 让你的电脑为你部署。 安装 Node.js,然后运行
npx wrangler login。浏览器页面会自动打开;如果你已经登录了 Cloudflare,只需点击 Allow(允许)。
这就是智能体所需的全部准备。之后你只需说“把这个部署到带有 D1 数据库的 Cloudflare Workers 上”,它就会自己运行 Wrangler 命令。
04 · 部署
将网站部署到 Workers
使用智能体部署,只需一句话:“部署到 Cloudflare Workers,使用 D1”。背后,智能体会完成以下步骤:
- 创建 D1 数据库(
wrangler d1 create <name>)及其数据表, - 构建网站并上传(
wrangler deploy), - 为你提供
*.workers.dev地址。
若要使用自己的域名:在 Cloudflare 控制台中依次打开 Workers & Pages → 你的 Worker → Settings → Domains & Routes → Add → Custom Domain,然后输入域名。该域名必须已经添加到你的 Cloudflare 账户中。HTTPS 会自动配置。
在创建 D1 数据库之前,请以你的域名来命名(例如 mysite.com → mysite):D1 数据库之后无法重命名。
05 · 使用说明
日常使用
- 更新网站: 修改代码,然后重新部署(或者告诉智能体“重新部署”)。新版本几秒钟内即可上线。
- 查看发生了什么: 进入 Workers & Pages,选择你的 Worker,再打开 Logs,即可看到错误和请求记录。把错误信息粘贴给智能体,它就能帮你修复。
- 查看数据: 进入 Storage & Databases → D1,可以在浏览器中浏览数据表并运行 SQL。
- 回滚: Worker 的 Deployments 标签页列出了每个版本,你可以切换回较早的版本。
- 定时任务: Worker 可以按计时器运行(Cron Triggers),例如每晚清理数据或生成每日报告。
06 · 注意事项
注意事项
- 免费额度。 免费套餐每天包含 100,000 次 Worker 请求,对于 D1,每天包含 100,000 行写入。如果写入额度用完,网站仍会显示页面,但注册和下单会失败。流量增长后,Workers Paid 每月 5 美元(需用银行卡支付),并会提高所有额度。
- D1 名称不可更改。 创建前请先想好名称。
- 密钥不是普通设置。 API 密钥应通过 secrets(
wrangler secret put)写入,切勿放在配置文件中公开的vars里。 - 上传大小。 单个 Worker 最大只能有几十 MB。大文件(视频、大量图片)应放在 R2 中,而不是放进代码里。
- 迁移 DNS 也会影响邮件。 将域名迁移到 Cloudflare 时,请检查其邮件记录(MX)是否已一并迁移,否则发往该域名的邮件会中断。
07 · 资源
链接
我的笔记
登录后可以在这本手册上记私人笔记。登录
