python-cloudflare与Cloudflare Workers集成：构建无服务器应用的终极指南

蒋一南

224人浏览 · 2026-07-30 08:50:33

蒋一南 · 2026-07-30 08:50:33 发布

python-cloudflare与Cloudflare Workers集成：构建无服务器应用的终极指南

【免费下载链接】python-cloudflare Python wrapper for the Cloudflare Client API v4 项目地址: https://gitcode.com/gh_mirrors/py/python-cloudflare

python-cloudflare是一个强大的Python库，为Cloudflare Client API v4提供了便捷的包装接口。通过它，开发者可以轻松地与Cloudflare Workers集成，构建高效、可扩展的无服务器应用。本文将详细介绍如何利用python-cloudflare实现与Cloudflare Workers的无缝对接，让你快速掌握无服务器应用开发的关键技巧。

什么是Cloudflare Workers？

Cloudflare Workers是Cloudflare提供的一项无服务器计算服务，它允许开发者在Cloudflare的全球边缘网络上运行代码，无需管理服务器。这意味着你的应用可以在离用户最近的位置执行，从而显著提高响应速度，降低延迟。

python-cloudflare库已经全面支持Cloudflare Workers的API调用，使得通过Python来管理和部署Workers变得异常简单。无论是创建、修改还是删除Workers脚本，都可以通过几行Python代码轻松完成。

快速开始：使用python-cloudflare管理Workers

安装python-cloudflare

要开始使用python-cloudflare，首先需要安装这个库。你可以通过以下命令从Git仓库克隆并安装：

git clone https://gitcode.com/gh_mirrors/py/python-cloudflare
cd python-cloudflare
pip install .

配置认证信息

安装完成后，你需要配置Cloudflare的认证信息。可以通过创建配置文件或者设置环境变量来实现。详细的配置方法可以参考项目中的CloudFlare/read_configs.py文件。

核心功能：python-cloudflare中的Workers API

python-cloudflare提供了丰富的API来管理Cloudflare Workers。这些API主要集中在CloudFlare/api_v4.py文件中，涵盖了从脚本管理到路由配置的各个方面。

主要API端点

以下是一些常用的Workers API端点：

zones_workers: 管理与特定区域相关的Workers资源
accounts/workers/script: 管理账户级别的Workers脚本
accounts/workers/routes: 配置Workers的路由规则
accounts/workers/durable_objects: 管理Durable Objects

这些API为开发者提供了全面的Workers管理能力，无论是简单的脚本部署还是复杂的应用架构，都可以通过python-cloudflare轻松实现。

实战案例：部署和管理Workers脚本

创建并部署Workers脚本

下面我们通过一个实际例子来演示如何使用python-cloudflare部署和管理Workers脚本。这个例子将创建一个简单的脚本，用于修改网页的背景颜色。

首先，创建一个名为modify-body.js的文件，内容如下：

addEventListener("fetch", event => {
  event.respondWith(fetchAndModify(event.request));
});

async function fetchAndModify(request) {
  // 发送请求到源服务器
  const response = await fetch(request);
  
  // 读取响应内容
  const text = await response.text();
  
  // 修改内容：将<body>标签替换为带黄色背景的版本
  const modified = text.replace(
    "<body>",
    "<body style=\"background: #ff0;\">"
  );
  
  // 返回修改后的响应
  return new Response(modified, {
    status: response.status,
    statusText: response.statusText,
    headers: response.headers
  });
}

接下来，使用python-cloudflare的CLI工具cli4来部署这个脚本：

cli4 --put @- /zones/:example.com/workers/script < modify-body.js

这条命令会将脚本部署到指定的Cloudflare区域。部署成功后，你会收到类似以下的响应：

{
  "etag": "1234567890123456789012345678901234567890123456789012345678901234",
  "id": "example-com",
  "modified_on": "2023-07-30T00:00:00.000000Z",
  "script": "addEventListener(\"fetch\", event => {\n  event.respondWith(fetchAndModify(event.request));\n});\n\nasync function fetchAndModify(request) {\n  console.log(\"got a request:\", request);\n\n  // Send the request on to the origin server.\n  const response = await fetch(request);\n\n  // Read response body.\n  const text = await response.text();\n\n  // Modify it.\n  const modified = text.replace(\n  \"<body>\",\n  \"<body style=\\\"background: #ff0;\\\">\");\n\n  // Return modified response.\n  return new Response(modified, {\n    status: response.status,\n    statusText: response.statusText,\n    headers: response.headers\n  });\n}\n",
  "size": 603
}

配置Workers路由

部署脚本后，还需要配置路由规则，指定哪些请求应该由这个Workers脚本处理：

cli4 --post pattern="example.com/*" script="example-com" /zones/:example.com/workers/routes

这条命令会创建一个路由规则，将所有发往example.com的请求都交由刚刚部署的example-com脚本处理。

验证部署结果

现在，你可以通过curl命令来验证部署是否成功：

curl -sS https://example.com/ | fgrep '<body'

如果一切正常，你应该会看到类似以下的输出：

  <body style="background: #ff0;">

这表明Workers脚本已经成功运行，并修改了网页的背景颜色。

管理和删除Workers脚本

使用python-cloudflare，你还可以轻松地管理和删除已部署的Workers脚本。例如，要查看当前账户下的所有Workers脚本，可以使用：

cli4 /user/workers/scripts

要删除一个脚本，可以使用：

cli4 --delete /zones/:example.com/workers/script

同时，别忘了删除相关的路由规则：

cli4 --delete /zones/:example.com/workers/routes/:route_id

高级应用：利用python-cloudflare构建复杂Workers应用

除了基本的脚本部署和管理，python-cloudflare还支持更高级的Workers功能，如Durable Objects、Queues等。这些功能可以帮助你构建更复杂、更强大的无服务器应用。

Durable Objects支持

Durable Objects是Cloudflare提供的一种持久化存储解决方案，特别适合构建需要状态管理的无服务器应用。python-cloudflare通过CloudFlare/api_v4.py中的accounts/workers/durable_objects/namespaces端点提供了对Durable Objects的全面支持。