> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 仅使用本地模式

> 以纯本地模式部署 ClickStack - ClickHouse 可观测性技术栈

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

与[一体化镜像](/zh/clickstack/deployment/docker-compose)类似，这个完整的 Docker 镜像集成了所有 ClickStack 组件：

* **ClickHouse**
* **HyperDX**
* **OpenTelemetry (OTel) 收集器** (通过端口 `4317` 和 `4318` 提供 OTLP)
* **MongoDB** (用于持久化应用状态)

**不过，此 HyperDX 发行版已禁用用户身份验证功能**

<div id="suitable-for">
  ### 适用场景
</div>

* 演示
* 调试
* 使用 HyperDX 的开发场景

<div id="deployment-steps">
  ## 部署步骤
</div>

<br />

<Steps>
  <Step>
    ### 使用 Docker 部署

    本地模式会在 8080 端口部署 HyperDX UI。

    ```shell theme={null}
    docker run -p 8080:8080 clickhouse/clickstack-local:latest
    ```
  </Step>

  <Step>
    ### 访问 HyperDX UI

    访问 [http://localhost:8080](http://localhost:8080) 即可打开 HyperDX UI。

    **你不会被提示创建用户，因为此部署模式未启用身份验证。**

    连接到你自己的外部 ClickHouse 集群，例如 ClickHouse Cloud。

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/16jdCy1HTWZ9Bvmz/images/use-cases/observability/hyperdx-2.png?fit=max&auto=format&n=16jdCy1HTWZ9Bvmz&q=85&s=45243f0126c49b735eb0f6aa3b8636ee" alt="创建登录" size="md" width="1966" height="1392" data-path="images/use-cases/observability/hyperdx-2.png" />

    创建一个数据源，保留所有默认值，并在 `Table` 字段中填入 `otel_logs`。其他设置应会自动检测，你可以直接点击 `Save New Source`。

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/16jdCy1HTWZ9Bvmz/images/use-cases/observability/hyperdx-logs.png?fit=max&auto=format&n=16jdCy1HTWZ9Bvmz&q=85&s=32135e58b7ee1c4085b12b41ef2147ac" alt="创建日志数据源" size="md" width="1944" height="1572" data-path="images/use-cases/observability/hyperdx-logs.png" />
  </Step>
</Steps>

<div id="schema-choice-map-vs-json">
  ## schema 选择：Map 与 JSON
</div>

默认情况下，ClickStack 将属性存储为 `Map(LowCardinality(String), String)` 列。这是可观测性 workloads 推荐使用的 schema。结合 [bucketed map serialization](/zh/reference/data-types/map#bucketed-map-serialization) 以及针对 map 键和值的文本索引，它可以实现有针对性的 lookup，同时避免动态 JSON 子列逐键摄取带来的额外开销。

`JSON` 类型的 schema 也已提供，目前处于 Beta 阶段，适合在属性键集合较小且稳定的 workloads 上进行评估。**不建议**将其作为默认选项。有关完整对比以及启用 JSON 支持所需的环境变量，请参见 [Map vs JSON type](/zh/clickstack/ingesting-data/schema/map-vs-json)。