Πώς να κάνετε self-host το Fathom Lite το 2026: tracking script, SQLite και privacy

Υπάρχουν δύο εκδοχές του «τρέχω το Fathom Lite»: είτε υπάρχει ένα container είτε η υπηρεσία ολοκληρώνει την πραγματική της δουλειά. Μόνο η δεύτερη έχει σημασία. Εδώ, η απόδειξη είναι να προσθέσετε ένα site, να φορτώσετε το tracking script σε μια δοκιμαστική σελίδα, να δημιουργήσετε επισκέψεις και να επιβεβαιώσετε ότι το dashboard τις καταγράφει χωρίς cookies.

Το Fathom Lite εξυπηρετεί ακριβώς αυτόν τον σκοπό: analytics για page views χωρίς cookies, με self-hosting. Το deployment πρέπει να διατηρεί τα στοιχεία που κάνουν εφικτή αυτή τη συμπεριφορά· ένα port, ένα volume και ένα certificate είναι προϋποθέσεις, όχι το τελικό αποτέλεσμα.

Credentials, ρόλοι και εκτεθειμένες επιφάνειες

Για το Fathom Lite, η σημαντική επιφάνεια δεν είναι απαραίτητα η landing page. Το βασικό λάθος είναι να επαναχρησιμοποιήσετε ένα secret από παράδειγμα ή να εκθέσετε το admin login χωρίς TLS. Αντιμετωπίστε το σκόπιμα: προστατεύστε το analytics login, διατηρήστε σταθερό το application secret και δημοσιεύστε το script μόνο από το αναμενόμενο HTTPS host.

Αντιμετωπίστε το FATHOM_SECRET σύμφωνα με τον ρόλο του στο Fathom Lite: κρατήστε τις ευαίσθητες τιμές εκτός Git, τεκμηριώστε τις επιπτώσεις του rotation και μην αντικαταστήσετε ποτέ ένα public example σε production. Χρησιμοποιήστε unprivileged container user όταν το image το υποστηρίζει και μην κάνετε mount άσχετα credentials. Εφαρμόστε rate ή size limits στο ingress, όπου μη έμπιστη εργασία μπορεί να καταναλώσει ρυθμό εγγραφής page views, database indexes, retention και τη network path από τα browsers των επισκεπτών.

Διαχωρίστε το Fathom Lite από τα dependencies του

Η μικρότερη υπεύθυνη τοπολογία του Fathom Lite περιλαμβάνει έναν private listener στο 8080, ένα ingress route και ένα τεκμηριωμένο state boundary. Το network contract για το Fathom Lite είναι το SQLite ή μια υποστηριζόμενη external database και η σωστή τοποθέτηση του script στο site του client. Κρατήστε τα private endpoints σε internal DNS, επιτρέψτε μόνο τις απαραίτητες outbound κλήσεις και δώστε στο Fathom Lite ένα scoped service credential.

Επικυρώστε την τοπολογία ζητώντας από έναν clean client να προσθέσει ένα site, να φορτώσει το tracking script σε μια δοκιμαστική σελίδα, να δημιουργήσει επισκέψεις και να επιβεβαιώσει ότι το dashboard τις καταγράφει χωρίς cookies. Παρακολουθήστε τον ρυθμό εγγραφής page views, τα database indexes, το retention και τη network path από τα browsers των επισκεπτών όσο εκτελείται. Το αποτέλεσμα δείχνει αν η επόμενη βελτίωση αφορά τη μνήμη, το storage, το networking ή έναν ξεχωριστό worker, αντί να ενθαρρύνει αυθαίρετη διαμόρφωση των containers.

Ένα Docker baseline για το Fathom Lite

Μια minimal εντολή είναι χρήσιμη όταν αποκαλύπτει τι θα διαχειρίζεται αργότερα η πλατφόρμα.

docker run -d \
  --name fathom-lite \
  --restart unless-stopped \
  -p 127.0.0.1:8080:8080 \
  -v fathom-lite-data:/app \
  -e FATHOM_SECRET=replace-with-a-long-random-value \
  -e FATHOM_SERVER_ADDR=:8080 \
  -e FATHOM_DATABASE_DRIVER=sqlite3 \
  -e FATHOM_DATABASE_NAME=/app/fathom.db \
  usefathom/fathom:latest

Εδώ το port 8080 παραμένει private στον host και κάθε απαιτούμενη διαδρομή δηλώνεται ρητά. Προσθέστε τις ελεγμένες ρυθμίσεις σύνδεσης για SQLite ή μια υποστηριζόμενη external database και τη σωστή τοποθέτηση του script στο site του client· χρησιμοποιήστε private names για private services. Επαληθεύστε την εκκίνηση τόσο από τα logs όσο και με το application-specific proof: προσθέστε ένα site, φορτώστε το tracking script σε μια δοκιμαστική σελίδα, δημιουργήστε επισκέψεις και επιβεβαιώστε ότι το dashboard τις καταγράφει χωρίς cookies. Αφού ολοκληρωθεί η επαλήθευση, κλειδώστε την έκδοση του image, ώστε μια routine αντικατάσταση να μην αλλάξει αθόρυβα τη συμπεριφορά.

Αποδείξτε το deployment του Fathom Lite end to end

Δημιουργήστε ένα μικρό, προσωρινό fixture του Fathom Lite και διατηρήστε το για κάθε release. Το fixture πρέπει να ελέγχει το πραγματικό workflow: προσθήκη site, φόρτωση του tracking script σε μια δοκιμαστική σελίδα, δημιουργία επισκέψεων και επιβεβαίωση ότι το dashboard τις καταγράφει χωρίς cookies. Καταγράψτε το image digest, το external hostname, τη διεύθυνση του dependency και το αναμενόμενο αποτέλεσμα, ώστε ένας επόμενος operator να μπορεί να επαναλάβει το test χωρίς να χρειάζεται να ερμηνεύσει αυτόν τον οδηγό.

Εκτελέστε το fixture τρεις φορές. Αρχικά, χρησιμοποιήστε το fresh deployment. Στη συνέχεια, αντικαταστήστε το container χωρίς να αγγίξετε το durable state. Τέλος, κάντε restore το backup σε ένα empty environment. Η τρίτη εκτέλεση περνά μόνο όταν επιστρέψουν τα sites, οι users και τα historical page views και εμφανιστεί μια νέα δοκιμαστική επίσκεψη μετά το recovery. Σε κάθε εκτέλεση, καταγράψτε το latency και τη χρήση πόρων γύρω από τον ρυθμό εγγραφής page views, τα database indexes, το retention και τη network path από τα browsers των επισκεπτών· αυτό αποτελεί baseline για τα alerts αντί για ένα αυθαίρετο ποσοστό CPU.

Τέλος, ελέγξτε σκόπιμα το negative path: αρνηθείτε προσωρινά στην test identity την πρόσβαση στο SQLite ή σε μια υποστηριζόμενη external database και στη σωστή τοποθέτηση του script στο site του client. Επιβεβαιώστε ότι το Fathom Lite αποτυγχάνει εμφανώς χωρίς να καταστρέφει το state, αποκαταστήστε τη σωστή συνθήκη και επαναλάβετε το successful transaction. Ένα release record που περιλαμβάνει αυτά τα τέσσερα αποτελέσματα αποτελεί ισχυρότερη απόδειξη από screenshots ενός dashboard ή από ένα one-time curl response.

Κρατήστε ξεχωριστά τα internal και external URLs

Το public boundary του Fathom Lite πρέπει να είναι ένα canonical hostname, automatic TLS και ένας internal target στο 8080. Ορίστε τη διεύθυνση του server και το public HTTPS endpoint που χρησιμοποιεί το tracking script, ώστε οι clients να επιστρέφουν σε μια διεύθυνση που αναγνωρίζει η υπηρεσία.

Αν αποτύχει το acceptance transaction, ταξινομήστε το πρώτο error. Τα προβλήματα DNS, certificate και 502 ανήκουν στο TLS validation checklist. Η συνθήκη «το tracking script δείχνει σε λάθος hostname ή το database path είναι ephemeral» ανήκει στην πλευρά της εφαρμογής, αφού ένα request έχει φτάσει επιτυχώς στο Fathom Lite.

Failure drills για το Fathom Lite

Τα capacity tests πρέπει να ελέγχουν τον ρυθμό εγγραφής page views, τα database indexes, το retention και τη network path από τα browsers των επισκεπτών, όχι ένα επαναλαμβανόμενο request στο /. Εκτελέστε το σενάριο «προσθέστε ένα site, φορτώστε το tracking script σε μια δοκιμαστική σελίδα, δημιουργήστε επισκέψεις και επιβεβαιώστε ότι το dashboard τις καταγράφει χωρίς cookies» με ρεαλιστικό concurrency και καταγράψτε latency, error rate και storage growth.

Ο σχεδιασμός του upgrade πρέπει να λαμβάνει υπόψη αυτόν τον κίνδυνο: το database schema και το tracking script του Fathom πρέπει να ελέγχονται μαζί, ώστε να μην χαθούν αθόρυβα events. Ελέγξτε το νέο release με representative input, επαναλάβετε το acceptance transaction και συγκρίνετε το αποτέλεσμα. Αν το tracking script δείχνει σε λάθος hostname ή το database path είναι ephemeral, καταγράψτε το failing transaction και εξετάστε το πρώτο boundary που εμπλέκεται, αντί να θεωρήσετε ότι ευθύνεται το ingress.

Αποδείξτε ότι το Fathom Lite επιβιώνει σε αντικατάσταση

Ένα container image μπορεί να γίνει ξανά download· η analytics database, η διαμόρφωση των sites και το administrator state όχι. Κάντε mount το /app πριν από το bootstrap, γράψτε harmless sample data και αντικαταστήστε το container, ώστε να αποδείξετε ότι η συγκεκριμένη διαδρομή είναι πράγματι persistent. Ελέγξτε το effective mount αντί να εμπιστευτείτε ένα όνομα Compose file και βεβαιωθείτε ότι ο runtime user μπορεί να γράψει εκεί όπου αναμένει το Fathom Lite.

Επιλέξτε retention και έναν off-host προορισμό και, στη συνέχεια, κάντε rehearsal του recovery χωρίς να αγγίξετε το production. Το drill περνά μόνο όταν επιστρέψουν τα sites, οι users και τα historical page views και εμφανιστεί μια νέα δοκιμαστική επίσκεψη μετά το recovery. Για state που βασίζεται σε database, συνδυάστε storage snapshots με application-consistent exports, όπως περιγράφεται στο point-in-time recovery versus snapshots.

Συνδέστε το Fathom Lite στον κύκλο ζωής του Dockup

Το one-click deployment του Fathom Lite στο Dockup πρέπει να κάνει την αντικατάσταση ασφαλή: το route συνεχίζει να δείχνει στο 8080, τα secrets δεν ενσωματώνονται στο image και τα persistent paths επιστρέφουν στο νέο container. Το ίδιο deployment μπορεί να εκτελείται σε Dockup compute ή σε συνδεδεμένο μηχάνημα.

Ολοκληρώστε την εργασία ειδικά για την εφαρμογή συνδέοντας και ελέγχοντας το SQLite ή μια υποστηριζόμενη external database και τη σωστή τοποθέτηση του script στο site του client, εφαρμόζοντας την canonical public address και εκτελώντας αυτόν τον acceptance check: προσθέστε ένα site, φορτώστε το tracking script σε μια δοκιμαστική σελίδα, δημιουργήστε επισκέψεις και επιβεβαιώστε ότι το dashboard τις καταγράφει χωρίς cookies. Προσθέστε το αποτέλεσμα του restore στο runbook πριν φτάσουν οι πραγματικοί users.

Συχνές ερωτήσεις

Τι χρειάζεται το Fathom Lite για deployment σε production;

Δρομολογήστε το Fathom Lite container στο port 8080 μέσω ενός HTTPS origin. Η υποστηρικτική network requirement είναι το SQLite ή μια υποστηριζόμενη external database και η σωστή τοποθέτηση του script στο site του client. Μην θεωρήσετε έτοιμο το Fathom Lite μέχρι να μπορείτε να προσθέσετε ένα site, να φορτώσετε το tracking script σε μια δοκιμαστική σελίδα, να δημιουργήσετε επισκέψεις και να επιβεβαιώσετε ότι το dashboard τις καταγράφει χωρίς cookies.

Ποια δεδομένα του Fathom Lite πρέπει να περιλαμβάνονται σε backup;

Κάντε persist το /app και συμπεριλάβετε την analytics database, τη διαμόρφωση των sites και το administrator state στο ίδιο recovery manifest. Ένα clean restore του Fathom Lite ολοκληρώνεται μόνο όταν επιστρέψουν τα sites, οι users και τα historical page views και εμφανιστεί μια νέα δοκιμαστική επίσκεψη μετά το recovery.

Απαιτεί το Fathom Lite HTTPS πίσω από reverse proxy;

Χρησιμοποιήστε HTTPS για το public origin του Fathom Lite και διατηρήστε το port 8080 στο internal route. Εφαρμόστε σωστά τη ρύθμιση του Fathom Lite: ορίστε τη διεύθυνση του server και το public HTTPS endpoint που χρησιμοποιεί το tracking script. Για το Fathom Lite, το HTTPS προστατεύει τα credentials ή το περιεχόμενο των users κατά τη μεταφορά και διατηρεί συνεπή τη συμπεριφορά του client που εξαρτάται από το origin.

Πώς πρέπει να ελεγχθεί ένα upgrade του Fathom Lite;

Κάντε restore το τρέχον state του Fathom Lite σε ένα isolated deployment, εφαρμόστε την candidate version και επαναλάβετε το acceptance transaction. Δώστε ιδιαίτερη προσοχή, επειδή το database schema και το tracking script του Fathom πρέπει να ελέγχονται μαζί, ώστε να μην χαθούν αθόρυβα events. Διατηρήστε το προηγούμενο Fathom Lite image μέχρι να κατανοήσετε τα όρια του data migration και του rollback.