Preskočiť na obsah
MetribayDokumentácia Metribay

Metribay na vlastnom serveri

Vlastné hostovanie, nazývané aj Osobná edícia, je Metribay na tvojom serveri. Je zadarmo a open-source pod licenciou Apache-2.0.

Je to pre teba?

Section titled “Je to pre teba?”
Self-hosted Metribay Cloud
Cost Free See Plans and billing
People One person Teams with roles
Workspaces One, in the background Up to 5
Projects and data sources No limit 10 and 50 active
Integrations All seven All seven
Updates, backups, uptime You Us
Google sign-in button Your own Google app Provided when available

Zvoľ vlastné hostovanie, ak vieš prevádzkovať PHP aplikáciu a chceš všetko na vlastnom hardvéri. Zvoľ Cloud, ak nechceš riešiť server alebo pracovať v tíme.

Požiadavky

Section titled “Požiadavky”
  • PHP 8.5 alebo novší s rozšíreniami cURL, OpenSSL, PDO (SQLite alebo PostgreSQL), intl a mbstring
  • Composer 2
  • SQLite pre osobnú inštaláciu alebo PostgreSQL
  • Spôsob, ako udržať dva procesy na pozadí, napríklad systemd alebo Supervisor, a cron
  • Node 24 len ak chceš zbuildiť frontend. Release ich už obsahuje.

Inštalácia

Section titled “Inštalácia”

  1. Spusti setup skript z koreňa repozitára, potom prejdi do aplikácie:

    Terminal window
    ./scripts/setup.sh
    cd standalone

  2. Vytvor účet. Príkaz sa opýta na heslo súkromne:

    Terminal window
    php artisan metribay:install [email protected]

  3. Spusti web server. Na rýchly lokálny test:

    Terminal window
    php artisan serve --host=127.0.0.1 --port=8000

    V produkcii obsluhuj standalone/public cez HTTPS vlastným web serverom.

  4. Spusti queue worker a scheduler ako samostatné dlho bežiace procesy:

    Terminal window
    php artisan queue:work --timeout=900
    php artisan schedule:work

    V produkcii worker pod process managerom a jeden cron záznam pre php artisan schedule:run každú minútu namiesto schedule:work.

Prihlás sa e-mailom a heslom, ktoré si zvolil. Registrácia je vypnutá: inštalácia patrí jednému účtu, ktorý si vytvoril.

Ako beží zber

Section titled “Ako beží zber”

Scheduler spúšťa zber každé štyri hodiny, monitory dostupnosti každú hodinu a plné obnovenie histórie raz týždenne, rovnako ako v Cloud. Zber prebieha len keď bežia queue worker a scheduler.

Ručná synchronizácia:

Terminal window
php artisan metribay:sync                    # queue every active data source
php artisan metribay:sync --kind=github      # only one provider
php artisan metribay:sync --except=uptimerobot
php artisan metribay:sync --source=12        # one data source by ID
php artisan metribay:sync --full             # reread the whole history window
php artisan metribay:sync --inline           # run now, without the queue

Prepojenie poskytovateľov

Section titled “Prepojenie poskytovateľov”

Každá integrácia funguje s vlastnými prihlasovacími údajmi, ako v integračných príručkách. Nič nejde cez servery Metribay.

Pre tlačidlo Pripojiť Google pri Analytics a Search Console vytvor vlastného OAuth klienta:

  1. V Google Cloud konzole zapni Analytics Admin, Analytics Data a Search Console API.

  2. Vytvor OAuth klienta typu Web application s redirect URI (s vlastnou adresou): https://metribay.example.com/integrations/google/callback

  3. Pridaj do .env:

    METRIBAY_GOOGLE_CLIENT_ID=your-client-id
    METRIBAY_GOOGLE_CLIENT_SECRET=your-client-secret
    METRIBAY_GOOGLE_REDIRECT_URI=https://metribay.example.com/integrations/google/callback

Kým je Google app v test režime, prihlásenia expirujú po siedmich dňoch. Service accounty tento problém nemajú.

Produkčný checklist

Section titled “Produkčný checklist”

  • Obsluhuj cez HTTPS s APP_ENV=production a APP_DEBUG=false.

  • .env, databázu a zálohy drž mimo verejného webového adresára.

  • Nikdy necachuj prihlásené stránky na CDN alebo proxy.

  • Po update spusti migrácie, publishni assety a reštartuj worker:

    Terminal window
    php artisan migrate --force
    php artisan vendor:publish --tag=metribay-assets --force
    php artisan queue:restart

  • Nastav mail transport, aby ti prišli e-maily na reset hesla.

Zálohy

Section titled “Zálohy”

Zálohuj oddelene:

  • The database. Pri SQLite online backup SQLite, nekopíruj súbor počas používania. Pri PostgreSQL pg_dump.
  • The APP_KEY. Uložené údaje sú šifrované ním. Bez kľúča záloha databázy nedokáže dešifrovať. Kľúč nemeň bez plánu na prešifrovanie.

Občas otestuj obnovu. Export konfigurácie je užitočný, ale nie plná záloha: nemá históriu ani prihlasovacie údaje.

Presun do Metribay Cloud

Section titled “Presun do Metribay Cloud”

Exportuj konfiguráciu, zaregistruj sa v Cloud, pridaj prepojené účty s rovnakými menami a importuj súbor. Cloud potom znova nazbiera históriu od poskytovateľov v rámci okna histórie každého zdroja.