Talpinkite Umami Managed VPS serveryje: jūsų svetainių analitika jūsų serveryje

Ką daro Umami

Umami yra atvirojo kodo svetainių ir produktų analitikos platforma. Jos dokumentacija aprašo įrankį, kuris sujungia lankomumą, kampanijas, lankytojų elgseną, konversijas, išlaikymą ir pajamas, nuo pirmojo apsilankymo iki jūsų verslui svarbių rezultatų. Ji parašyta TypeScript kalba su Next.js, o jos Docker atvaizdas veikia neprivilegijuota paskyra.

• Pritraukimas: puslapių peržiūros, lankytojai, nukreipiantys šaltiniai, šalys, įrenginiai ir veikla realiuoju laiku, su UTM kampanijomis, trumposiomis nuorodomis ir sekimo pikseliais.
• Elgsena: pasirinktiniai įvykiai, keliai, sesijų įrašai, šilumos žemėlapiai, segmentai, kohortos ir išlaikymas.
• Konversija: tikslai, piltuvėliai, priskyrimas ir pajamų sekimas pagal puslapį ir kampaniją.
• Dalijimasis: lentos, komandos, viešas bendrinimo URL, API ir tik skaitymo MCP serveris jūsų DI asistentui.
• Šiuolaikinės svetainės: DUK nurodo, kad Umami pati seka naršymą tarp puslapių vieno puslapio programose, be jokio papildomo nustatymo.

Vienas egzempliorius seka kelias svetaines: kiekviena gauna savo ID ir sekimo scenarijų, o jūsų kolegos orientuojasi per paskyras ir komandas.

Ką leidžia MIT licencija

Umami platinama pagal MIT licenciją, Umami Software, Inc. vardu. Ji nemokamai suteikia teisę naudoti, kopijuoti, keisti, sujungti, skelbti, platinti, sublicencijuoti ir parduoti programinės įrangos kopijas. Todėl ją galite paleisti savo verslui ir savo klientų svetainėms, nieko nepirkdami dėl licencijos.

Vienintelė jos sąlyga: autorių teisių pranešimas ir leidimo pranešimas pridedami prie visų programinės įrangos kopijų ar esminių jos dalių. Kaip ir bet kuri MIT licencija, ji programinę įrangą teikia „tokią, kokia yra“, be garantijos.

Slapukai ir asmens duomenys: ką sako projektas

Dokumentacija Umami pristato kaip analitiką be slapukų, be sekimo tarp svetainių ir be automatinio asmens duomenų rinkimo. Talpinama savo serveryje, ji laiko jūsų analitiką jūsų serveryje: jūs sprendžiate, kur ji laikoma ir kiek laiko išlieka.

Trys sekimo scenarijaus nustatymai, jei norite, eina toliau: data-exclude-search pašalina paieškos parametrus iš įrašomų URL, data-exclude-hash pašalina maišos dalį, o data-do-not-track išjungia sekimą naršyklėms, kurios atskleidžia Do Not Track nuostatą. Dokumentacija pažymi, kad pastarasis nustatymas savaime nėra išsamus sutikimų valdymo sprendimas.

Jei prisijungusius lankytojus identifikuojate su data-distinct-id ar umami.identify(), dokumentacija rekomenduoja vidinį naudotojo ID ar maišą, o ne el. pašto adresą: reikšmę galima perskaityti puslapio HTML kode.

Diegimas su Docker Compose ir PostgreSQL

Saugykloje pateikiamas docker-compose.yml, kuris paleidžia Umami ir jos PostgreSQL duomenų bazę. Nuo 3 versijos PostgreSQL yra vienintelė palaikoma duomenų bazė, ne senesnė nei 12.14, o dokumentacija rekomenduoja nustatyti jai UTC laiko juostą. Serveryje, kuriame įdiegtas Docker, sukurkite katalogą ir pradėkite nuo jos slaptų reikšmių, atsitiktinai sugeneruotų su openssl, kaip siūlo dokumentacija:

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

Tada šalia padėkite šį compose.yaml. Jis seka projekto failą 3.4.1 versijoje su dviem pakeitimais: slaptos reikšmės imamos iš failo .env, o prievadas skelbiamas tik adresu 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: vienintelis privalomas kintamasis, duomenų bazės prisijungimo eilutė. Šešioliktainis slaptažodis įrašomas toks, koks yra; slaptažodį su specialiaisiais simboliais reikėtų užrašyti procentų kodavimu.
• APP_SECRET: atsitiktinė eilutė, sauganti autentifikavimo žetonus, unikali kiekvienam diegimui. 3.4.1 versijos kode ji taip pat naudojama sesijų ID skaičiavimui: laikykite ją nekintamą.
• TWO_FACTOR_ENCRYPTION_KEY: 64 šešioliktainiai simboliai, šifruojantys dviejų veiksnių autentifikavimo paslaptis. Be jo niekas negali įjungti dviejų veiksnių autentifikavimo.
• Paleidimo metu konteineris patikrina ryšį su duomenų baze ir jos versiją, tada pats pritaiko schemos perkėlimus. Pirmą kartą jis sukuria lenteles ir paskyrą admin. Zondas /api/heartbeat atsako {"ok":true}, kai Umami pasiruošusi.
• Žyma latest seka naujausią paskelbtą versiją. Projekto registre taip pat skelbiamos versijų žymos, pavyzdžiui, 3.4.1, kad užfiksuotumėte naudojamą versiją.

Diegimo dokumentacija nenurodo nei atminties, nei procesoriaus dydžio. Dydis priklauso nuo sekamų svetainių lankomumo ir saugomų duomenų apimties. Naudojant Managed VPS, papasakokite mums, kaip ketinate naudotis, ir mes rekomenduosime tinkamą dydį.

HTTPS: atvirkštinis tarpinis serveris

Umami klausosi per HTTP 3000 prievadu, o dokumentacija siūlo ją teikti už jūsų žiniatinklio serverio, per atvirkštinį tarpinį serverį. Suteikite jai atskirą subdomeną, pavyzdžiui, stats.example.com, nukreiptą į serverį A ir AAAA įrašais. Umami teikimas po keliu vyksta per BASE_PATH, kintamąjį, nuskaitomą programos kūrimo metu: su paskelbtu atvaizdu subdomenas yra tiesiausias kelias.

Tarpinis serveris taip pat turi perduoti lankytojo adresą. Umami jį nuskaito iš gaunamų antraščių, įskaitant X-Real-IP ir X-Forwarded-For: juo ji atskiria lankytojus ir nustato jų šalį. Jei jūsų tarpinis serveris naudoja kitą antraštę, ją nurodo CLIENT_IP_HEADER.

Su Caddy

Caddy pati gauna Let’s Encrypt sertifikatą ir įjungia HTTPS. Jos direktyva reverse_proxy numatytai nustato X-Forwarded-For: užtenka šių trijų eilučių.

stats.example.com {
  reverse_proxy 127.0.0.1:3000
}

Su Nginx ir Certbot

Šis blokas seka Umami dokumentacijos Nginx pavyzdį ir klausosi 80 prievado, kad HTTPS įdiegtų Certbot:

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;
  }
}

Tada Certbot įdiegia sertifikatą ir pasirūpina jo atnaujinimu:

sudo certbot --nginx

Pirmasis prisijungimas: administratoriaus paskyra ir dviejų veiksnių autentifikavimas

Kurdama savo duomenų bazę, Umami atveria administratoriaus paskyrą: naudotojo vardas admin, slaptažodis umami. Dokumentacija prašo šį slaptažodį pakeisti pirmą kartą prisijungus.

1. Atverkite savo HTTPS adresą ir prisijunkite su admin ir umami.
2. Šoninės juostos profilio mygtuku atverkite Settings, tada Profile, ir spustelėkite Change password.
3. Skirtuke Security įjunkite dviejų veiksnių autentifikavimą: nuskaitykite QR kodą autentifikavimo programa, įveskite šešių skaitmenų kodą, tada saugiai išsaugokite dešimt atsarginių kodų, nes jie rodomi tik vieną kartą.

• Privalomas dviejų veiksnių autentifikavimas: administratorius gali jį privalomai įjungti visam egzemplioriui, vienam naudotojui ar vienai komandai, administravimo puslapiuose.
• Bandymai: po penkių klaidingų kodų tolesni bandymai užrakinami 15 minučių.
• Jūsų komandos paskyros: administravimo puslapiai tvarko viso egzemplioriaus naudotojus, svetaines ir komandas.

Laikykite TWO_FACTOR_ENCRYPTION_KEY kartu su atsarginėmis kopijomis: dokumentacija įspėja, kad praradus ar pakeitus šį raktą saugomos paslaptys tampa neperskaitomos, ir tada kiekvienas naudotojas turi iš naujo užsiregistruoti dviejų veiksnių autentifikavimui.

Svetainės ir jos sekimo scenarijaus pridėjimas

1. Skiltyje Websites spustelėkite Add website.
2. Suteikite svetainei pavadinimą, tada nurodykite jos domeną: Umami jį naudoja, kad jūsų pačių puslapius išfiltruotų iš nukreipiančių šaltinių sąrašo.
3. Atverkite tos svetainės Edit ir nukopijuokite kodą iš skilties Tracking code.
4. Įklijuokite jį į savo puslapių <head>, tada apsilankykite savo svetainėje: duomenys iškart pasirodo skydelyje.

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

• Nieko nerodo? Dokumentacija siūlo naršyklės kūrėjo įrankių tinklo skirtuką: užklausos į jūsų egzempliorių turi išeiti be klaidų.
• Next.js: pridėkite kodą komponentu next/script, o ne paprasta žyma <script>.
• data-domains riboja sekimą jūsų gamybiniais domenais, todėl bandomosios aplinkos nepatenka į statistiką.
• Jūsų pačių apsilankymai pašalinami kiekvienoje svetainėje atskirai, iš naršyklės konsolės, su localStorage.setItem('umami.disabled', 1).

Savas scenarijaus pavadinimas

Kai kurie reklamų blokatoriai blokuoja viską, kas panašu į analitiką. Talpinama savo serveryje, Umami jau teikiama iš jūsų domeno, o du kintamieji eina toliau: TRACKER_SCRIPT_NAME scenarijui suteikia kitą pavadinimą nei script.js, o COLLECT_API_ENDPOINT pervadina duomenų rinkimo galinį tašką vietoj /api/send. Tada scenarijus pats kreipiasi į naują galinį tašką; jūsų puslapiuose keičiasi tik sekimo kodo šaltinis.

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

Naudingi nustatymai

Šie aplinkos kintamieji dedami į compose.yaml paslaugą umami, tada docker compose up -d sukuria konteinerį iš naujo, kad juos pritaikytų:

Atsarginės kopijos

Viskas, ką saugo Umami, yra jos PostgreSQL duomenų bazėje: paskyros, svetainės, komandos ir analitika. Eksportuokite ją kasdien ir prieš pat kiekvieną atnaujinimą: talpinant savo serveryje, šie duomenys saugomi be laiko ribos. Šalia duomenų bazės failas .env laiko slaptas reikšmes, be kurių jos neįmanoma naudoti:

Duomenų bazės eksportas jai veikiant

pg_dump sukuria nuoseklų eksportą, kol duomenų bazė naudojama. Pasirinktinis formatas, -Fc, yra suspaustas ir atkuriamas su pg_restore:

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

Suplanuokite šią komandą serveryje bent kartą per dieną, retkarčiais išvalykite kaupiamus eksportus ir siųskite kopiją kitur. Padėti serverio diske, šie eksportai patenka ir į jo naktines atsargines kopijas.

Atkūrimas

1. Sustabdykite Umami, palikdami veikti duomenų bazę: docker compose stop umami.
2. Atkurkite eksportą į duomenų bazę, pakeisdami esamus objektus.
3. Vėl paleiskite Umami, tada patikrinkite, ar jūsų svetainės ir jų analitika vietoje.

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

Retkarčiais pakartokite šį pratimą su kopija: taip įsitikinate, kad atsarginė kopija veikia.

Atnaujinimai

Dokumentacija pateikia dvi komandas, vykdomas kataloge su compose.yaml. Duomenų bazė lieka savo tome:

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

Paleistas iš naujo, konteineris pats pritaiko schemos perkėlimus. 3.4.0 versija, išleista 2026 m. rugsėjo 17 d., turėjo du perkėlimus, anotacijoms ir API raktams; 3.4.1 versija, išleista 2026 m. spalio 23 d., neturi nė vieno. Po didelio atnaujinimo, pavyzdžiui, perėjus prie 3 versijos, dokumentacija siūlo PostgreSQL paleisti ANALYZE, kad skydeliai atgautų greitį:

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

• Versijų pastabos nurodo, ką keičia kiekviena versija. 3.4.1 versija yra skubi saugumo pataisa, atnaujinanti Next.js ir Node.js bazinį atvaizdą; jos pastabos prašo kiekvieno savo serveryje talpinamo egzemplioriaus atsinaujinti iš naujo atsisiunčiant atvaizdą.
• Iš 2 versijos su MySQL: 3 versija nebepalaiko MySQL. Projekto perkėlimo gidas duomenis perkelia į PostgreSQL 2.19.0 versijoje, prieš atnaujinant į 3 versiją.
• Pati PostgreSQL: palikite failo žymą postgres:15-alpine. Perėjimui prie naujos pagrindinės PostgreSQL versijos reikia eksporto ir atkūrimo arba pg_upgrade.

Kas ką daro Managed VPS serveryje

Talpinant savo serveryje, be programos reikia prižiūrėti ir patį serverį. Naudojant Managed VPS, mūsų komandos perima serverį ir proaktyviai stebi jūsų egzempliorių; Umami lieka jūsų programa su savo nustatymais ir duomenimis.

Jei norite, kad mūsų komandos įsikištų į pačią programą, ši paslauga apmokestinama valandomis arba fiksuota kaina, o skaičiavimas pateikiamas prieš įsikišimą.