Mac环境下ClickHouse服务器配置及连接失败问题咨询

核心原因 #

你通过curl https://clickhouse.com/ | sh下载的是自包含二进制包，它不会自动创建系统级的/etc/clickhouse-server目录（那是包管理器安装版本的路径）。默认情况下，ClickHouse二进制会优先从当前工作目录加载配置文件，而你没有生成必要的users.xml，导致默认用户认证失败。

解决步骤 #

1. 生成默认配置文件到当前目录 #

执行以下命令，将ClickHouse内置的默认配置（包括users.xml）复制到当前工作目录的config子文件夹：

./clickhouse install

执行后，你会在当前目录看到config文件夹，里面包含config.xml、users.xml等核心配置文件。

2. 修改users.xml配置认证规则 #

进入config目录，编辑users.xml：

cd config
vim users.xml

找到default用户的配置块，调整密码设置：

• 允许无密码登录（适合测试环境）：

  <users>
      <default>
          <password></password>
          <access_management>1</access_management> <!-- 允许后续通过SQL管理用户权限 -->
      </default>
  </users>
  

• 设置明文密码（不推荐生产环境）：

  <password>your_custom_password</password>
  

• 设置加密密码（推荐）：
  先执行命令生成密码哈希：

  ./clickhouse client --password="your_custom_password" --generate-new-password
  

  将输出的哈希值填入users.xml的password字段：

  <password>your_generated_hash</password>
  

3. 重启ClickHouse Server #

先终止之前运行的ClickHouse进程，再重新启动：

./clickhouse server

此时Server会加载当前目录config下的配置文件。

4. 连接ClickHouse Client #

• 无密码配置：直接执行

  ./clickhouse client
  

• 有密码配置：执行

  ./clickhouse client --password="your_custom_password"
  

额外说明 #

如果需要自定义配置文件路径，启动Server时可以通过参数指定：

./clickhouse server --config-file=/path/to/your/config.xml

注意：users.xml需要和指定的config.xml在同一目录，或者在config.xml中通过users_config字段单独指定路径。

内容的提问来源于stack exchange，提问作者Fonnae