Python Workers

Cloudflare Workers 提供一流的 Python 体验，包括支持：

• 易于安装且快速启动的包（Packages），包括 FastAPI ↗、Langchain ↗、Pydantic ↗ 等。
• 强大的外部函数接口（FFI），让你可以直接从 Python 使用 JavaScript 对象和函数——包括所有运行时 API
• 通过绑定（binding） 访问 Workers 平台上的服务生态系统，包括：
  • 状态存储和数据库，如 KV、D1、Durable Objects
  • 访问环境变量、Secrets 以及通过 Service Bindings 访问其他 Workers
  • 使用 Workers AI、Vectorize 的 AI 能力
  • 使用 R2 进行文件存储
  • Durable Workflows、Queues 等

Python Worker 可以简单到只有四行代码：

from workers import WorkerEntrypoint, Response

class Default(WorkerEntrypoint):
    async def fetch(self, request):
        return Response("Hello World!")

与其他 Worker 类似，Python Worker 的主入口点是 fetch 处理器，它处理发送到 Worker 的传入请求。

在 Python Worker 中，此处理器放在继承 WorkerEntrypoint 类的 Default 类中（可从 workers SDK 模块导入）。

要在本地运行 Python Worker、安装包并将其部署到 Cloudflare，请使用 pywrangler ↗，Python Workers 的 CLI。

要设置它，首先确保已安装 uv ↗ 和 Node ↗。

然后设置开发环境：

uvx --from workers-py pywrangler init

这将创建一个 pyproject.toml 文件，将 workers-py 作为开发依赖。pywrangler init 会创建 wrangler 配置文件。然后你可以运行 pywrangler：

uv run pywrangler dev

要将 Python Worker 部署到 Cloudflare，运行 pywrangler deploy：

uv run pywrangler deploy

初始化新的 Python Worker 项目时，可以从众多模板中选择：

uv run pywrangler init

或者克隆示例仓库以探索更多选项：

git clone https://github.com/cloudflare/python-workers-examples
cd python-workers-examples/01-hello

• 了解更多关于 Python Workers 基础 的内容
• 了解本地开发、部署以及 Python Workers 的工作原理 的详情
• 探索包（Packages） 文档，了解如何在 Python Workers 中使用包
• 了解 Python Workers 中支持 Python 标准库 的哪些部分
• 了解 Python Workers 的外部函数接口（FFI），以及如何使用它处理绑定（binding）和运行时 API