Fathom Liten itse isännöinti vuonna 2026: seurantaskripti, SQLite ja yksityisyys

”Fathom Liten ajamisella” on kaksi eri merkitystä: kontti on olemassa tai palvelu suorittaa varsinaisen tehtävänsä. Vain jälkimmäisellä on merkitystä. Tässä todisteena on sivuston lisääminen, seurantaskriptin lataaminen testisivulle, käyntien luominen ja sen varmistaminen, että hallintapaneeli tallentaa ne ilman evästeitä.

Fathom Lite on tarkoitettu juuri tähän: evästeettömään, itse isännöityyn sivunäyttöjen analytiikkaan. Käyttöönoton on säilytettävä tämän toiminnan taustalla olevat osat; portti, volume ja sertifikaatti ovat lähtötietoja, eivät lopputulos.

Tunnistetiedot, roolit ja näkyvät rajapinnat

Fathom Litessa arvokas hyökkäyspinta ei välttämättä ole landing page. Yleisin virhe on esimerkkisalaisuuden käyttäminen uudelleen tai ylläpitokirjautumisen paljastaminen ilman TLS:ää. Estä tämä tietoisesti: suojaa analytiikan kirjautuminen, pidä application secret muuttumattomana ja julkaise skripti vain odotetusta HTTPS-hostista.

Käsittele FATHOM_SECRET-arvoa sen Fathom Lite -roolin mukaisesti: pidä arkaluonteiset arvot poissa Gitistä, dokumentoi kierron vaikutukset äläkä koskaan käytä julkista esimerkkiä tuotannossa. Käytä rajoittamatonta käyttäjää pienempioikeuksista container user -käyttäjää, jos image tukee sitä, äläkä liitä mukaan asiaankuulumattomia tunnistetietoja. Aseta ingressiin rate- tai size-limitit tilanteissa, joissa epäluotettu liikenne voi kuluttaa sivunäyttöjen kirjoitusnopeutta, tietokannan indeksejä, retention-asetuksia ja vierailijoiden selaimista lähtevää verkkoyhteyttä.

Erota Fathom Lite sen riippuvuuksista

Pienin vastuullinen Fathom Lite -topologia sisältää yhden yksityisen 8080-listenerin, ingress-reitin ja dokumentoidun tilarajan. Fathom Liten verkkosopimus on SQLite tai tuettu ulkoinen tietokanta sekä client-siten seurantaskriptin oikea sijoittelu. Pidä yksityiset endpointit internal DNS:ssä, salli vain tarvittavat lähtevät yhteydet ja anna Fathom Litelle rajattu service credential.

Vahvista topologia pyytämällä puhdasta clientia lisäämään sivuston, lataamaan seurantaskriptin testisivulle, luomaan käyntejä ja varmistamaan, että hallintapaneeli tallentaa ne ilman evästeitä. Seuraa ajon aikana sivunäyttöjen kirjoitusnopeutta, tietokannan indeksejä, retention-asetuksia ja vierailijoiden selaimista lähtevää verkkoyhteyttä. Tulos kertoo, kuuluuko seuraava parannus muistiin, tallennustilaan, verkkoyhteyksiin vai erilliseen workeriin sen sijaan, että kontille annettaisiin mielivaltaisesti lisää resursseja.

Docker-perusta Fathom Litelle

Minimaalinen komento on hyödyllinen, kun se paljastaa, mitä alusta myöhemmin hallinnoi.

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

Tässä portti 8080 pysyy hostin sisäisenä ja jokainen tarvittava polku on määritetty eksplisiittisesti. Lisää tarkistetut yhteysasetukset SQLitea tai tuettua ulkoista tietokantaa varten sekä client-siten seurantaskriptin oikea sijoittelu; käytä yksityisille palveluille yksityisiä nimiä. Varmista käynnistys sekä lokien että sovelluskohtaisen testin avulla: lisää sivusto, lataa seurantaskripti testisivulle, luo käyntejä ja varmista, että hallintapaneeli tallentaa ne ilman evästeitä. Kun toiminta on varmistettu, lukitse imagen versio, jotta tavallinen korvaaminen ei muuta toimintaa huomaamatta.

Vahvista Fathom Liten käyttöönotto päästä päähän

Luo pieni, hävitettävä Fathom Lite -fixture ja säilytä se jokaista julkaisua varten. Fixturen tulee käyttää todellista työnkulkua: lisää sivusto, lataa seurantaskripti testisivulle, luo käyntejä ja varmista, että hallintapaneeli tallentaa ne ilman evästeitä. Tallenna imagen digest, ulkoinen hostname, riippuvuuden osoite ja odotettu tulos, jotta myöhempi operaattori voi toistaa testin ilman tämän oppaan tulkintaa.

Suorita fixture kolme kertaa. Käytä ensimmäisellä kerralla uutta käyttöönottoa. Toisella kerralla korvaa kontti koskematta pysyvään tilaan. Kolmannella kerralla palauta varmuuskopio tyhjään ympäristöön. Kolmas ajo onnistuu vain, kun sivustot, käyttäjät ja historialliset sivunäytöt palaavat ja uusi testikäynti näkyy palautuksen jälkeen. Kerää jokaisen ajon aikana latenssi- ja resurssitiedot sivunäyttöjen kirjoitusnopeuden, tietokannan indeksien, retention-asetusten ja vierailijoiden selaimista lähtevän verkkoyhteyden ympäriltä; tästä tulee hälytysten perusta mielivaltaisen CPU-prosentin sijaan.

Testaa lopuksi negatiivinen polku tarkoituksella: estä test identityn pääsy SQLiteen tai tuettuun ulkoiseen tietokantaan ja varmista client-siten seurantaskriptin oikea sijoittelu. Varmista, että Fathom Lite epäonnistuu näkyvästi tilaa korruptoimatta, palauta oikea ehto ja toista onnistunut transaktio. Julkaisutietue, joka sisältää nämä neljä tulosta, on vahvempaa näyttöä kuin hallintapaneelin kuvakaappaukset tai yksittäinen curl-vastaus.

Pidä sisäiset ja ulkoiset URL-osoitteet erillään

Fathom Liten julkisen rajapinnan tulisi olla yksi kanoninen hostname, automaattinen TLS ja yksi sisäinen kohde portissa 8080. Määritä palvelimen osoite ja seurantaskriptin käyttämä julkinen HTTPS-endpoint niin, että clientit palaavat palvelun tunnistamaan osoitteeseen.

Jos hyväksymistesti epäonnistuu, luokittele ensimmäinen virhe. DNS-, sertifikaatti- ja 502-ongelmat kuuluvat TLS-validoinnin tarkistuslistaan. Ehto ”seurantaskripti osoittaa väärään hostnameen tai tietokantapolku on ephemeral” kuuluu sovelluspuolelle sen jälkeen, kun pyyntö on saavuttanut Fathom Liten onnistuneesti.

Fathom Liten virheharjoitukset

Kapasiteettitestien tulee käyttää sivunäyttöjen kirjoitusnopeutta, tietokannan indeksejä, retention-asetuksia ja vierailijoiden selaimista lähtevää verkkoyhteyttä – ei toistuvaa pyyntöä /-osoitteeseen. Suorita skenaario ”lisää sivusto, lataa seurantaskripti testisivulle, luo käyntejä ja varmista, että hallintapaneeli tallentaa ne ilman evästeitä” realistisella samanaikaisuudella ja kirjaa latenssi, virheprosentti sekä tallennustilan kasvu.

Päivitysten suunnittelussa on huomioitava tämä riski: Fathomin tietokantaskeema ja seurantaskripti on testattava yhdessä, jotta tapahtumia ei menetetä huomaamatta. Testaa uusi julkaisu edustavalla syötteellä, toista sitten hyväksymistransaktio ja vertaa tulosta. Jos seurantaskripti osoittaa väärään hostnameen tai tietokantapolku on ephemeral, tallenna epäonnistunut transaktio ja tutki ensimmäinen mukana oleva rajapinta sen sijaan, että olettaisit ingression olevan vastuussa.

Varmista, että Fathom Lite kestää korvaamisen

Kontti-imagen voi ladata uudelleen, mutta analytiikkatietokantaa, sivuston määrityksiä ja ylläpitäjän tilaa ei voi. Liitä /app ennen bootstrapia, kirjoita vaaratonta esimerkkidataa ja korvaa kontti todistaaksesi, että polku on todella pysyvä. Tarkista toteutunut mount sen sijaan, että luottaisit Compose-tiedoston nimeen, ja varmista, että runtime user voi kirjoittaa Fathom Liten odottamaan sijaintiin.

Valitse retention-asetus ja off-host-kohde, ja harjoittele palautusta koskematta tuotantoon. Harjoitus onnistuu vain, kun sivustot, käyttäjät ja historialliset sivunäytöt palaavat ja uusi testikäynti näkyy palautuksen jälkeen. Tietokantapohjaisessa tilassa yhdistä storage snapshotit sovelluksen kannalta eheisiin exportteihin, kuten kohdassa point-in-time recovery versus snapshots kuvataan.

Liitä Fathom Lite Dockupin elinkaareen

Dockupin yhden napsautuksen Fathom Lite -käyttöönoton tulee tehdä korvaamisesta turvallista: reitti osoittaa edelleen porttiin 8080, salaisuuksia ei leivota imageen ja pysyvät polut palaavat uuteen konttiin. Sama käyttöönotto voi toimia Dockupin computessa tai liitetyllä koneella.

Viimeistele sovelluskohtaiset toimet yhdistämällä ja testaamalla SQLite tai tuettu ulkoinen tietokanta sekä client-siten seurantaskriptin oikea sijoittelu, ottamalla kanoninen julkinen osoite käyttöön ja suorittamalla tämä hyväksymistesti: lisää sivusto, lataa seurantaskripti testisivulle, luo käyntejä ja varmista, että hallintapaneeli tallentaa ne ilman evästeitä. Lisää palautustulos runbookiin ennen oikeiden käyttäjien saapumista.

Usein kysytyt kysymykset

Mitä Fathom Lite tarvitsee tuotantokäyttöönottoon?

Reititä Fathom Lite -kontti portissa 8080 yhden HTTPS-originin kautta. Verkon tukivaatimus on SQLite tai tuettu ulkoinen tietokanta sekä client-siten seurantaskriptin oikea sijoittelu. Älä pidä Fathom Litea valmiina, ennen kuin voit lisätä sivuston, ladata seurantaskriptin testisivulle, luoda käyntejä ja varmistaa, että hallintapaneeli tallentaa ne ilman evästeitä.

Mitkä Fathom Liten tiedot kuuluvat varmuuskopioon?

Säilytä /app ja sisällytä analytiikkatietokanta, sivuston määritykset ja ylläpitäjän tila samaan palautusmanifestiin. Puhdas Fathom Lite -palautus onnistuu vain, kun sivustot, käyttäjät ja historialliset sivunäytöt palaavat ja uusi testikäynti näkyy palautuksen jälkeen.

Vaatiiko Fathom Lite HTTPS:n reverse proxyn takana?

Käytä julkisessa Fathom Lite -originissa HTTPS:ää ja pidä portti 8080 sisäisellä reitillä. Ota Fathom Lite -asetus käyttöön oikein: määritä palvelimen osoite ja seurantaskriptin käyttämä julkinen HTTPS-endpoint. Fathom Litessa HTTPS suojaa tunnistetietoja tai käyttäjäsisältöä siirron aikana ja pitää originista riippuvan client-käyttäytymisen yhdenmukaisena.

Miten Fathom Liten päivitys pitäisi testata?

Palauta nykyinen Fathom Lite -tila eristettyyn käyttöönottoon, ota ehdokasversio käyttöön ja toista sen hyväksymistransaktio. Kiinnitä erityistä huomiota tähän, sillä Fathomin tietokantaskeema ja seurantaskripti on testattava yhdessä, jotta tapahtumia ei menetetä huomaamatta. Säilytä edellinen Fathom Lite -image, kunnes sen datamigraation ja rollbackin rajat on ymmärretty.