Barelytics è un sistema di web analytics self-hosted per siti e applicazioni che hanno bisogno di statistiche di base senza inviare i dati a una piattaforma pubblicitaria o a un servizio analytics remoto. Registra conteggi aggregati delle visualizzazioni di pagina in un database SQLite locale. È pensato per siti personali e piccoli progetti web, non come sostituto delle piattaforme di analisi più ampie.
Codice sorgente, documentazione e istruzioni di installazione su GitHub · Licenza MIT.
Che cos’è Barelytics
Barelytics è un software open source di analisi del traffico web, scritto per essere installato e gestito dal proprietario del sito. Risponde a domande semplici e utili: quante visualizzazioni ha avuto una pagina, come cambia il traffico nel tempo e, se abilitate, da quali Paesi o domini di provenienza arrivano le visite. I report sono aggregati: Barelytics conta le pagine viste, non gli utenti unici.
L’obiettivo è offrire un’alternativa leggera e controllabile a Google Analytics e ad altri servizi di tracciamento quando non servono profili individuali, campagne o analisi comportamentali dettagliate. Non richiede un account presso un fornitore analytics e non trasmette i dati a un servizio Barelytics centralizzato.
Quali dati raccoglie e cosa significa “privacy-first”
Nella configurazione predefinita Strict Mode, Barelytics salva il percorso normalizzato della pagina, il giorno in UTC e il conteggio aggregato delle visualizzazioni. Non crea un identificatore persistente del visitatore e non memorizza indirizzi IP, cookie analytics, identificatori nel browser, stringhe User-Agent complete, query string o URL completi dei referrer.
Le dimensioni aggiuntive — per esempio Paese, dominio referrer, browser, dispositivo e sistema operativo — sono disattivate per impostazione predefinita e si possono abilitare singolarmente dall’amministrazione. Il filtro dei bot è euristico e può non riconoscere tutto il traffico automatizzato. L’amministratore può consultare un audit della privacy con impostazioni effettive, controlli e informazioni sullo schema del database.
“Senza cookie” e “privacy-friendly” descrivono scelte tecniche di minimizzazione dei dati, non una certificazione né una garanzia di conformità normativa. Chi gestisce il sito deve valutare gli obblighi applicabili al proprio pubblico, alla propria configurazione e alle giurisdizioni interessate.
Come si installa e si integra
Il progetto comprende un’implementazione PHP basata su PDO SQLite e pacchetti o integrazioni per Node.js/TypeScript, Python, .NET, Java, Ruby e WordPress. Le versioni supportate e le istruzioni specifiche possono cambiare: controlla sempre la documentazione del repository prima di installare.
- PHP su hosting condiviso: carica il pacchetto runtime via FTP/SFTP, completa l’installazione guidata dal browser e inserisci lo snippet nelle pagine. Per il percorso FTP non sono richiesti SSH, Composer, npm o un cron obbligatorio.
- Sito statico con endpoint PHP same-origin: usa lo snippet JavaScript fornito; la richiesta resta sullo stesso sito e l’archivio viene gestito dal runtime PHP.
- Applicazioni Node.js, Python, .NET, Java o Ruby: installa il pacchetto appropriato e integra il conteggio lato server. Questi runtime usano un database SQLite locale e non dipendono da un servizio remoto Barelytics.
- WordPress: il repository include un’integrazione plugin installabile; segui la relativa guida e usa una sola modalità di conteggio per pagina.
Per evitare doppi conteggi, registra una sola visualizzazione per risposta HTML: scegli l’integrazione lato server oppure lo snippet browser, senza attivarli entrambi sulla stessa pagina. Le integrazioni lato server dovrebbero escludere API, file statici, controlli di stato, feed e processi in background.
Documentazione: installazione, ricette per framework e integrazioni, aggiornamento e modello della privacy.
Requisiti e limiti da conoscere
- Il runtime PHP richiede PHP compatibile, PDO SQLite, JSON e sessioni PHP; l’installer verifica l’ambiente. Usa HTTPS prima di inserire credenziali in produzione.
- Il database SQLite deve risiedere su storage persistente, scrivibile e privato. Filesystem effimeri di ambienti serverless o edge non sono adatti.
- Barelytics offre statistiche aggregate essenziali, non metriche di visitatori unici, registrazioni delle sessioni, mappe di calore o attribuzione pubblicitaria.
- Il filtro dei bot è basato su euristiche; i risultati possono includere o escludere alcune richieste automatizzate.
- La presenza del software non determina da sola quali informative, consensi o altre misure siano necessari per il tuo sito.
Domande frequenti su Barelytics
Barelytics usa cookie o traccia i visitatori?
Strict Mode, attivo per impostazione predefinita, non usa cookie analytics, identificatori persistenti o fingerprinting. Conta visualizzazioni aggregate. Le dimensioni opzionali vanno abilitate dall’amministratore.
Barelytics è un’alternativa self-hosted a Google Analytics?
Può esserlo per chi ha bisogno di conteggi di pagine e andamenti di base sotto il proprio controllo. Non sostituisce tutte le funzioni di Google Analytics o di piattaforme di prodotto e marketing: non è progettato per profili individuali o attribuzione avanzata.
Posso installare Barelytics con il solo FTP?
Sì, per il pacchetto PHP su un hosting compatibile: la guida descrive il caricamento FTP/SFTP e la configurazione via browser, senza shell, Composer, npm o cron obbligatorio. Servono PHP con PDO SQLite e storage persistente.
È adatto a hosting serverless o edge?
Non quando il filesystem SQLite è effimero. Tutte le integrazioni richiedono un percorso dati persistente che sopravviva ai riavvii e alle distribuzioni.
Barelytics garantisce la conformità al GDPR?
No. Riduce la raccolta di dati e offre impostazioni verificabili, ma non fornisce una garanzia legale. La valutazione dipende anche dall’uso concreto, dalla configurazione e dalla giurisdizione del sito.
Dove trovo codice, licenza e guide?
Nel repository Barelytics su GitHub: codice sorgente con licenza MIT, guide d’installazione, pacchetti, integrazioni e modello privacy.