跳转到主要内容
要部署 ClickStack 开源版 (即自行运行和管理 ClickHouse 及 ClickStack UI) ，我们提供了预构建的 Docker 镜像，将 UI、OpenTelemetry collector 和 ClickHouse 打包到单个容器中，让本地开发、测试和自管理部署都能轻松上手。
此外还提供托管版本的 ClickStack——请参阅 Managed ClickStack。
这些镜像基于官方 ClickHouse Debian 软件包构建，并提供多种发行版，以适应不同的使用场景。 最简单的选择是 单镜像发行版，其中集成了该栈的所有核心组件：
  • HyperDX UI
  • OpenTelemetry (OTel) collector
  • ClickHouse
这个一体化镜像可让你通过一条命令启动整套栈，非常适合测试、实验或快速进行本地部署。
1

​
使用 Docker 部署该栈

以下命令将运行一个 OpenTelemetry collector (监听 4317 和 4318 端口) 、HyperDX UI (监听 8080 端口) 以及 ClickHouse (8123 端口) 。
镜像名称更新ClickStack 镜像现已发布为 clickhouse/clickstack-* (此前为 docker.hyperdx.io/hyperdx/*) 。
持久化数据和设置若要在容器重启后保留数据和设置，你可以修改上面的 Docker 命令，挂载 /data/db、/var/lib/clickhouse 和 /var/log/clickhouse-server 这几个路径。例如：
2

​
打开 ClickStack UI

访问 http://localhost:8080 即可进入 ClickStack UI (HyperDX) 。创建一个用户，并设置符合复杂度要求的用户名和密码。HyperDX 会自动连接到本地集群，并为日志、链路追踪、指标和会话创建数据源，让你可以立即开始探索产品。
3

​
探索产品

部署完成后，不妨试试我们的某个示例数据集。如果要继续使用本地集群：
  • 示例数据集 - 从我们的公开演示中加载一个演示数据集，并诊断一个简单问题。
  • 本地文件和指标 - 使用本地 OTel collector 加载本地文件，并在 OSX 或 Linux 上监控系统。

或者，你也可以连接到演示集群，探索更大的数据集：

​
其他部署模式

​
本地模式

本地模式是一种无需身份验证即可部署 HyperDX 的方式。 不支持身份验证。 此模式适用于快速测试、开发、演示和调试等场景；在这些场景下，无需身份验证，也不需要持久化保存设置。 有关此部署模式的更多信息，请参阅 “仅本地模式”。

​
托管版本

你可以使用以本地模式运行的 ClickStack 托管版，访问 play-clickstack.clickhouse.com。

​
自托管版本

1

​
使用 Docker 运行

自托管本地模式镜像还预先配置了 OpenTelemetry Collector、ClickStack UI 和 ClickHouse server。这使您能够轻松接收应用程序的遥测数据，并在几乎无需额外配置的情况下完成可视化。要开始使用自托管版本，只需运行 Docker 容器并转发相应端口：
与 “All in one” 镜像不同，系统不会提示您创建用户，因为本地模式不包含身份验证。
2

​
补全连接凭据

要连接到您自己的外部 ClickHouse 集群，您可以手动输入连接凭据。或者，如果您只是想快速体验产品，也可以点击连接到演示服务器，访问预加载的数据集，并在无需任何设置的情况下试用 ClickStack。如果连接到演示服务器，您可以按照演示数据集说明来浏览该数据集。
最后修改于 2026年6月25日