Durable Actors 开源:提供无厂商锁定的持久化对象与可配置算力
原标题:Show HN: Durable Actors – OSS Durable Objects with configurable compute
68AI 研判分
Durable Actors 发布为 Cloudflare Durable Objects 的开源替代方案,支持可配置计算资源且无厂商锁定。该工具通过定义具有持久状态和串行执行能力的 Actor,简化了实时聊天、协作工具及智能体集群等分布式应用的构建,内置内存限制与可观测性功能。
报道正文
本文目录6 个章节
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...