v1.0.0

Estatísticas GitHub
além de 14 dias.

Dashboard auto-hospedado para seus repos — stars, forks, views e clones em 30, 60, 90 dias. Um binário. SQLite. Sem SaaS.

$ curl -fsSL https://get.gghstats.com/install.sh | sh
$ export GGHSTATS_GITHUB_TOKEN=ghp_xxx
$ gghstats run --open
curl -fsSL https://get.gghstats.com/install.sh | sh

// Visão geral

Infográfico: estatísticas permanentes de tráfego GitHub com gghstats versus o limite de 14 dias do GitHub — SQLite auto-hospedado, comparações head-to-head e implantação com Docker, Helm e Homebrew.

Baixe a infografia em alta resolução — sinta-se livre para compartilhar

Releases recentes

v1.0.02026-07-26

Stable
  • Caminho SQLite padrão estável (XDG / Application Support); GGHSTATS_DB sempre vence
  • Congelamento SPEC da API 1.x (apenas aditivos em minors)
  • IP do cliente no access log + fix da URL dash de alertas (/{owner}/{repo})

v0.11.02026-07-23

API
  • Modo API-only (GGHSTATS_API_ONLY) sem dashboard HTML nem rotas SEO
  • Rotas JSON dogfood para UIs externas (/api/v1/repos, h2h, charts) + CORS e CSP Report-Only
  • SYNC+: deltas de referrers/paths limitados por data após cada sync

v0.10.22026-07-22

Segurança
  • Proxies confiáveis controlam X-Forwarded-For / X-Real-IP para rate limit e whitelist
  • Timeouts HTTP do servidor (ReadHeader/Read/Write/Idle) no serve
  • Pin golang.org/x/net v0.57.0; cobertura de release ≥ 80%

Changelog completo no GitHub

// 01 · Auto-hospedado

Binário Go + SQLite. No bastion, laptop ou Raspberry Pi. Sem contas, sem rate limits, sem dashboards de terceiros.

// 02 · Além de 14 dias

A UI web do GitHub limita a 14 dias. gghstats grava snapshots e mostra tendências de 30+ dias por repo e agregadas.

// 03 · Um token GitHub

Defina GGHSTATS_GITHUB_TOKEN (PAT fine-grained). Com o dashboard em execução, o gghstats sincroniza o tráfego da API GitHub em segundo plano.

// Início rápido

Opcional: gere config pela CLI em vez de editar variáveis manualmente.

$ gghstats --print-sample-config > ./gghstats.env  # adjust
$ export GGHSTATS_GITHUB_TOKEN=ghp_xxx
$ gghstats run --open

`run` é alias de `serve`; `--open` abre o browser quando o dashboard está pronto. A sincronização em segundo plano começa automaticamente.

Produção (VPS, TLS, Compose, Traefik, Helm):gghstats-selfhosted

// Repositórios