Φιλοξενήστε το Umami σε Managed VPS: τα στατιστικά web σας στον διακομιστή σας

Τι κάνει το Umami

Το Umami είναι μια πλατφόρμα ανοιχτού κώδικα για στατιστικά web και προϊόντος. Η τεκμηρίωσή του περιγράφει ένα εργαλείο που συγκεντρώνει την επισκεψιμότητα, τις καμπάνιες, τη συμπεριφορά των επισκεπτών, τις μετατροπές, τη διατήρηση και τα έσοδα, από την πρώτη επίσκεψη ως τα αποτελέσματα που μετρούν για την επιχείρησή σας. Είναι γραμμένο σε TypeScript πάνω στο Next.js, και η εικόνα Docker του τρέχει με λογαριασμό χωρίς προνόμια.

• Η απόκτηση: προβολές σελίδων, επισκέπτες, παραπομπές, χώρες, συσκευές και δραστηριότητα σε πραγματικό χρόνο, με καμπάνιες UTM, σύντομους συνδέσμους και pixel παρακολούθησης.
• Η συμπεριφορά: προσαρμοσμένα γεγονότα, διαδρομές, επαναλήψεις συνεδριών, θερμικοί χάρτες, τμήματα, κοόρτες και διατήρηση.
• Η μετατροπή: στόχοι, χωνιά, απόδοση και παρακολούθηση εσόδων ανά σελίδα και ανά καμπάνια.
• Η κοινή χρήση: πίνακες, ομάδες, ένα δημόσιο URL κοινής χρήσης, ένα API και ένας διακομιστής MCP μόνο για ανάγνωση για τον βοηθό AI σας.
• Οι σύγχρονοι ιστότοποι: οι συχνές ερωτήσεις αναφέρουν ότι το Umami παρακολουθεί μόνο του την πλοήγηση στις εφαρμογές μίας σελίδας (SPA), χωρίς καμία πρόσθετη ρύθμιση.

Ένα στιγμιότυπο παρακολουθεί πολλούς ιστότοπους: ο καθένας παίρνει το δικό του αναγνωριστικό και script παρακολούθησης, και οι συνάδελφοί σας βρίσκουν τον δρόμο τους μέσω λογαριασμών και ομάδων.

Τι επιτρέπει η άδεια MIT

Το Umami δημοσιεύεται με την άδεια MIT, στο όνομα της Umami Software, Inc. Παραχωρεί, δωρεάν, το δικαίωμα χρήσης, αντιγραφής, τροποποίησης, συγχώνευσης, δημοσίευσης, διανομής, παραχώρησης υποάδειας και πώλησης αντιγράφων του λογισμικού. Μπορείτε λοιπόν να το τρέχετε για την επιχείρησή σας και για τους ιστότοπους των πελατών σας, χωρίς να αγοράσετε άδεια.

Ο μόνος όρος της: η σημείωση πνευματικών δικαιωμάτων και η σημείωση άδειας συνοδεύουν όλα τα αντίγραφα ή κάθε σημαντικό τμήμα του λογισμικού. Όπως κάθε άδεια MIT, παρέχει το λογισμικό «ως έχει», χωρίς εγγύηση.

Cookies και προσωπικά δεδομένα: τι λέει το έργο

Η τεκμηρίωση παρουσιάζει το Umami ως στατιστικά χωρίς cookies, χωρίς παρακολούθηση από ιστότοπο σε ιστότοπο και χωρίς αυτόματη συλλογή προσωπικών δεδομένων. Σε self-hosting, κρατά τα στατιστικά σας στον δικό σας διακομιστή: εσείς αποφασίζετε πού βρίσκονται και πόσο καιρό μένουν.

Τρεις ρυθμίσεις του script παρακολούθησης πάνε πιο μακριά, αν το επιθυμείτε: το data-exclude-search αφαιρεί τις παραμέτρους αναζήτησης από τα καταγεγραμμένα URL, το data-exclude-hash αφαιρεί το hash, και το data-do-not-track απενεργοποιεί την παρακολούθηση για τους περιηγητές που εκθέτουν την προτίμηση Do Not Track. Η τεκμηρίωση σημειώνει ότι αυτή η τελευταία ρύθμιση δεν αποτελεί, από μόνη της, πλήρη λύση διαχείρισης συγκατάθεσης.

Αν ταυτοποιείτε τους συνδεδεμένους επισκέπτες με data-distinct-id ή umami.identify(), η τεκμηρίωση συνιστά ένα εσωτερικό αναγνωριστικό χρήστη ή ένα hash αντί για μια διεύθυνση email: η τιμή διαβάζεται στο HTML της σελίδας.

Εγκατάσταση με Docker Compose και PostgreSQL

Το αποθετήριο παρέχει ένα docker-compose.yml που ξεκινά το Umami και τη βάση PostgreSQL του. Από την έκδοση 3, η PostgreSQL είναι η μόνη υποστηριζόμενη βάση, στην έκδοση 12.14 τουλάχιστον, και η τεκμηρίωση συνιστά να τη ρυθμίσετε στη ζώνη ώρας UTC. Σε έναν διακομιστή όπου είναι εγκατεστημένο το Docker, δημιουργήστε έναν φάκελο και ξεκινήστε από τα μυστικά του, που δημιουργούνται τυχαία με το openssl, όπως προτείνει η τεκμηρίωση:

cat > .env <<EOF
POSTGRES_PASSWORD=$(openssl rand -hex 24)
APP_SECRET=$(openssl rand -hex 32)
TWO_FACTOR_ENCRYPTION_KEY=$(openssl rand -hex 32)
EOF
chmod 600 .env

Τοποθετήστε έπειτα δίπλα του το παρακάτω compose.yaml. Ακολουθεί το αρχείο του έργου στην έκδοση 3.4.1, με δύο αλλαγές: τα μυστικά έρχονται από το αρχείο .env, και η θύρα δημοσιεύεται μόνο στο 127.0.0.1.

services:
  umami:
    image: ghcr.io/umami-software/umami:latest
    ports:
      - "127.0.0.1:3000:3000"
    environment:
      DATABASE_URL: postgresql://umami:${POSTGRES_PASSWORD}@db:5432/umami
      APP_SECRET: ${APP_SECRET}
      TWO_FACTOR_ENCRYPTION_KEY: ${TWO_FACTOR_ENCRYPTION_KEY}
    depends_on:
      db:
        condition: service_healthy
    init: true
    restart: always
    healthcheck:
      test: ["CMD-SHELL", "curl http://localhost:3000/api/heartbeat"]
      interval: 5s
      timeout: 5s
      retries: 5
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: umami
      POSTGRES_USER: umami
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - umami-db-data:/var/lib/postgresql/data
    restart: always
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 5
volumes:
  umami-db-data:

docker compose up -d
curl -s http://127.0.0.1:3000/api/heartbeat

• Το DATABASE_URL: η μόνη υποχρεωτική μεταβλητή, η συμβολοσειρά σύνδεσης με τη βάση. Ο δεκαεξαδικός κωδικός πρόσβασης μπαίνει όπως είναι· ένας κωδικός με ειδικούς χαρακτήρες θα χρειαζόταν κωδικοποίηση ποσοστού (percent-encoding).
• Το APP_SECRET: μια τυχαία συμβολοσειρά που ασφαλίζει τα token ελέγχου ταυτότητας, μοναδική για κάθε εγκατάσταση. Στον κώδικα της έκδοσης 3.4.1, μπαίνει επίσης στον υπολογισμό των αναγνωριστικών συνεδρίας: κρατήστε το σταθερό.
• Το TWO_FACTOR_ENCRYPTION_KEY: 64 δεκαεξαδικοί χαρακτήρες που κρυπτογραφούν τα μυστικά του ελέγχου ταυτότητας δύο παραγόντων. Χωρίς αυτό, κανείς δεν μπορεί να ενεργοποιήσει τον έλεγχο ταυτότητας δύο παραγόντων.
• Κατά την εκκίνηση, το κοντέινερ ελέγχει τη σύνδεση και την έκδοση της βάσης, και έπειτα εφαρμόζει μόνο του τις μεταπτώσεις του σχήματος. Στην πρώτη εκτέλεση, δημιουργεί τους πίνακες και τον λογαριασμό admin. Ο έλεγχος /api/heartbeat απαντά {"ok":true} μόλις το Umami είναι έτοιμο.
• Η ετικέτα latest ακολουθεί την τελευταία δημοσιευμένη έκδοση. Το μητρώο του έργου δημοσιεύει επίσης ετικέτες εκδόσεων, όπως η 3.4.1, για να καθηλώσετε αυτή που τρέχετε.

Η τεκμηρίωση εγκατάστασης δεν δίνει αριθμούς για τη μνήμη ή τον επεξεργαστή. Το μέγεθος εξαρτάται από την επισκεψιμότητα των ιστότοπων που παρακολουθούνται και από τον όγκο των δεδομένων που κρατάτε. Σε ένα Managed VPS, περιγράψτε μας τη χρήση σας και σας προτείνουμε το μέγεθος που ταιριάζει.

HTTPS: ο reverse proxy

Το Umami ακούει σε HTTP στη θύρα 3000, και η τεκμηρίωση προτείνει να το σερβίρετε πίσω από τον web server σας, μέσω ενός reverse proxy. Δώστε του δικό του υποτομέα, όπως το stats.example.com, που δείχνει στον διακομιστή με εγγραφές A και AAAA. Για να σερβιριστεί το Umami κάτω από μια διαδρομή χρειάζεται το BASE_PATH, μια μεταβλητή που διαβάζεται όταν χτίζεται η εφαρμογή: με τη δημοσιευμένη εικόνα, ο υποτομέας είναι ο άμεσος δρόμος.

Ο proxy πρέπει επίσης να μεταβιβάζει τη διεύθυνση του επισκέπτη. Το Umami τη διαβάζει από τις κεφαλίδες που λαμβάνει, μεταξύ των οποίων οι X-Real-IP και X-Forwarded-For: τη χρησιμοποιεί για να ξεχωρίζει τους επισκέπτες και να εντοπίζει τη χώρα τους. Αν ο proxy σας χρησιμοποιεί άλλη κεφαλίδα, το CLIENT_IP_HEADER την ονομάζει.

Με Caddy

Το Caddy αποκτά το πιστοποιητικό Let’s Encrypt και ενεργοποιεί μόνο του το HTTPS. Η οδηγία του reverse_proxy ορίζει εξ ορισμού το X-Forwarded-For: αυτές οι τρεις γραμμές αρκούν.

stats.example.com {
  reverse_proxy 127.0.0.1:3000
}

Με Nginx και Certbot

Το μπλοκ αυτό ακολουθεί το παράδειγμα Nginx της τεκμηρίωσης του Umami, και ακούει στη θύρα 80 ώστε να αφήσει το Certbot να στήσει το HTTPS:

server {
  listen 80;
  listen [::]:80;
  server_name stats.example.com;

  location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
}

Το Certbot εγκαθιστά έπειτα το πιστοποιητικό και φροντίζει να το ανανεώνει:

sudo certbot --nginx

Η πρώτη σύνδεση: ο λογαριασμός admin και ο έλεγχος ταυτότητας δύο παραγόντων

Όταν δημιουργεί τη βάση του, το Umami ανοίγει έναν λογαριασμό διαχειριστή: όνομα χρήστη admin, κωδικός πρόσβασης umami. Η τεκμηρίωση ζητά να αλλάξετε αυτόν τον κωδικό στην πρώτη σας σύνδεση.

1. Ανοίξτε τη διεύθυνσή σας HTTPS και συνδεθείτε με admin και umami.
2. Ανοίξτε το Settings από το κουμπί του προφίλ στην πλαϊνή στήλη, έπειτα το Profile, και κάντε κλικ στο Change password.
3. Στην καρτέλα Security, ενεργοποιήστε τον έλεγχο ταυτότητας δύο παραγόντων: σαρώστε τον κωδικό QR με την εφαρμογή ελέγχου ταυτότητας, εισαγάγετε τον εξαψήφιο κωδικό, και φυλάξτε σε ασφαλές σημείο τους δέκα εφεδρικούς κωδικούς, που εμφανίζονται μόνο μία φορά.

• Υποχρεωτικός έλεγχος ταυτότητας δύο παραγόντων: ένας διαχειριστής μπορεί να τον επιβάλει σε ολόκληρο το στιγμιότυπο, σε έναν χρήστη ή σε μια ομάδα, από τις σελίδες διαχείρισης.
• Οι προσπάθειες: πέντε λάθος κωδικοί κλειδώνουν τις νέες προσπάθειες για 15 λεπτά.
• Οι λογαριασμοί της ομάδας σας: οι σελίδες διαχείρισης διαχειρίζονται τους χρήστες, τους ιστότοπους και τις ομάδες ολόκληρου του στιγμιοτύπου.

Κρατήστε το TWO_FACTOR_ENCRYPTION_KEY μαζί με τα αντίγραφα ασφαλείας σας: η τεκμηρίωση προειδοποιεί ότι η απώλεια ή η αλλαγή αυτού του κλειδιού καθιστά μη αναγνώσιμα τα αποθηκευμένα μυστικά, και κάθε χρήστης πρέπει τότε να εγγραφεί ξανά στον έλεγχο ταυτότητας δύο παραγόντων.

Προσθήκη ενός ιστότοπου και του script παρακολούθησής του

1. Στο Websites, κάντε κλικ στο Add website.
2. Δώστε στον ιστότοπο ένα όνομα, και έπειτα τον τομέα του: το Umami τον χρησιμοποιεί για να αφαιρεί τις δικές σας σελίδες από τη λίστα των παραπομπών.
3. Ανοίξτε το Edit σε αυτόν τον ιστότοπο και αντιγράψτε τον κώδικα από την ενότητα Tracking code.
4. Επικολλήστε τον στο <head> των σελίδων σας, και έπειτα επισκεφθείτε τον ιστότοπό σας: τα δεδομένα εμφανίζονται αμέσως στον πίνακα ελέγχου.

<script defer src="https://stats.example.com/script.js" data-website-id="your-website-id"></script>

• Δεν εμφανίζεται τίποτα; Η τεκμηρίωση προτείνει την καρτέλα δικτύου των εργαλείων ανάπτυξης του περιηγητή: τα αιτήματα προς το στιγμιότυπό σας πρέπει να φεύγουν χωρίς σφάλματα.
• Next.js: προσθέστε τον κώδικα με το component next/script αντί για μια απλή ετικέτα <script>.
• Το data-domains περιορίζει την παρακολούθηση στους τομείς παραγωγής σας, πράγμα που κρατά τα περιβάλλοντα δοκιμών σας έξω από τα στατιστικά.
• Οι δικές σας επισκέψεις εξαιρούνται ιστότοπο προς ιστότοπο, από την κονσόλα του περιηγητή, με localStorage.setItem('umami.disabled', 1).

Ένα δικό σας όνομα για το script

Ορισμένοι αποκλειστές διαφημίσεων μπλοκάρουν ό,τι μοιάζει με στατιστικά. Σε self-hosting, το Umami σερβίρεται ήδη από τον δικό σας τομέα, και δύο μεταβλητές πάνε πιο μακριά: το TRACKER_SCRIPT_NAME δίνει στο script άλλο όνομα από το script.js, και το COLLECT_API_ENDPOINT μετονομάζει το endpoint συλλογής, στη θέση του /api/send. Το script καλεί έπειτα μόνο του το νέο endpoint· στις σελίδες σας αλλάζει μόνο η πηγή του κώδικα παρακολούθησης.

TRACKER_SCRIPT_NAME: "stats.js"
COLLECT_API_ENDPOINT: "/api/collect"

Χρήσιμες ρυθμίσεις

Αυτές οι μεταβλητές περιβάλλοντος μπαίνουν στην υπηρεσία umami του compose.yaml, και έπειτα το docker compose up -d δημιουργεί ξανά το κοντέινερ για να τις λάβει υπόψη:

Τα αντίγραφα ασφαλείας

Όλα όσα κρατά το Umami βρίσκονται στη βάση PostgreSQL του: λογαριασμοί, ιστότοποι, ομάδες και στατιστικά. Εξάγετέ τη κάθε ημέρα και λίγο πριν από κάθε ενημέρωση: σε self-hosting, τα δεδομένα αυτά διατηρούνται χωρίς χρονικό όριο. Δίπλα στη βάση, το αρχείο .env κρατά τα μυστικά που την κάνουν αξιοποιήσιμη:

Εξαγωγή της βάσης ενώ λειτουργεί

Το pg_dump κάνει μια συνεπή εξαγωγή ενώ η βάση χρησιμοποιείται. Η προσαρμοσμένη μορφή, -Fc, είναι συμπιεσμένη και επαναφέρεται με το pg_restore:

docker compose exec -T db pg_dump -U umami -d umami -Fc > umami-$(date +%F).dump

Προγραμματίστε αυτή την εντολή στον διακομιστή τουλάχιστον μία φορά την ημέρα, κάντε διαλογή στις εξαγωγές, που συσσωρεύονται, και στείλτε ένα αντίγραφο αλλού. Αποθηκευμένες στον δίσκο του διακομιστή, οι εξαγωγές αυτές μπαίνουν και στα νυχτερινά αντίγραφα ασφαλείας του.

Επαναφορά

1. Σταματήστε το Umami, αφήνοντας τη βάση σε λειτουργία: docker compose stop umami.
2. Επαναφέρετε την εξαγωγή στη βάση, αντικαθιστώντας τα υπάρχοντα αντικείμενα.
3. Ξεκινήστε ξανά το Umami, και έπειτα ελέγξτε ότι οι ιστότοποί σας και τα στατιστικά τους είναι στη θέση τους.

docker compose stop umami
docker compose exec -T db pg_restore -U umami -d umami --clean --if-exists < umami-YYYY-MM-DD.dump
docker compose start umami

Επαναλαμβάνετε την άσκηση αυτή κατά διαστήματα, σε ένα αντίγραφο: έτσι βεβαιώνεστε ότι ένα αντίγραφο ασφαλείας λειτουργεί.

Οι ενημερώσεις

Η τεκμηρίωση δίνει δύο εντολές, από τον φάκελο του compose.yaml. Η βάση μένει στον τόμο της:

docker compose pull
docker compose up --force-recreate -d

Κατά την επανεκκίνηση, το κοντέινερ εφαρμόζει μόνο του τις μεταπτώσεις του σχήματος. Η έκδοση 3.4.0, της 17ης Σεπτεμβρίου 2026, περιείχε δύο, για τις σημειώσεις και τα κλειδιά API· η έκδοση 3.4.1, της 23ης Οκτωβρίου 2026, δεν περιέχει καμία. Μετά από μια μεγάλη αναβάθμιση, όπως η μετάβαση στην έκδοση 3, η τεκμηρίωση προτείνει να εκτελέσετε ANALYZE στην PostgreSQL ώστε οι πίνακες ελέγχου να ξαναβρούν την ταχύτητά τους:

docker compose exec db psql -U umami -d umami -c "ANALYZE;"

• Οι σημειώσεις έκδοσης λένε τι αλλάζει κάθε έκδοση. Η έκδοση 3.4.1 είναι μια διόρθωση ασφαλείας που ενημερώνει το Next.js και την εικόνα βάσης Node.js· οι σημειώσεις της ζητούν από κάθε αυτο-φιλοξενούμενο στιγμιότυπο να αναβαθμιστεί κατεβάζοντας ξανά την εικόνα.
• Από μια έκδοση 2 σε MySQL: η έκδοση 3 δεν υποστηρίζει πια τη MySQL. Ο οδηγός μετάβασης του έργου μεταφέρει τα δεδομένα στην PostgreSQL στην έκδοση 2.19.0, πριν από την αναβάθμιση στην έκδοση 3.
• Η ίδια η PostgreSQL: κρατήστε την ετικέτα postgres:15-alpine του αρχείου. Η μετάβαση σε νέα κύρια έκδοση της PostgreSQL απαιτεί εξαγωγή και επαναφορά, ή το pg_upgrade.

Ποιος κάνει τι σε ένα Managed VPS

Το self-hosting απαιτεί να φροντίζετε τον διακομιστή εκτός από την εφαρμογή. Σε ένα Managed VPS, οι ομάδες μας αναλαμβάνουν τον διακομιστή και παρακολουθούν προληπτικά το στιγμιότυπό σας· το Umami μένει δικό σας λογισμικό, με τις ρυθμίσεις και τα δεδομένα του.

Αν προτιμάτε να παρεμβαίνουν οι ομάδες μας μέσα στην ίδια την εφαρμογή, η υπηρεσία αυτή χρεώνεται ανά ώρα ή κατ’ αποκοπή, με κοστολόγηση που σας ανακοινώνεται πριν από την παρέμβαση.