cube-js/cube

这是什么？

核心功能

• 01在代码中一次定义指标、维度与关联关系，并在多个工具中复用。
• 02通过 SQL、REST 和 GraphQL 接口暴露语义模型。
• 03支持连接 Snowflake、Databricks、BigQuery、Presto、Athena 和 Postgres。
• 04内置缓存引擎，用于降低接口响应延迟。
• 05无界面设计，可与任意前端或 BI 工具搭配使用。

适用场景

• 为多个 BI 工具和仪表盘提供统一的指标定义。
• 在面向客户的产品中嵌入分析功能。
• 为 AI 代理提供受治理的语义层，以查询业务数据。

快速上手

1. 1

   安装 Docker

2. 2

   在新的项目文件夹中运行 Cube Core Docker 容器

   docker run -p 4000:4000 \ -p 15432:15432 \ -v ${PWD}:/cube/conf \ -e CUBEJS_DEV_MODE=true \ cubejs/cube
3. 3

   在浏览器中打开 http://localhost:4000 完成设置

使用前须知

• !快速开始中使用的开发模式会关闭 API 的身份验证并公开 Playground，因此绝不能暴露到互联网或用于生产环境。
• !README 列出了不同部分分别采用 MIT 和 Apache 2.0 许可证，且元数据中的许可证信息不明确，请在使用前确认所用组件的许可证。

标签

常见问题

cube 是什么？

开源语义层，一次定义指标与业务逻辑，并通过 SQL、REST、GraphQL 接口供 BI 工具与 AI 代理调用。 Cube Core 是一个无界面（headless）的语义层。开发者用代码定义指标、维度、关联关系和访问规则，再通过 SQL、REST 和 GraphQL 接口提供给 BI 工具、自定义应用或 AI 代理使用。项目本身不带 UI，团队可以在其上构建符合自身产品的分析体验。

cube 可以免费使用吗？用的什么许可证？

cube 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

cube 还在维护吗？

活跃维护中。cube 最近一次提交是在 2026年10月19日。

cube 适合用来做什么？

为多个 BI 工具和仪表盘提供统一的指标定义。 在面向客户的产品中嵌入分析功能。 为 AI 代理提供受治理的语义层，以查询业务数据。

cube 怎么安装和运行？

安装 Docker 在新的项目文件夹中运行 Cube Core Docker 容器: docker run -p 4000:4000 \ -p 15432:15432 \ -v ${PWD}:/cube/conf \ -e CUBEJS_DEV_MODE=true \ cubejs/cube 在浏览器中打开 http://localhost:4000 完成设置

在哪里获取 cube？

源代码和安装说明在 GitHub 上：https://github.com/cube-js/cube