> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/contributor/contributor-zh/jia-gou/services.md).

# 后端服务

本页全面概述了所有 Decentraland 后端服务、它们的架构角色，以及它们在生态系统中的交互方式。有关详细的 API 规范和端点，请参阅 [API 参考](https://github.com/decentraland/docs/blob/main/apis/README.md) 部分。

## 服务架构

Decentraland 的后端由分布式微服务组成，并按逻辑层组织：

* **去中心化层** - Catalyst 网络和内容分发基础设施
* **实时通信层** - 服务发现和点对点通信
* **功能服务** - 面向用户的功能（内容、经济、游戏化）
* **核心服务** - 基础平台基础设施（认证、市场、通知）

***

## 去中心化层

### Catalyst

**目的**：去中心化内容分发网络

Catalyst 网络构成了 Decentraland 内容基础设施的基础。每个 Catalyst 节点都是一个完整的服务器，提供：

* **内容服务器** - 实体存储和检索（场景、资料、穿戴物）
* **Lambdas 服务** - 实用端点和内容查询
* **通信服务器** - 实时消息传输

**架构角色**：Catalyst 节点在地理上分布且无需许可。该网络在没有中心化控制的情况下提供内容冗余和可用性。

**关键集成**:

* Realm Provider - 公告节点可用性
* Asset Bundle Registry - 在部署时触发资源优化
* Archipelago Workers - 提供岛屿/集群数据

**API 参考**: [Catalyst API](https://github.com/decentraland/docs/blob/main/apis/catalyst/overview/README.md)

### Lamb2

**目的**：Lambda 工具和无服务器函数

Lamb2 提供用于内容消费和查询的实用端点，用于补充 Content Server：

* 场景聚合和过滤
* 带回退的资料查询
* 状态和健康检查

**架构角色**：作为 Content Server 原始实体访问之上的便捷层，提供客户端通常需要的更高级查询模式。

**API 参考**: [Lamb2 API](https://github.com/decentraland/docs/blob/main/apis/lamb2/overview/README.md)

***

## 实时通信层

### Realm Provider

**目的**：服务发现和 Realm 选择

Realm Provider 是所有 Decentraland 客户端的入口点。它基于以下因素实现智能 Realm 选择：

* **地理优化** - 将用户路由到最近的 Catalyst 节点
* **健康监控** - 过滤不健康或过载的节点
* **容量跟踪** - 提供每个 Realm 的实时用户数量
* **热门场景聚合** - 识别所有 Realm 中受欢迎的位置

**架构角色**：可用基础设施的单一事实来源。客户端在启动时查询一次，即可发现所有服务端点（Catalyst、Comms、BFF）。

**关键集成**:

* 定期轮询所有 Catalyst 节点
* 聚合 Archipelago 统计信息
* 提供分布式网络的统一视图

**API 参考**: [Realm Provider API](https://github.com/decentraland/docs/blob/main/apis/realm-provider/overview/README.md)

### 通信守门人

**目的**：语音和视频访问控制

Gatekeeper 管理对 LiveKit 媒体服务器的语音和视频聊天访问：

* **令牌生成** - 创建具有特定权限的限时访问令牌
* **场景管理** - 管理场景管理员权限和封禁
* **流管理** - 控制直播访问和 RTMP 密钥
* **隐私控制** - 强制执行私人语音聊天权限

**架构角色**：客户端与媒体基础设施之间的安全层。在启用灵活权限模型（基于场景、私有、社区）的同时，防止未经授权的访问。

**关键集成**:

* LiveKit - 为媒体服务器访问颁发 JWT 令牌
* Worlds API - 验证世界所有权以授予管理员权限
* Signed Fetch - 通过钱包签名验证所有请求

**API 参考**: [Comms Gatekeeper API](https://github.com/decentraland/docs/blob/main/apis/comms-gatekeeper/overview/README.md)

### Archipelago Workers

**目的**：通信集群和消息路由

Archipelago 实现了基于距离的集群协议，将附近玩家分组到“岛屿”中：

* **WebSocket 传输** - 与客户端保持持久连接
* **位置跟踪** - 实时监控玩家位置
* **岛屿形成** - 根据距离动态分组玩家
* **消息路由** - 仅向岛屿成员转发消息

**架构组件**:

* **WebSocket 连接器** - 处理客户端连接和认证
* **Archipelago 核心** - 实现集群算法和岛屿管理
* **统计服务** - 提供连接指标和用户数量
* **NATS 集成** - 发布位置更新并路由消息

**架构角色**：通过限制消息泛洪来优化点对点通信。消息不会广播给一个 Realm 中的所有用户，而是仅到达交互范围内的玩家。

**关键集成**:

* NATS 消息代理 - 分布式消息路由
* Realm Provider - 提供岛屿统计信息
* Places API - 热门场景的用户数量数据

**API 参考**: [Archipelago Workers API](https://github.com/decentraland/docs/blob/main/apis/archipelago-workers/overview/README.md)

***

## 功能服务

### 世界

**目的**：主网格之外的隔离场景托管

Worlds 使用户能够在隔离环境中部署场景：

* **命名世界** - 可通过自定义 URL 访问（例如， `world.dclworlds.com`)
* **私有世界** - 基于 NFT 门控的访问控制
* **World 权限** - 由所有者管理管理员和部署权限

**架构角色**：将 Decentraland 的内容模型扩展到固定的 LAND 网格之外。每个世界都是一个独立场景，拥有自己的通信通道和访问控制。

**关键集成**:

* 查询区块链索引器以验证 NFT 所有权
* 将世界更新发布到 NATS，以实现实时客户端同步
* 与 Comms Gatekeeper 集成，用于语音聊天房间
* 在部署时触发资源处理流水线

**API 参考**: [Worlds API](https://github.com/decentraland/docs/blob/main/apis/worlds/overview/README.md)

### 事件

**目的**：游戏内事件管理和发现

管理虚拟事件的完整生命周期：

* **事件 CRUD** - 创建、更新和排期
* **参与者跟踪** - 用户参与和 RSVP
* **发现** - 基于时间的查询和过滤
* **通知** - 与 Events Notifier 集成

**架构角色**：为元宇宙提供时间上下文。事件通过突出显示时间敏感体验来推动用户发现和参与。

**API 参考**: [Events API](https://github.com/decentraland/docs/blob/main/apis/events/overview/README.md)

### Places

**目的**：兴趣点的发现与策展

聚合并策展 Decentraland 中有趣的位置：

* **热门场景** - 基于用户数量的实时热度
* **精选地点** - 编辑策划的位置
* **搜索和过滤** - 通过标签、分类进行发现
* **POI 元数据** - 描述、缩略图、坐标

**架构角色**：解决大型开放世界中的发现问题。聚合来自多个来源的数据，帮助用户找到有吸引力的内容。

**关键集成**:

* Catalyst - 场景元数据和部署信息
* Archipelago Stats - 每个场景的实时用户数量
* Comms Gatekeeper - Realm 可用性和状态

**API 参考**: [Places API](https://github.com/decentraland/docs/blob/main/apis/places/overview/README.md)

### Atlas 服务器

**目的**：地图数据和地块可视化

提供全面的世界地图数据：

* **地块所有权** - 基于区块链索引的 LAND 数据
* **场景元数据** - 已部署的场景名称和坐标
* **地图瓦片** - 用于 UI 显示的预渲染瓦片图像
* **空间查询** - 按坐标或所有者查找地块

**架构角色**：为 Decentraland 的 LAND 网格提供空间索引。对地图 UI 和空间导航至关重要。

**API 参考**: [Atlas Server API](https://github.com/decentraland/docs/blob/main/apis/atlas-server/overview/README.md)

### Camera Reel

**目的**：用户生成截图管理

管理用户截图和图像：

* **图片上传** - 经身份验证的图片存储
* **相册组织** - 用户截图集合
* **元数据** - 场景位置、时间戳、标签

**架构角色**：围绕用户生成的摄影内容，支持内容分享和社交功能。

**API 参考**: [Camera Reel API](https://github.com/decentraland/docs/blob/main/apis/camera-reel/overview/README.md)

### 探索游戏

**目的**：新手引导和教程游戏化

用于新用户引导的交互式任务系统：

* **任务跟踪** - 完成教程任务的进度
* **挑战完成** - 任务验证
* **奖励集成** - 连接到奖励系统

**架构角色**：通过提供结构化、以目标为导向的 Decentraland 功能介绍，降低新用户的使用门槛。

**API 参考**: [Exploration Games API](https://github.com/decentraland/docs/blob/main/apis/exploration-games/overview/README.md)

***

## 核心服务

### 认证服务器

**目的**：基于钱包的认证和会话管理

实现 Decentraland 的钱包优先认证模型：

* **签名验证** - 验证以太坊钱包签名
* **JWT 令牌签发** - 生成会话令牌
* **令牌验证** - 验证受保护资源的令牌
* **会话生命周期** - 令牌刷新和过期

**架构角色**：提供去中心化身份验证。用户通过钱包签名而非密码进行认证，这与 Web3 原则一致。

**认证流程**:

1. 客户端请求挑战
2. 用户使用钱包签署挑战
3. Auth Server 验证签名并签发 JWT
4. 客户端在后续 API 请求中包含 JWT

**API 参考**: [Auth Server API](https://github.com/decentraland/docs/blob/main/apis/auth-server/overview/README.md)

### 社交服务

**目的**：社交图谱和社区管理

管理社交关系和社区：

* **好友系统** - 请求、批准、好友列表
* **黑名单** - 用户屏蔽和隐私
* **社区** - 群组成员资格和发现
* **实时状态** - 通过 NATS 推送好友上线/离线通知
* **私信** - 直接消息基础设施

**架构角色**：提供社交层，将 Decentraland 从虚拟世界转变为社交元宇宙。

**关键集成**:

* Catalyst Client - 获取好友的资料数据
* NATS - 发布好友状态更新
* Archipelago - 查询在线状态和位置

**API 参考**: [Social Service API](https://github.com/decentraland/docs/blob/main/apis/social-service/overview/README.md)

### Marketplace Server

**目的**：NFT 市场集成

Decentraland 的穿戴物和表情市场后端：

* **上架查询** - 浏览和搜索市场商品
* **交易历史** - 购买记录
* **定价数据** - 市场价格和趋势
* **集合元数据** - 穿戴物和表情集合

**架构角色**：将链上 NFT 数据与用户友好的市场界面连接起来。索引区块链事件以实现快速查询。

**API 参考**: [Marketplace Server API](https://github.com/decentraland/docs/blob/main/apis/marketplace-server/overview/README.md)

***

## 资源服务

### 资产包注册表

**目的**：优化的资源管理

平台优化资源包的注册表：

* 按平台划分的资源包 URL
* 版本控制
* CDN 分发

**API 参考**: [Asset Bundle Registry API](https://github.com/decentraland/docs/blob/main/contributor/apis/asset-bundle-registry/README.md)

**系统组件**:

* **资源包转换器** - 构建特定平台的资源包
* **LOD 生成器** - 创建细节层次变体

**流程**:

{% @mermaid/diagram content="sequenceDiagram
participant Catalyst
participant Queue as Deployments Queue
participant Converter as AB Converter
participant Registry

```
Catalyst->>Queue: New deployment
Queue->>Converter: Process assets
Converter->>Converter: Build bundles
Converter->>Registry: Register bundles" %}
```

### Camera Reel

**目的**：截图和图片管理

用户生成内容管理：

* 截图存储
* 图片上传
* 相册组织

**API 参考**: [Camera Reel API](https://github.com/decentraland/docs/blob/main/contributor/apis/camera-reel/README.md)

### Credits Server

**目的**：虚拟货币和经济

管理 Decentraland 的虚拟积分系统：

* **余额跟踪** - 用户积分余额
* **交易账本** - 积分转账和消费
* **购买集成** - 法币到积分的兑换
* **区块链同步** - 查询索引器以获取链上余额

**架构角色**：为游戏内购买和功能提供了一种比区块链代币更低门槛的货币替代方案。

**API 参考**: [Credits Server API](https://github.com/decentraland/docs/blob/main/apis/credits-server/overview/README.md)

### 徽章

**目的**：成就和游戏化系统

事件驱动的徽章奖励：

* **徽章定义** - 可用成就
* **用户库存** - 每位用户已获得的徽章
* **自动授予** - 事件触发的徽章奖励

**架构组件**:

* **Badges API** - 徽章查询和用户库存
* **徽章处理器** - 监听 Events Notifier 并授予徽章

**架构角色**通过成就机制将用户参与游戏化。为用户活动提供可见性和认可。

**API 参考**: [Badges API](https://github.com/decentraland/docs/blob/main/apis/badges/overview/README.md)

### 奖励 API

**目的**：基于活动的 NFT 奖励分发

管理促销型 NFT 奖励活动：

* **活动管理** - 有时限的奖励计划
* **资格验证** - 检查用户是否符合资格
* **空投协调** - 向符合条件的用户分发 NFT
* **分析** - 活动参与跟踪

**架构角色**：通过 NFT 奖励支持营销活动和用户获取。

**API 参考**: [奖励 API](https://github.com/decentraland/docs/blob/main/apis/rewards/overview/README.md)

### Notifications Workers

**目的**：用户通知投递系统

多渠道通知基础设施：

* **应用内通知** - 通知收件箱查询
* **电子邮件通知** - SendGrid 集成
* **推送通知** - 移动端和桌面端提醒
* **已读状态跟踪** - 将通知标记为已读/未读

**架构组件**:

* **通知收件箱** - 用于查询用户通知的 API
* **通知处理器** - 从 Events Notifier 生成通知

**架构角色**：通过及时提醒好友活动、事件、奖励和系统更新来保持用户参与。

**API 参考**: [Notifications Workers API](https://github.com/decentraland/docs/blob/main/apis/notifications-workers/overview/README.md)

### Events Notifier

**目的**：平台事件的事件总线

触发下游操作的集中式事件发布系统：

* **用户事件** - 登录、购买、部署
* **世界事件** - 场景更新、管理员操作
* **系统事件** - 维护、更新

**架构角色**：将事件生产者与消费者解耦。服务发布事件而无需知道由谁处理，从而实现可扩展架构。

**下游集成**:

* Notifications Processor - 创建用户通知
* Badges Processor - 授予成就徽章
* Rewards API - 跟踪活动资格

**API 参考**: [Events Notifier API](https://github.com/decentraland/docs/blob/main/apis/events-notifier/overview/README.md)

***

## 服务交互模式

### 常见集成模式

#### Catalyst Client Library

许多后端服务使用 **Catalyst Client** 库与去中心化 Catalyst 网络交互：

* **社交服务** - 获取用户资料数据
* **Events API** - 查询场景元数据
* **Places** - 聚合场景信息
* **资产包注册表** - 监听部署事件

该库抽象了多节点查询和故障转移逻辑。

#### NATS 消息代理

实时更新和异步通信通过 NATS 进行：

* **社交服务** - 发布好友状态变更
* **世界** - 广播世界配置更新
* **Archipelago** - 在岛屿之间路由位置更新
* **Events Notifier** - 发布平台事件

NATS 使服务能够在不直接耦合的情况下通信。

#### 区块链索引器

为提升性能，服务查询索引器（而非直接查询区块链）：

* **世界** - 验证 NAME NFT 所有权
* **Atlas** - 获取 LAND 地块数据
* **Credits Server** - 检查代币余额
* **奖励 API** - 验证资格条件

对于实时 API 来说，直接查询区块链会太慢。

### 内容部署流水线

当用户将内容部署到 Catalyst 时，多个下游服务会对其进行处理：

{% @mermaid/diagram content="flowchart TB
Deploy\[User Deploys Content]
Catalyst\[Catalyst Node]
Queue\[Deployment Queue]

```
subgraph Processing
    AB[Asset Bundle Converter]
    Profile[Profile Image Generator]
    Badges[Badges Processor]
    Events[Events Notifier]
end

Deploy --> Catalyst
Catalyst --> Queue
Queue --> AB
Queue --> Profile
Queue --> Events
Events --> Badges" %}
```

**流水线步骤**:

1. **Catalyst** - 存储原始实体数据
2. **部署队列** - 触发异步处理
3. **资源包转换器** - 构建优化后的 Unity Bundle
4. **头像生成器** - 渲染头像缩略图（用于个人资料实体）
5. **Events Notifier** - 发布部署事件
6. **徽章处理器** - 检查部署成就徽章

### 服务依赖矩阵

| 服务                    | 核心依赖                       | 向其提供数据                |
| --------------------- | -------------------------- | --------------------- |
| Catalyst              | 无（去中心化）                    | 所有服务                  |
| Realm Provider        | Catalyst、Archipelago Stats | 所有客户端                 |
| 认证服务器                 | 无                          | 所有受保护的服务              |
| Archipelago Workers   | NATS、LiveKit               | Realm Provider、Places |
| 通信守门人                 | LiveKit、Worlds API         | 客户端（令牌生成）             |
| 世界                    | Catalyst、NATS、区块链          | Gatekeeper、客户端        |
| 社交服务                  | Catalyst、NATS、Archipelago  | 客户端                   |
| Places                | Catalyst、Archipelago、Comms | 客户端                   |
| Events Notifier       | 无                          | 通知、徽章、奖励              |
| 资产包注册表                | Catalyst、部署队列              | 客户端（优化后的资源）           |
| Notifications Workers | 事件通知器、SendGrid             | 客户端                   |

***

## 相关文档

### 架构

* [架构概览](/contributor/contributor-zh/jia-gou/architecture.md) - 完整系统架构
* [Catalyst 网络](/contributor/contributor-zh/jia-gou/catalyst.md) - 去中心化内容分发
* [基础设施](/contributor/contributor-zh/jia-gou/infrastructure.md) - 支撑系统（NATS、LiveKit、数据库）

### API 参考

* [API 文档](https://github.com/decentraland/docs/blob/main/apis/README.md) - 完整 API 规范
* [认证](https://github.com/decentraland/docs/blob/main/contributor/auth/authchain.md) - 基于钱包的身份验证流程
* [通信](https://github.com/decentraland/docs/blob/main/contributor/comms/overview.md) - 实时消息协议

### 开发

* [贡献者指南](https://github.com/decentraland/docs/blob/main/contributor/contributor-guides/overview.md) - 开发工作流
* [测试指南](https://github.com/decentraland/docs/blob/main/contributor/practice/testing.md) - 服务测试实践


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/contributor/contributor-zh/jia-gou/services.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.