跳到正文
ELURA/ ONLINE RUNTIME

驱动游戏背后的在线世界

一套 Rust 游戏服务器框架:从网络协议到业务 Handler 全程类型安全,只在需要时扩展基础设施。

从生成一个应用开始

你不需要先理解 Elura 的每个 Crate。先生成并运行应用,再一边修改真实代码, 一边理解各个组件:

bash
cargo install elura-cli
mkdir my-game && cd my-game
elura init all --dir .

生成器会创建可编辑的应用代码、本地配置、Docker 文件和 Kubernetes Manifest。 继续阅读 10 分钟快速开始,配置开发密钥并启动两个进程。

先记住这一张图

text
玩家客户端 ──> Gateway ──> World ──> 你的类型化 Handler
               会话与认证    路由       游戏规则
  • Gateway 负责公网连接、认证、会话和路由。
  • World 执行已认证的游戏命令和中间件。
  • 你的应用 负责业务路由、游戏规则、配置、持久化和部署选择。

无论是在本地、单体进程还是多个 Kubernetes 节点中运行,这个边界都不会改变。 需要完整背景时,再阅读架构概览

选择下一步

我想要……从这里开始
第一次运行 Elura快速开始
不使用 CLI 在一个进程运行 Gateway 与 World手动单体搭建
不使用 CLI 拆分 Gateway 与 World手动拆分搭建
组装共享状态与动态发现手动分布式搭建
添加第一个游戏命令World 模块与路由
构建实时房间、AOI、预测或实体状态同步实时游戏开发
添加 TCP、UDP、WebSocket、WebTransport、QUIC 或自定义客户端端点客户端传输
添加 Axum HTTP API 或回调端点应用 HTTP 服务
连接 Rust、C++ 或 C# 客户端客户端 SDK
看懂生成的文件生成的项目
选择 Redis、SQL、DNS、Kubernetes 或自定义后端Adapters
接入登录、OTP、短信或支付Providers
准备生产发布生产检查清单

项目状态

当前文档版本为 v0.3.1,本站跟踪 main 分支能力。官方 Rust、 C++20 和 C# / Unity SDK 分别由独立 GitHub 仓库维护,不再由 CLI 生成。 项目尚未进入 1.0:生产环境应锁定精确版本,并在升级前检查 Release Notes 与兼容性。

基于 MIT 许可证发布。