Durable Actors: OSS Alternative to Cloudflare Durable Objects
Durable Actors launches as an open-source alternative to Cloudflare Durable Objects, offering configurable compute and no vendor lock-in. By defining Actors with durable state and serialized execution, it simplifies building distributed apps like chat systems and agent swarms, featuring built-in memory limits and observability.
Related Entities
Full Report
Contents6 sections
Cloudflare Durable Objects 的开源替代方案……无供应商锁定、无内存限制,并内置可观测性。
Durable Actors 助你构建实时应用,例如聊天系统(如 ChatGPT、Codex)、协作工具(如 Notion)以及智能体集群(如 Devin)。
它们提供 有状态的 Serverless 函数,这是一种基础构建块,抽象了分布式系统中的持久化、协调和基础设施挑战。
在线演示 · TypeScript 文档 · Python 文档
工作原理
- 定义一个 actor,它是一个类,具备 durable state(即数据在中断、错误和重启后依然存活)和 serialized execution(即并发调用者可以安全地更新它)。 例如:
- 如果你正在构建 ChatGPT... 一个聊天 actor 可以存储对话记录,即使 LLM 不稳定或服务器崩溃也能保留数据(durable state)
- 如果你正在构建 Notion... 一个文档 actor 可以协调来自多人和多个 agent 的并发编辑(serialized execution)
- 使用 Durable Actors SDK 自动生成类型安全的客户端。目前支持 Python 和 TypeScript。
- 通过一条命令进行本地开发,随后可以 在 GCP 上自托管 Durable Actors 运行时。
快速开始:多人 AI 聊天

1. 创建项目
安装 Node.js 22.19+ 和 Bun 1.3.9+。
npx durable-actors init my-actors
cd my-actors
npm install
npx durable-actors dev # 在你的机器上本地运行服务器2. 定义一个 actor
在你的 actor 项目的 src/actors.ts 中定义并导出 actors,这是 durable-actors dev 加载的默认入口点。运行时按需加载 actors,并持久化标记为 @Persisted 的字段。
例如,一个聊天记录 actor:
import { openai } from "@ai-sdk/openai"
import { streamText } from "ai"
import { Actor, type ActorSocket, Interleave, Persisted } from "durable-actors"
type Message = { role: "user" | "assistant"; content: string }
export class ChatHistory extends Actor<null, string, Message[]> {
@Persisted messages: Message[] = []
async onConnect(socket: ActorSocket<null, Message[]>) {
socket.send(this.messages)
}
@Interleave // 在 await 期间允许其他调用运行,例如在回复流式传输时处理新连接。
async onMessage(_socket: ActorSocket<null, Message[]>, text: string) {
this.messages.push({ role: "user", content: text })
const result = streamText({ model: openai("gpt-5-mini"), messages: [...this.messages] })
const reply: Message = { role: "assistant", content: "" }
this.messages.push(reply)
this.broadcast(this.messages)
for await (const chunk of result.textStream) {
reply.content += chunk
this.broadcast(this.messages)
}
}
}3. 连接你的后端
我们让将 actors 集成到你现有的技术栈中变得极其简单。只需生成客户端,即可获得一个完全类型安全的交互契约。
npx durable-actors generate创建一个 WebSocket 连接到共享聊天室:
import express from "express"
import { actors } from "../generated/index.js"
export const app = express()
app.post("/api/chat/socket", async (_req, res) => {
const grant = await actors.ChatHistory.prepareWebsocket({
actorId: "lobby",
metadata: null
})
res.set("Cache-Control", "no-store").json(grant)
})4. 连接前端
import { useEffect, useRef, useState } from "react"
import { createRoot } from "react-dom/client"
import type { actors } from "../generated/index.js"
function Chat() {
const socket = useRef<WebSocket>(null)
const [messages, setMessages] = useState<actors.ChatHistory.Outgoing>([])
useEffect(() => {
let active = true
async function connect() {
const response = await fetch("/api/chat/socket", { method: "POST" })
const { websocketUrl } = await response.json()
if (!active) return
socket.current = new WebSocket(websocketUrl)
socket.current.onmessage = event => setMessages(JSON.parse(event.data))
}
void connect()
return () => {
active = false
socket.current?.close()
}
}, [])
function send(form: FormData) {
const text = String(form.get("message")).trim()
if (!text || socket.current?.readyState !== WebSocket.OPEN) return
socket.current.send(JSON.stringify(text))
}
<main>
<div role="log" aria-label="Messages">
{messages.map((message, index) => (
<p key={index}><strong>{message.role}:</strong> {message.content}</p>
))}
</div>
<form action={send}>
<input name="message" aria-label="Message" required />
<button>Send</button>
</form>
</main>
)}
createRoot(document.getElementById("root")!).render(<Chat />)
如需包含错误处理和重试机制的完整应用,请参阅 [AI Chat 示例](/ai-chat)。
### 5. 监控与调试
Durable Agents 提供了内置的可观测性功能:

## 示例
如需完整的示例应用程序,请参阅 [AI Chat](/ai-chat)、[协作文档](/documents) 和 [聊天室](/chat)。
## 社区
欢迎提交 Bug 报告、功能请求、文档修正以及代码贡献。有关仓库设置和检查项,请参阅 [贡献指南](CONTRIBUTING.md),并遵守我们的 [行为准则](CODE_OF_CONDUCT.md)。
请使用 [GitHub Issues](https://github.com/TerseAI/durable-actors/issues) 反馈 Bug、想法和问题。请通过我们的 [安全政策](SECURITY.md) 私下报告漏洞。
在 [GitHub Releases](https://github.com/TerseAI/durable-actors/releases) 上关注开发进展和发布说明。
---
**作者发帖说明(HN)**:
大家好,我是来自 Terse ([https://www.useterse.ai/](https://www.useterse.ai/)) 的 Thomas 和 Olivier。我们构建了 Durable Actors,这是 Cloudflare Durable Objects 的一个开源替代方案。
Durable Object/Actor 是一个微型服务器,每次只处理一个请求,并拥有自己的 SQLite 数据库。世界上每个这样的对象都是唯一的,并通过名称进行寻址。
这是部署多人智能体(agents)的理想基础组件。每个智能体可以拥有自己的 Durable Actor,每个用户都可以通过 websocket 连接到该 Actor。这实现了完全的横向扩展。用户可以随意部署和共享智能体,而不会给中央数据库或 websocket 服务器带来压力。
Durable Actors 也非常适合协调系统内的多个智能体。由于每次只处理一个请求,你可以保护诸如 CRM 等关键数据,并允许多个智能体并发运行,而无需担心数据竞争问题。
唯一的替代方案是 Cloudflare 的 Durable Objects。然而,它存在严重的供应商锁定问题(会将你绑定到 D1、R2 + Workers 生态系统中),而且五年前发布时并非专为智能体工作负载设计。
基于 Durable Objects 构建的一些知名项目包括 RampInspect、OpenInspect,以及多人协作框架 Liveblocks 和 PartyKit。现在你可以使用 Durable Actors 来构建此类项目。
Durable Actors 是一个专为并发智能体工作负载设计的 DO 版本。它完全开源(采用 MIT 许可证),并包含一个 Helm chart f...