在银河麒麟V10上安装ClickHouse必须严格匹配CPU架构（x86_64或aarch64），否则因ELF格式错误导致服务无法启动；安装方式包括APT仓库（仅限桌面版）、RPM离线安装（推荐服务器版）和TGZ手动安装（定制化路径），每种方式均需按步骤执行依赖处理、密钥导入、源配置、包安装及systemd服务注册，并完成首次启动验证。
在银河麒麟操作系统V10上安装ClickHouse列式数据库，必须严格匹配CPU架构（x86_64或aarch64）并选择对应部署路径，否则会因ELF格式错误导致服务无法启动、rpm包安装失败或systemd单元加载异常。
确认系统环境与架构
打开终端，先执行cat /etc/os-release，确认输出中ID="kylin"且VERSION_ID="V10"；再运行uname -m，结果必须是x86_64或aarch64——【这是后续所有安装方法的前提，错配将直接导致二进制不可执行】。若输出为i386或armv7l，说明系统不满足ClickHouse最低运行要求，需升级或更换硬件平台。
APT仓库安装（仅限桌面版，基于Ubuntu内核）
该方式适用于已启用Debian系兼容源的银河麒麟V10桌面环境，自动处理依赖，但服务器版常因源配置缺失而失败。
第一步：安装基础工具
执行sudo apt update && sudo apt install -y apt-transport-https ca-certificates dirmngr，缺少dirmngr会导致密钥导入失败。
第二步：导入官方GPG密钥sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4，若提示Command 'apt-key' is deprecated，改用gpg --dearmor方式导入，但麒麟V10桌面版仍兼容此命令。
第三步：添加适配源
先查代号：lsb_release -cs，常见输出为focal（Kylin V10 SP1/SP2）或jammy（SP3），然后执行：echo "deb https://repo.clickhouse.com/deb/stable/main/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/clickhouse.list
第四步：安装并启动sudo apt update && sudo apt install -y clickhouse-server clickhouse-client，安装完成后立即执行sudo service clickhouse-server start，不要跳过这步——【服务默认不自启，且首次启动会生成初始配置文件】。
RPM离线安装（推荐服务器版，支持x86_64/aarch64）
适用于内网环境、无外网访问权限或APT源不可用的生产服务器，规避网络依赖和架构错配风险。
方法一：下载四类RPM包
从https://repo.clickhouse.com/rpm/stable/main/下载对应架构的四个包：clickhouse-common-static、clickhouse-server-common、clickhouse-server、clickhouse-client，版本号必须完全一致（如24.4.2.20-1.el7），【aarch64包名含“aarch64”，x86_64包名含“x86_64”，混用必报错】。
方法二：按依赖顺序安装
进入存放RPM包的目录后，依次执行：sudo rpm -ivh clickhouse-common-static-*.rpm→sudo rpm -ivh clickhouse-server-common-*.rpm→sudo rpm -ivh clickhouse-server-*.rpm→sudo rpm -ivh clickhouse-client-*.rpm。
注意：不能用rpm -Uvh *通配安装，会因依赖解析失败中断。
安装完成后，配置文件已生成于/etc/clickhouse-server/，无需手动创建目录或拷贝模板。
TGZ手动安装（定制化路径与用户控制）
适合需要指定安装路径、以非root用户运行或集成到现有CI/CD流程的场景，绕过包管理器，完全掌控二进制位置与权限。
第一步：下载并解压核心组件
从https://packages.clickhouse.com/tgz/stable/获取clickhouse-common-static、clickhouse-server、clickhouse-client三个TGZ包（忽略dbg包），执行：tar -zxvf clickhouse-common-static-*.tgz→sudo ./clickhouse-common-static-*/install/doinst.sh。
第二步：注册systemd服务
执行sudo /usr/bin/clickhouse-server --install，该命令会自动创建/etc/systemd/system/clickhouse-server.service并启用软链接；若提示No such file or directory，说明clickhouse-server包未解压或doinst.sh未执行。
第三步：设置系统资源限制
编辑/etc/security/limits.conf，追加：* soft nofile 65536* hard nofile 65536* soft nproc 131072* hard nproc 131072
不设此项，ClickHouse启动时会因打开文件数不足而崩溃退出。
首次启动与基础验证
无论采用哪种安装方式，完成安装后都必须执行以下操作：
执行sudo systemctl daemon-reload，确保systemd识别新服务单元。
启动服务：sudo systemctl start clickhouse-server，等待约10秒。
检查状态：sudo systemctl status clickhouse-server，确认显示active (running)且无failed字样。
连接测试：clickhouse-client --query="SELECT version()"，返回类似24.4.2.20即表示安装成功。
