# Durable Objects

A special kind of Cloudflare Worker combining compute with storage

> Links below point directly to Markdown versions of each page. Any page can also be retrieved as Markdown by sending an `Accept: text/markdown` header to the page's URL without the `index.md` suffix (for example, `curl -H "Accept: text/markdown" https://cloudflaredoc.ubitools.com/durable-objects/`).
>
> For other Cloudflare products, see the [Cloudflare documentation directory](https://cloudflaredoc.ubitools.com/llms.txt).

## Overview

- [Cloudflare Durable Objects](https://cloudflaredoc.ubitools.com/durable-objects/index.md): 使用 Durable Objects 构建有状态无服务器应用，包括 AI agents、实时聊天和协作应用。

## 快速入门

- [快速入门](https://cloudflaredoc.ubitools.com/durable-objects/get-started/index.md): 使用 SQLite 存储和配套 Worker 创建并部署您的第一个 Durable Object。

## REST API

- [REST API](https://cloudflaredoc.ubitools.com/api/resources/durable_objects/subresources/namespaces/methods/list/index.md): 使用 Cloudflare REST API 管理 Durable Objects namespace 和对象。

## 示例

- [示例](https://cloudflaredoc.ubitools.com/durable-objects/examples/index.md): 演示常见 Durable Objects 模式的代码示例，包括计数器、WebSocket 和 alarms。
- [Agents](https://cloudflaredoc.ubitools.com/agents/index.md): 在 Cloudflare 上构建 AI 驱动的 Agents
- [使用 Alarms API](https://cloudflaredoc.ubitools.com/durable-objects/examples/alarms-api/index.md): 使用 Durable Objects Alarms API 批处理对 Durable Object 的请求。
- [构建计数器](https://cloudflaredoc.ubitools.com/durable-objects/examples/build-a-counter/index.md): 使用 Durable Objects 和 Workers 的 RPC 方法构建计数器。
- [Durable Object 内存状态](https://cloudflaredoc.ubitools.com/durable-objects/examples/durable-object-in-memory-state/index.md): 创建一个 Durable Object，在内存中存储上次访问的位置。
- [Durable Object 生存时间](https://cloudflaredoc.ubitools.com/durable-objects/examples/durable-object-ttl/index.md): 使用 Durable Objects Alarms API 为 Durable Object 实例实现生存时间（TTL）。
- [在 Durable Object 和 Workers 中使用 ReadableStream](https://cloudflaredoc.ubitools.com/durable-objects/examples/readable-stream/index.md): 从 Durable Objects 流式传输 ReadableStream。
- [使用 RpcTarget 类处理 Durable Object 元数据](https://cloudflaredoc.ubitools.com/durable-objects/examples/reference-do-name-using-init/index.md): 使用 RpcTarget 从 Durable Object 内部访问名称。
- [测试 Durable Objects](https://cloudflaredoc.ubitools.com/durable-objects/examples/testing-with-durable-objects/index.md): 使用 Workers Vitest 集成为 Durable Objects 编写测试。
- [在 Durable Objects 中使用 Workers KV](https://cloudflaredoc.ubitools.com/durable-objects/examples/use-kv-from-durable-objects/index.md): 在 Durable Object 内读/写 KV
- [使用 WebSocket 休眠构建 WebSocket 服务器](https://cloudflaredoc.ubitools.com/durable-objects/examples/websocket-hibernation-server/index.md): 在 Durable Objects 和 Workers 上使用 WebSocket 休眠构建 WebSocket 服务器
- [构建 WebSocket 服务器](https://cloudflaredoc.ubitools.com/durable-objects/examples/websocket-server/index.md): 使用 Durable Objects 和 Workers 构建 WebSocket 服务器。

## 教程

- [教程](https://cloudflaredoc.ubitools.com/durable-objects/tutorials/index.md): 用于构建真实世界应用的 Durable Objects 分步教程。
- [使用 Durable Objects 中的 SQLite 构建座位预订应用](https://cloudflaredoc.ubitools.com/durable-objects/tutorials/build-a-seat-booking-app/index.md): 本教程展示如何使用 Durable Objects 构建座位预订应用。

## 演示与架构

- [演示与架构](https://cloudflaredoc.ubitools.com/durable-objects/demos/index.md): 探索使用 Durable Objects 的演示应用和参考架构。

## 视频

- [视频](https://cloudflaredoc.ubitools.com/durable-objects/video-tutorials/index.md): 观看关于使用 Durable Objects 构建有状态应用的视频教程。

## 更新日志

- [更新日志](https://cloudflaredoc.ubitools.com/durable-objects/release-notes/index.md): 跟踪 Durable Objects 的最新变更、修复和新功能。

## api

- [Alarms](https://cloudflaredoc.ubitools.com/durable-objects/api/alarms/index.md): 使用 Alarms API 为 Durable Objects 调度未来唤醒，保证至少一次执行。
- [Durable Object 基类](https://cloudflaredoc.ubitools.com/durable-objects/api/base/index.md): DurableObject 抽象基类及其处理程序方法的 API 参考。
- [Durable Object Container](https://cloudflaredoc.ubitools.com/durable-objects/api/container/index.md): 访问和管理与 Durable Object 关联的 container，包括启动、停止和交互方法。
- [Durable Object ID](https://cloudflaredoc.ubitools.com/durable-objects/api/id/index.md): DurableObjectId API 参考，用于寻址 Durable Object 的 64 位十六进制标识符。
- [KV 支持的 Durable Object 存储（旧版）](https://cloudflaredoc.ubitools.com/durable-objects/api/legacy-kv-storage-api/index.md): 旧版 KV 支持的 Durable Objects 存储方法 API 参考，包括 get、put、delete 和 list。
- [Durable Object Namespace](https://cloudflaredoc.ubitools.com/durable-objects/api/namespace/index.md): DurableObjectNamespace API 参考，用于创建 ID 并获取 stub 以与 Durable Objects 交互。
- [SQLite 支持的 Durable Object 存储](https://cloudflaredoc.ubitools.com/durable-objects/api/sqlite-storage-api/index.md): SQLite 支持的 Durable Object 存储 API 参考，包括 SQL API 和键值方法。
- [Durable Object State](https://cloudflaredoc.ubitools.com/durable-objects/api/state/index.md): DurableObjectState API 参考，控制并发、WebSocket 附加和存储访问。
- [Durable Object Stub](https://cloudflaredoc.ubitools.com/durable-objects/api/stub/index.md): DurableObjectStub API 参考，用于调用远程 Durable Object 的 RPC 方法的客户端。
- [WebGPU](https://cloudflaredoc.ubitools.com/durable-objects/api/webgpu/index.md): 在本地开发中从 Durable Objects 内使用 WebGPU API 访问 GPU。

## best-practices

- [访问 Durable Objects 存储](https://cloudflaredoc.ubitools.com/durable-objects/best-practices/access-durable-objects-storage/index.md): 使用 Storage API 在 Durable Object 内或从 Worker 外部读/写持久数据。
- [调用方法](https://cloudflaredoc.ubitools.com/durable-objects/best-practices/create-durable-object-stubs-and-send-requests/index.md): 使用 Worker 中的 stub 调用 RPC 方法或向 Durable Objects 发送 fetch 请求。
- [错误处理](https://cloudflaredoc.ubitools.com/durable-objects/best-practices/error-handling/index.md): 处理来自 Durable Objects 的异常，包括可重试和过载错误，以及推荐模式。
- [Durable Objects 设计准则](https://cloudflaredoc.ubitools.com/durable-objects/best-practices/rules-of-durable-objects/index.md): 构建正确有效的 Durable Objects 应用的设计指南，涵盖何时以及如何使用它们。
- [使用 WebSocket](https://cloudflaredoc.ubitools.com/durable-objects/best-practices/websockets/index.md): 从 Durable Objects 提供 WebSocket 连接，包括标准和休眠 API。

## concepts

- [Durable Object 的生命周期](https://cloudflaredoc.ubitools.com/durable-objects/concepts/durable-object-lifecycle/index.md): 了解 Durable Object 如何创建、激活、处理请求以及最终被驱逐。
- [什么是 Durable Objects？](https://cloudflaredoc.ubitools.com/durable-objects/concepts/what-are-durable-objects/index.md): Durable Objects 在 Cloudflare 上提供全球唯一、单线程的计算实例及持久化存储。

## observability

- [Data Studio](https://cloudflaredoc.ubitools.com/durable-objects/observability/data-studio/index.md): 通过 Cloudflare 仪表板 UI 查看和编辑 SQLite 支持的 Durable Object 存储数据。
- [指标与分析](https://cloudflaredoc.ubitools.com/durable-objects/observability/metrics-and-analytics/index.md): 通过 Cloudflare 仪表板或 GraphQL API 查看 Durable Objects 的 namespace 级和请求级指标、分析和日志。
- [故障排查](https://cloudflaredoc.ubitools.com/durable-objects/observability/troubleshooting/index.md): 使用 wrangler dev 和 wrangler tail 调试 Durable Objects，并解决过载和存储等常见错误。

## platform

- [已知问题](https://cloudflaredoc.ubitools.com/durable-objects/platform/known-issues/index.md): Durable Objects 的已知问题，包括全局唯一性保证、代码更新和开发工具限制。
- [限制](https://cloudflaredoc.ubitools.com/durable-objects/platform/limits/index.md): Free 和 Workers Paid 计划中 Durable Objects 的账户、存储、CPU 和 SQL 限制。
- [定价](https://cloudflaredoc.ubitools.com/durable-objects/platform/pricing/index.md): Durable Objects 计算和存储计费，包括定价示例和免费层限制。
- [选择数据或存储产品](https://cloudflaredoc.ubitools.com/workers/platform/storage-options/index.md): 比较 Cloudflare 存储和数据产品，为您的 Durable Objects 用例找到最佳选项。

## reference

- [数据位置](https://cloudflaredoc.ubitools.com/durable-objects/reference/data-location/index.md): 将 Durable Objects 限制在特定司法管辖区或提供位置提示，以控制数据的存储和处理位置。
- [数据安全](https://cloudflaredoc.ubitools.com/durable-objects/reference/data-security/index.md): Durable Objects 数据安全特性，包括静态加密、传输加密和合规认证。
- [Durable Object 类迁移（旧版）](https://cloudflaredoc.ubitools.com/durable-objects/reference/durable-object-class-migrations-legacy/index.md): 使用旧版 Wrangler `migrations` 数组创建、重命名、删除或转移 Durable Object 类。
- [渐进式部署](https://cloudflaredoc.ubitools.com/workers/versions-and-deployments/gradual-deployments/#gradual-deployments-for-durable-objectsindex.md): 渐进式部署 Durable Objects 变更。
- [Durable Object 类导出](https://cloudflaredoc.ubitools.com/durable-objects/reference/durable-objects-migrations/index.md): 使用 `wrangler.json` 中的声明式 `exports` 字段管理 Durable Object 类生命周期——创建、删除、重命名和转移 Durable Object 类。
- [环境](https://cloudflaredoc.ubitools.com/durable-objects/reference/environments/index.md): 在 Wrangler 环境中配置 Durable Object 绑定，用于 staging、production 和自定义部署。
- [常见问题](https://cloudflaredoc.ubitools.com/durable-objects/reference/faq/index.md): 关于 Durable Objects 定价、限制和指标的常见问题。
- [术语表](https://cloudflaredoc.ubitools.com/durable-objects/reference/glossary/index.md): Cloudflare Durable Objects 文档中使用的关键术语定义。
- [Durable Object 中的内存状态](https://cloudflaredoc.ubitools.com/durable-objects/reference/in-memory-state/index.md): 在 Durable Object 实例的请求之间存储和访问临时内存状态。