---
title: "Zaino 索引器 [Indexer]"
url: "https://zechub.wiki/zh/zcash-tech/Zaino"
locale: "zh"
description: "Zaino 是用于 Zcash blockchain 的 Rust 索引器。它从 Zebra 全节点读取链数据，并提供钱包、浏览器、水龙头及其他服务所需的数据，而无需让 Zebra 本身负责每一个面向客户端的索引。"
---

# Zaino 索引器 [Indexer]

Zaino 是用于 Zcash blockchain 的 Rust 索引器。它从 Zebra 全节点读取链数据，并提供钱包、浏览器、水龙头及其他服务所需的数据，而无需让 Zebra 本身负责每一个面向客户端的索引。

## TL;DR

* **Zebra** 验证 Zcash 链。
* **Zaino** 为 Zebra 的链数据建立索引，并公开面向客户端的 API。
* **Zallet** 是 Z3 技术栈中的钱包组件。在默认的 Z3 设置中，Zallet 直接与 Zebra 通信，无需独立的 Zaino 服务。
* 当运营者需要兼容 lightwalletd 的 gRPC 端点、JSON-RPC 代理，或为轻钱包、浏览器、水龙头和类似服务提供基础设施时，独立的 Zaino 服务会很有用。
* Zaino 是活跃的基础设施，但运营者应在投入生产环境前查阅官方 Zaino 和 Z3 文档，了解当前的部署细节。

## Zaino 的作用

Zaino 位于 Zebra 与客户端软件之间。Zebra 是共识节点：它下载、验证并跟踪 Zcash blockchain。Zaino 使用 Zebra 作为其链数据来源，然后准备客户端应用程序能够高效查询的索引视图。

这种分离使各自的职责更加清晰：

| 组件 | 角色 |
|:--|:--|
| Zebra | 全节点和验证者 |
| Zaino | 索引器和面向客户端的 API 服务 |
| Zallet | 钱包服务 |
| lightwalletd | 较早的轻钱包服务器，Zaino 旨在替代或补充它 |

Zaino 为轻客户端、全客户端或钱包，以及区块链浏览器提供功能。它可访问最终确定的链、未最终确定的最佳链，以及由 Zebra 持有的内存池数据。

## 它如何融入当前的 Zcash 技术栈

当前的 Z3 技术栈围绕 Zebra、Zallet 和可选的 Zaino 构建。

在默认的 Z3 部署中，Zebra 和 Zallet 一同运行。Zallet 直接访问 Zebra，因此仅运行本地钱包技术栈的运营者无需启动独立的 Zaino 服务。

当运营者希望服务外部客户端时，会添加 Zaino。在 Z3 中，它运行在 `indexer` Compose 配置文件之后，并增加：

* 面向轻钱包客户端、兼容 lightwalletd 的 gRPC 端点
* 面向浏览器、水龙头和服务后端的 JSON-RPC 代理
* 与 Zebra 链状态分离的索引器数据库

这使 Zaino 对钱包后端、公共基础设施运营者、浏览器、水龙头，以及测试需要索引 Zcash 链数据的服务的开发者尤其重要。

## Zaino 和 lightwalletd

lightwalletd 是最初的轻钱包服务器。Zaino 是该角色基于 Rust 的后继方案。它的目标是在可能的情况下提供兼容的 API，以便钱包和服务可以迁移，而无需一次性彻底重写。

这并不意味着每个 lightwalletd 部署都已经迁移到 Zaino。运营者应将 Zaino 视为当前基于 Zebra 的技术栈的一部分，并在决定运行什么之前查看最新的项目文档、发布版本和服务仪表板。

## 运营者说明

最简单的权威部署途径是 Z3 仓库。Z3 将 Zaino 包含为可选服务：

```bash
docker compose --env-file .env.<network> --profile indexer up -d
```

先运行常规的 Z3 设置，并等待 Zebra 完成同步，然后再在主网或测试网上启动依赖服务。

Zaino 公开两种网络服务。gRPC 服务是面向 lightwallet 的 API。JSON-RPC 服务适用于回环网络或受信任的私有网络，除非外部层提供保护。不要将未经身份验证或未加密的 JSON-RPC 端点暴露到公共互联网。

## 展示 Zaino 工作方式的一些图示

### Zaino 内部架构

![Zaino Internal Architecture](/content-images/image-2025-01-02-190143429-3f3cc78fa5.webp)

### Zaino 实时服务架构

![Zebra Live Service Architecture](/content-images/image-2025-01-02-190349017-892cb409ea.webp)

### Zaino 系统架构

![Zaino System Architecture](/content-images/image-2025-01-02-190448037-1e4e675ccb.webp)

## 常见错误

**将 Zaino 视为全节点。** Zaino 不是验证者。Zebra 验证链；Zaino 从 Zebra 为数据建立索引。

**假设每个 Z3 部署都需要独立的 Zaino。** 在默认的 Z3 技术栈中，Zallet 可以直接访问 Zebra。当你需要为外部客户端提供独立索引器服务时，再启动 Zaino。

**将计划中的功能表述为已部署。** Zaino 正在积极开发，因此在将某项功能描述为可用之前，请查看当前的发行说明和文档。

**随意公开 JSON-RPC。** 除非受到另一层保护，否则 Zaino 的 JSON-RPC 接口适用于回环网络或受信任的私有网络。

## 我可以在哪里了解更多信息？

* [Zaino GitHub 仓库](https://github.com/zingolabs/zaino)
* [Zaino 发布版本](https://github.com/zingolabs/zaino/releases)
* [Zaino 生成的文档](https://zingolabs.github.io/zaino/)
* [Z3 部署仓库](https://github.com/ZcashFoundation/z3)
* [Zebra 文档](https://zebra.zfnd.org/)
* [Zaino 拨款和项目讨论](https://forum.zcashcommunity.com/t/zingo-labs-accelerates-zcashd-deprecation-with-zaino/48545)

**最后更新：**2026 年 8 月
