From 44ce6497a1927f776f53c4319274600cd17a1651 Mon Sep 17 00:00:00 2001
From: ryan <ryan@arctel.net>
Date: Fri, 10 Jul 2026 11:10:32 +0800
Subject: [PATCH] docs(docker): use ./config/clickhouse for CH performance
 mount

Move performance.xml to config/clickhouse and mount the directory to
/etc/clickhouse-server/config.d; update docs and compose paths.
---
 .env.example              | 7 +------
 README.md                 | 1 -
 docker-compose.yaml       | 4 ++--
 docs/deployment/server.md | 3 ---
 docs/guide/quick-start.md | 1 -
 5 files changed, 3 insertions(+), 13 deletions(-)

diff --git a/.env.example b/.env.example
index 9b6d4b42..e340eb24 100644
--- a/.env.example
+++ b/.env.example
@@ -61,12 +61,7 @@ CLICKHOUSE_USERNAME=default
 # 须与 compose clickhouse 服务密码一致（首次初始化后改密码需清 data/clickhouse_data）
 CLICKHOUSE_PASSWORD=replace-with-clickhouse-password
 CLICKHOUSE_NAME=openflare
-# compose 宿主机映射端口（仅 docker-compose 使用）
-# CLICKHOUSE_HTTP_PORT=8123
-# CLICKHOUSE_NATIVE_PORT=9000
-# 客户端连接池 / block 缓冲在 config.yaml 的 clickhouse.* 中配置
-# （小规格默认 max_idle_conn=8, max_open_conn=16, block_buffer_size=32）
-#
+
 
 # ─── 日志 ──────────────────────────────────────────────────────────────────────
 LOG_LEVEL=info
diff --git a/README.md b/README.md
index 88000e5b..0bf51b40 100644
--- a/README.md
+++ b/README.md
@@ -142,7 +142,6 @@ services:
         hard: 262144
     volumes:
       - openflare_clickhouse_data:/var/lib/clickhouse
-      # 目录内仅 performance.xml；不要放 listen 配置
       - ./config/clickhouse:/etc/clickhouse-server/config.d:ro
     healthcheck:
       test: ["CMD", "clickhouse-client", "--user", "${CLICKHOUSE_USERNAME:-default}", "--password", "${CLICKHOUSE_PASSWORD:-replace-with-clickhouse-password}", "--query", "SELECT 1"]
diff --git a/docker-compose.yaml b/docker-compose.yaml
index 736308c4..019d7094 100644
--- a/docker-compose.yaml
+++ b/docker-compose.yaml
@@ -84,8 +84,8 @@ services:
         soft: 262144
         hard: 262144
     ports:
-      - "${CLICKHOUSE_HTTP_PORT:-8123}:8123"
-      - "${CLICKHOUSE_NATIVE_PORT:-9000}:9000"
+      - "8123:8123"
+      - "9000:9000"
     volumes:
       - ./data/clickhouse_data:/var/lib/clickhouse
       - ./config/clickhouse:/etc/clickhouse-server/config.d:ro
diff --git a/docs/deployment/server.md b/docs/deployment/server.md
index 8cd2fc14..9d38a289 100644
--- a/docs/deployment/server.md
+++ b/docs/deployment/server.md
@@ -101,7 +101,6 @@ services:
         hard: 262144
     volumes:
       - ./data/clickhouse_data:/var/lib/clickhouse
-      # 仅含 performance.xml 的目录；不要在此目录放 listen 配置
       - ./config/clickhouse:/etc/clickhouse-server/config.d:ro
     healthcheck:
       test: ["CMD", "clickhouse-client", "--user", "default", "--password", "123456", "--query", "SELECT 1"]
@@ -193,7 +192,6 @@ services:
         hard: 262144
     volumes:
       - openflare_clickhouse_data:/var/lib/clickhouse
-      # 仅含 performance.xml 的目录；不要在此目录放 listen 配置
       - ./config/clickhouse:/etc/clickhouse-server/config.d:ro
     healthcheck:
       test: ["CMD", "clickhouse-client", "--user", "${CLICKHOUSE_USERNAME:-default}", "--password", "${CLICKHOUSE_PASSWORD:-replace-with-clickhouse-password}", "--query", "SELECT 1"]
@@ -312,7 +310,6 @@ services:
         hard: 262144
     volumes:
       - openflare_clickhouse_data:/var/lib/clickhouse
-      # 仅含 performance.xml 的目录；不要在此目录放 listen 配置
       - ./config/clickhouse:/etc/clickhouse-server/config.d:ro
     healthcheck:
       test: ["CMD", "clickhouse-client", "--user", "${CLICKHOUSE_USERNAME:-default}", "--password", "${CLICKHOUSE_PASSWORD:-replace-with-clickhouse-password}", "--query", "SELECT 1"]
diff --git a/docs/guide/quick-start.md b/docs/guide/quick-start.md
index 03a79a7c..8cde5057 100644
--- a/docs/guide/quick-start.md
+++ b/docs/guide/quick-start.md
@@ -115,7 +115,6 @@ services:
         hard: 262144
     volumes:
       - openflare_clickhouse_data:/var/lib/clickhouse
-      # 目录内仅 performance.xml；不要放 listen 配置
       - ./config/clickhouse:/etc/clickhouse-server/config.d:ro
     healthcheck:
       test: ["CMD", "clickhouse-client", "--user", "default", "--password", "${CLICKHOUSE_PASSWORD:-replace-with-clickhouse-password}", "--query", "SELECT 1"]