Orleans是微软开源的.NET分布式框架，以“虚拟Actor”简化开发：本地双控制台即可运行Hello World集群，定义继承Grain的接口类实现远程调用，客户端通过GetGrain获取句柄像调用本地对象一样await执行，框架自动激活、路由、回收Grain实例。
Orleans 是
微软
开源的 .NET 分布式框架，核心思想是用“虚拟 Actor”简化分布式系统开发——你不用管实例在哪、是否存活、如何扩缩容，框架自动帮你调度、激活、回收。入门关键不是学一堆概念，而是跑通一个最简可运行的“Hello World”集群，并理解它怎么把代码变成跨进程/跨机器的自动伸缩服务。
1. 从一个控制台项目开始（无 Azure，无 Docker）
新手最容易卡在环境搭建。Orleans 不强制依赖云或容器，本地两个控制台程序就能模拟集群：
建一个
SiloHost
项目（服务端），引用
和
建一个
ClientApp
项目（客户端），引用
Silo 启动时监听本地端口（如
），Client 连这个地址即可通信——不需要配置 ZooKeeper 或 Redis 做集群协调，内存版集群（
）默认可用
2. 定义你的第一个 Grain（Actor）
Grain 是 Orleans 的核心单元，本质是一个有唯一 ID、带状态、可远程调用的类。它不是普通类，必须遵守几条轻量约束：
继承
，实现一个接口（如
），接口需标记
（.NET 6+ 可用源生成器省略）
方法必须是
，不能有同步阻塞调用
状态存在
（默认内存，上线后建议配 SQL Server 或 Azure Table）
示例：一个计数器 Grain，每次调用
就自增并返回问候语 + 当前次数
3. 调用 Grain 就像调用本地对象
Client 不需要知道 Grain 在哪个进程、哪台机器上。你只拿一个泛型句柄：
，然后直接 await 调用：
Docker Sandbox
创建并管理 Docker 沙箱虚拟机环境以安全执行代理。适用于运行不受信任代码、探索包或隔离代理工作负载。支持 Claude、Codex、Copilot、Gemini 和 Kiro 代理，并提供网络代理控制。
下载
就算这个 Grain 当前没运行，Orleans 会在第一次调用时自动激活；闲置超时后自动回收——你写的代码里完全不感知生命周期。
4. 理解“虚拟”二字的关键：无固定实例、无手动部署
传统 Actor（如 Akka.NET）要求你显式创建、管理 Actor 实例；Orleans 的 Grain 是“虚拟”的：
没有
，只有通过
获取逻辑句柄
ID 是字符串或 Guid，决定
路由
和一致性哈希——相同 ID 总被路由到同一个（可能迁移过的）Grain 实例
加一台新 Silo？Orleans 自动重新分片、迁移部分 Grain，业务代码零修改
基本上就这些。跑通本地双进程 demo 后，再逐步加上持久化、集群发现（如使用 Azure Storage 或 Consul）、监控（集成 OpenTelemetry）就自然顺下来了。不复杂但容易忽略的是：别急着写业务逻辑，先确保你能看到 Grain 被激活、调用、销毁的日志（开启
日志级别为 Debug）。
Microsoft.Orleans.HostingMicrosoft.Orleans.ServerMicrosoft.Orleans.Client11111LocalhostClusteringGrainIHelloGrain[GenerateSerializer]public async TaskGrainStorageSayHello(name)var grain = client.GetGrain("user123"); string result = await grain.SayHello("Alice"); // 框架自动激活 Grain、路由请求、序列化结果new HelloGrain()client.GetGrain(id) Microsoft.Orleans.Runtime