ContentSquare/chproxy
Open-Source ClickHouse http proxy and load balancer observed · 2026-08-28
Health v2 · maintenance only
71/100
- Activity 77
- Release rhythm 47
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-02. Adoption (stars, forks) is never an input.
- gap_med: 29
- age_days: 3271
- days_rel: 357
- days_push: 140
- n_releases_24m: 10
Adoption not part of the score
1480 stars · 277 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
Chproxy is an open-source HTTP proxy and load balancer for ClickHouse databases, written in Go. It routes requests across multiple ClickHouse clusters, maps and hides credentials, enforces per-user limits, caches responses, and exposes Prometheus metrics.
Use cases
- proxy http requests to multiple clickhouse clusters
- load balance queries across clickhouse replicas
- hide real clickhouse credentials behind mapped proxy users
- rate limit and cap concurrent queries per user
- cache clickhouse query responses with thundering herd protection
- expose prometheus metrics for a clickhouse proxy
When to choose
- you serve ClickHouse over HTTP and need load balancing, user mapping, and per-user quotas in one gateway
- you need response caching, IP allowlists, or automatic HTTPS via Let's Encrypt in front of ClickHouse
- you want a battle-tested, production-ready proxy with Prometheus metrics and hot config reload
When to avoid
- you need the ClickHouse native protocol - chproxy only proxies HTTP
- you prefer inserting data directly without a proxy, since native protocol inserts are faster
- you need a generic proxy for databases other than ClickHouse
Facets
service · maturity active
proxy load-testing caching rate-limiting auth monitoring http-server databases backend self-hosted analytics go self-hosted cross-platform clickhouse load-balancer http-proxy reverse-proxy prometheus-metrics lets-encrypt linux macos docker
5 sources
- readme: https://github.com/ContentSquare/chproxy · fetched 2026-08-28 · c7f6703c7c24
- homepage: https://www.chproxy.org/ · fetched 2026-08-29 · 54292df1d685
- site_page: https://www.chproxy.org/install · fetched 2026-08-29 · b5620be4740d
- site_page: https://www.chproxy.org/changelog · fetched 2026-08-29 · bf0a165d6b32
- site_page: https://www.chproxy.org/faq · fetched 2026-08-29 · 6f0a8d631bc9
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| ContentSquare/chproxy | main | 71 |
For agents
markdown · JSON · MCP: product_card(name="ContentSquare/chproxy")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem