Repolode
graphql-hive

graphql-hive/console

面向 GraphQL 联邦及其他 GraphQL API 的开源 Schema 注册中心与分析平台,可用云服务或自托管。

可替代:Apollo GraphOS

Star
483
Fork
151
未关闭 Issue
284
最近提交
4小时前

这是什么?

Hive Console 是面向 GraphQL API 的 Schema 注册中心与分析平台,支持联邦(Federation)、拼接(Stitching)以及独立的 GraphQL 服务。它会记录 Schema 变更历史,通过校验规则识别破坏性变更,并可经 Slack、GitHub 或应用内通知团队。

在监控方面,它展示错误率、延迟、请求量、操作数量和活跃客户端等指标,同时提供 OpenTelemetry 链路追踪,将分布式 trace 与使用数据关联。此外还支持持久化文档(Persisted Documents)发布,通过 CDN 提供已审核的操作。

项目采用 MIT 许可证,既可使用 Hive Cloud 托管服务,也可通过 Docker Compose 自托管。代码仓库是 pnpm/Turborepo 单体仓库,包含 Web 控制台、GraphQL 服务、用于 CI 中发布和检查 Schema 的 CLI 以及后台 Worker。

核心功能

  • 01Schema 注册中心,支持破坏性变更检查和完整变更历史
  • 02操作监控,涵盖错误率、延迟和请求量
  • 03OpenTelemetry 链路追踪,并与使用数据关联,包括联邦子图活动
  • 04通过 CDN 提供持久化文档部署
  • 05支持 Slack、Microsoft Teams、GitHub 状态检查和自定义 Webhook 通知

适用场景

  • 在合并 Pull Request 前发现破坏性的 Schema 变更
  • 监控联邦 GraphQL 网关的性能与错误率
  • 通过 Hive CLI 从任意 CI/CD 流水线发布 Schema
  • 团队希望将 Schema 数据保存在自有基础设施中时进行自托管

快速上手

  1. 1

    使用 pnpm 安装依赖

    pnpm install
  2. 2

    设置本地服务

    pnpm local:setup
  3. 3

    生成代码并构建库

    pnpm generate
  4. 4

    启动开发环境并打开 http://localhost:3000

    pnpm dev:hive

使用前须知

  • 开发环境需要 Node.js 24.18.0 或更高版本、pnpm 10.33.2 或更高版本以及 Docker 26.1.1 或更高版本。
  • 自托管需要自行管理基础设施和服务,例如 PostgreSQL、Redis、ClickHouse 和 Kafka/Redpanda。

标签

常见问题

console 是什么?
面向 GraphQL 联邦及其他 GraphQL API 的开源 Schema 注册中心与分析平台,可用云服务或自托管。 Hive Console 是面向 GraphQL API 的 Schema 注册中心与分析平台,支持联邦(Federation)、拼接(Stitching)以及独立的 GraphQL 服务。它会记录 Schema 变更历史,通过校验规则识别破坏性变更,并可经 Slack、GitHub 或应用内通知团队。
console 可以免费使用吗?用的什么许可证?
console 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
console 还在维护吗?
活跃维护中。console 最近一次提交是在 2026年10月22日。
console 适合用来做什么?
在合并 Pull Request 前发现破坏性的 Schema 变更 监控联邦 GraphQL 网关的性能与错误率 通过 Hive CLI 从任意 CI/CD 流水线发布 Schema 团队希望将 Schema 数据保存在自有基础设施中时进行自托管
console 怎么安装和运行?
使用 pnpm 安装依赖: pnpm install 设置本地服务: pnpm local:setup 生成代码并构建库: pnpm generate 启动开发环境并打开 http://localhost:3000: pnpm dev:hive
在哪里获取 console?
源代码和安装说明在 GitHub 上:https://github.com/graphql-hive/console

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目