Docker部署的Grafana无法连接ClickHouse数据源问题求助

1. 修正Grafana数据源的Server地址 #

在Grafana数据源配置中，Server address必须填写clickhouse:8123，而非localhost:8123或宿主机IP。原因如下：

• Docker Compose会自动为所有服务创建专属网络，服务名clickhouse可直接作为域名解析到对应容器IP。
• 填localhost时，Grafana容器会尝试访问自身的8123端口，而非ClickHouse容器；填宿主机IP可能因防火墙、容器网络转发规则导致超时。

2. 验证容器间网络连通性 #

执行以下命令确认Grafana容器能访问ClickHouse服务：

# 查看Grafana容器ID
docker compose ps grafana
# 进入Grafana容器并ping ClickHouse服务
docker exec -it <grafana-container-id> ping clickhouse

若能收到响应，说明网络连通正常；若不通，执行docker compose up -d重启所有服务后再试。

3. 确认ClickHouse用户配置生效 #

进入ClickHouse容器验证账号密码是否正确：

docker exec -it <clickhouse-container-id> clickhouse-client --user tymbaca --password qwerty

若能成功进入ClickHouse命令行，说明账号配置无误；若失败，检查环境变量是否正确设置，或取消注释users.xml挂载配置（如需自定义权限）。

4. 检查ClickHouse服务状态 #

确认ClickHouse容器正常运行且8123端口开放：

# 查看ClickHouse容器日志
docker compose logs clickhouse
# 测试宿主机访问ClickHouse（验证端口映射）
curl http://localhost:8123/?user=tymbaca&password=qwerty

若日志无报错，且curl能返回ClickHouse欢迎信息，说明服务运行正常。

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