安装方式与目录结构
ClickHouse 官方提供 deb 与 rpm 仓库安装，也提供单机 tar 包：仓库方式装好后由 systemd 管理 clickhouse-server 服务，命令行工具是 clickhouse-client。配置集中在 config.xml，用户与配额在 users.xml，数据默认落在 /var/lib/clickhouse，日志在 /var/log/clickhouse-server。
默认端口与监听
服务默认监听原生协议的 9000 端口、HTTP 接口的 8123 端口，副本之间用 9009 端口通信。默认配置只监听本机回环地址，要让外部访问必须在 config.xml 里显式配置监听地址并放行防火墙端口，否则客户端会一直连不上。
基本信息
| 服务名 | clickhouse-server（客户端为 clickhouse-client） |
|---|---|
| 默认端口 | 9000 原生协议、8123 HTTP、9009 副本复制 |
| 关键路径 | /etc/clickhouse-server 配置、/var/lib/clickhouse 数据、/var/log/clickhouse-server 日志 |
| 管理方式 | systemd（enable、start、restart、status） |
| 运行用户 | 服务以 clickhouse 系统用户运行 |
常用命令
常用命令
# 仓库方式安装（Deb 系）
sudo apt-get install -y clickhouse-server clickhouse-client
# 服务管理
sudo systemctl enable clickhouse-server
sudo systemctl status clickhouse-server
sudo systemctl restart clickhouse-server
# 连通性与版本确认
clickhouse-client --query "SELECT version()"
curl "http://127.0.0.1:8123/?query=SELECT%201"
# 生产部署前按规范调整：data_path、日志上限、listen_host典型使用场景
- 本地试跑：快速起一个实例验证语法与查询性能
- 生产部署：调整数据目录、日志滚动与监听地址后交给 systemd 托管
- 排查启动失败：先看服务日志与配置校验结果
- 版本核对：用 version() 确认服务与客户端版本是否匹配
- 端口核对：确认 9000 与 8123 只对内网开放
端口用途对照
| 端口 | 用途 | 注意 |
|---|---|---|
| 9000 | 原生协议，客户端与驱动默认连接 | 不要对公网开放 |
| 8123 | HTTP 接口，curl 与浏览器可访问 | 暴露时配合鉴权与反向代理 |
| 9009 | 副本之间复制使用 | 集群节点之间需要互通 |
| 9440 / 8443 | 原生协议与 HTTPS 的加密端口 | 启用传输加密时使用 |
生产环境要把数据目录、日志大小上限与监听地址按规范调整；改配置后用 systemctl reload 或 restart 生效，改之前先备份原配置便于回退。
默认只监听本机，开放外部访问前先确认鉴权设置与网络隔离到位，不要直接把监听地址改成全部地址就上线。