self-hosted · MIT · weby, servery a routery s OpenWrt
Weby, servery a routery s OpenWrt v jednom self-hosted přehledu. Agenti posílají data ven přes HTTPS, takže na hlídaném stroji není potřeba otevírat žádný port, a co nikdo nezměřil, zůstane pomlčkou, nikdy vymyšlenou nulou.
Vlastní instance projektu, přes náš Cloudflare Worker
Čekám na první odpověď…
Dotaz každou minutu; worker odpovědi drží v mezipaměti až 5 minut.
OpenWrt · Turris OS
Jeden skript v POSIX sh, který každou minutu spustí cron. Žádný démon v paměti, žádný bash ani Python. Čte to, co router už ví, přes ubus, /proc a /sys, a posílá to ven přes HTTPS.
Které zásuvky mají linku, jakou vyjednanou rychlostí, co zvládne port i zařízení na druhém konci a kolik zařízení se bridge za kterým portem naučil.
Zadejte rychlost ze smlouvy a přehled ji porovná s tím, co unese linka WAN a vlastní porty routeru. Pomalá linka a úzké hrdlo v routeru pak vypadají jinak.
Pásmo, šířka kanálu, klienti a signál na každém rádiu a vytížení kanálu z čítačů, které si ovladač vede sám. Žádné skenování okolí se nespouští.
S modemem Huawei HiLink jako záložní linkou agent čte jeho signál (RSRP, SINR, RSSI) a registraci v síti, takže víte, že záloha funguje, dřív než ji budete potřebovat.
Disky v routeru čte smartctl nejvýš jednou za hodinu, takže spící disk se nebudí každou minutu.
Šest akcí (restart WAN, WireGuardu nebo služby, nové připojení PPPoE, obnova DHCP, restart routeru) proběhne jen tehdy, když je povolíte v konfiguraci routeru, jen s platným podpisem HMAC a nikdy dvakrát pro jeden požadavek.
Posílají se počty zařízení na port, ne identifikátory. Názvy a IP adresy zařízení zůstávají na routeru také, pokud si výslovně nezapnete seznam pojmenovaných zařízení.
Agent 0.1.9 v e2e testech projektu s busyboxem, ne na fyzickém routeru. Na vašem routeru agent hlásí čas CPU svého předchozího běhu, takže přehled ukáže skutečnou cenu.Jak se to měří
Co hlídá
Každá karta říká, jak daleko je hotová. „Částečně“ a „V plánu“ znamená přesně to.
Kontroly HTTP(S) s volitelným klíčovým slovem na stránce, expirace certifikátů TLS a kontroly TCP portů. Také servery Minecraft, TeamSpeak a Discord.
Agenti pro Linux (Bash nebo Python), Windows (PowerShell) a Docker: CPU, paměť, disky a síť, na Linuxu i SMART.
Porty switche, WAN, Wi-Fi rádia, záložní LTE, disky se SMART a podepsané vzdálené akce na přání, z jednoho shellového skriptu.
Cron úlohy a zálohy se hlásí samy. Cloudflare Worker mimo váš server pozná, když se zastaví samotný sběr dat.
Veřejná stavová stránka s incidenty, plánovanou údržbou, odběrateli e-mailů, SVG odznaky a RSS kanálem.
E-mail, SMS (Twilio), WhatsApp (CallMeBot), Discord, Slack, Telegram, Pushover a PagerDuty a k tomu exportér pro Prometheus.
Dvoufázové přihlášení (TOTP), OAuth přes GitHub, Google, Discord nebo GitLab a dvě role: admin a uživatel.
Kontroly běží z vašeho serveru. Pro ověření odjinud přidejte vlastní měřicí uzly (PHP skript na jiném hostingu nebo Cloudflare Worker pro weby).
Nativní aplikace zatím není. Přehled na /app funguje v prohlížeči telefonu.
Živý důkaz
Oba panely níže se právě teď ptají našeho Cloudflare Workeru. Když dotaz selže, uvidíte pomlčku nebo chybu, nikdy náhradní číslo.
Uzly, jejichž stav vrací veřejné status API bloodkings.eu.
Zadejte veřejnou adresu http(s). Worker ji jednou načte a vrátí stavový kód HTTP a celkovou dobu odezvy, kterou naměřil. Přesměrování ohlásí, ale nenásleduje; soukromé a lokální adresy odmítne.
Zatím nebyl odeslán žádný požadavek. Níže se nic nevyplní, dokud worker neodpoví.
Měří se jen celková doba do přijetí odpovědi z místa, kde worker právě běží. Rozpad na DNS, TCP a TLS worker změřit neumí, a tak ho neukazujeme.
Jak to funguje
PHP 8.2+ (CI projektu běží na 8.4) s MySQL nebo MariaDB a cron, který každou minutu spustí cron.php. Stačí sdílený hosting, server nepotřebuje žádný kontejner. ZIP vydání už obsahuje sestavený přehled /app, takže Node.js potřebuje jen sestavení ze zdrojů.
bloodkings-monitoring.zip z posledního vydání. Složky status/ a app/ nahrajte na hosting.
V administraci hostingu založte databázi a jejího uživatele. Nic neimportujete.
Otevřete /app/setup: zapíše config.php, založí tabulky i první účet.
Přidejte řádek, který instalátor ukáže. Po prvním běhu zezelená.
Změřená doba instalace: 1 min (od ZIPu vydání po první běh sběru dat na čistém serveru s PHP 8.2 a MySQL, podle tohoto návodu; nahrávání přes FTP a klikání v administraci hostingu jde navíc)
Všech sedm kroků na stránce ke stažení →Přidejte stroj ve své aplikaci (Infrastruktura → Přidat nový monitor) a spusťte příkazy, které vypíše s vaší adresou a klíčem, nebo zaregistrujte více strojů jedním tokenem. Agent posílá hlášení ven přes HTTPS; na stroji nic nenaslouchá.
Připojte kanály, které používáte (Discord, Slack a Telegram jdou nastavit i pro jednotlivý monitor), a sdílejte veřejnou stavovou stránku s incidenty a údržbou.
Instalace agenta
Místo https://YOUR-DOMAIN doplňte adresu svého serveru a místo YOUR_AGENT_KEY klíč monitoru. Vaše aplikace vypíše tytéž příkazy s oběma hodnotami už vyplněnými.
Nejsnáz z vlastní aplikace: Infrastruktura → Přidat nový monitor → OpenWrt Router nebo VPS Agent a uložit. Dialog pak vypíše tytéž kroky s vaší adresou a klíčem monitoru. Níže je zastupují https://YOUR-DOMAIN a YOUR_AGENT_KEY.
Bash agent. Adresu serveru a svůj klíč čte z agent.cfg vedle skriptu a hlásí přes HTTPS; cron ho spouští každých 5 minut.
Instalace
Stáhněte agenta
mkdir -p /opt/bk-agent && wget -O /opt/bk-agent/agent.sh https://YOUR-DOMAIN/status/agent.sh && chmod +x /opt/bk-agent/agent.shVytvořte konfiguraci s adresou serveru a klíčem
cat > /opt/bk-agent/agent.cfg <<'EOF'
API_URL="https://YOUR-DOMAIN/status/agent_api.php"
AGENT_KEY="YOUR_AGENT_KEY"
AUTO_UPDATE="1"
EOFSoubor musí ležet ve stejné složce jako skript.
Spusťte agenta ručně a zkontrolujte výpis
/opt/bk-agent/agent.sh --verboseZařaďte agenta do cronu, jednou za pět minut
( crontab -l 2>/dev/null || true; echo '*/5 * * * * /opt/bk-agent/agent.sh >/dev/null 2>&1' ) | crontab -( crontab -l 2>/dev/null | grep -v /opt/bk-agent/agent.sh || true ) | crontab -
rm -rf /opt/bk-agentPak v přehledu smažte monitor agenta, aby jeho klíč přestal platit.
Skript v POSIX sh pro OpenWrt a Turris OS, bez bashe a Pythonu. Adresu serveru a svůj klíč čte z agent_openwrt.cfg vedle skriptu; cron ho spouští každou minutu a skript po běhu skončí.
Instalace
Stáhněte agenta
wget -O /usr/bin/agent_openwrt.sh https://YOUR-DOMAIN/status/agent_openwrt.sh && chmod +x /usr/bin/agent_openwrt.shKdyž wget neumí HTTPS, použijte uclient-fetch se stejnými parametry.
Vytvořte konfiguraci s adresou serveru a klíčem
cat > /usr/bin/agent_openwrt.cfg <<'EOF'
API_URL="https://YOUR-DOMAIN/status/agent_api.php"
AGENT_KEY="YOUR_AGENT_KEY"
AUTO_UPDATE="1"
EOFSoubor musí ležet ve stejné složce jako skript.
Spusťte agenta ručně a zkontrolujte výpis
/usr/bin/agent_openwrt.sh --verbosePrvní běh ještě nezná vytížení CPU, to agent změří až při dalším spuštění.
Zařaďte agenta do cronu, jednou za minutu
mkdir -p "${HOME:-/root}/.cache/crontab" && ( crontab -l 2>/dev/null | grep -v agent_openwrt.sh || true; echo '* * * * * /usr/bin/agent_openwrt.sh >/dev/null 2>&1' ) | crontab -Ověřte, že je agent naplánovaný a odesílá
crontab -l | grep agent_openwrt.sh && sleep 70 && logread | grep -i agent | tail -5První řádek musí vypsat plánovací záznam. Do minuty pak monitor v aplikaci přestane hlásit, že agent mlčí.
Volitelně: podpora Wi-Fi 6E u klientů
opkg update && opkg install hostapd-utilsBez tohoto balíčku agent nezjistí, kteří klienti umí 6 GHz.
( crontab -l 2>/dev/null | grep -v agent_openwrt.sh || true ) | crontab -
rm -f /usr/bin/agent_openwrt.sh /usr/bin/agent_openwrt.sh.* /usr/bin/agent_openwrt.cfg /usr/bin/agent_openwrt.loglines-off
rm -rf /var/run/status-agent-openwrt /tmp/status-agent-openwrt*Pak v přehledu smažte monitor agenta, aby jeho klíč přestal platit.
PowerShell agent. Nemá registrační příkaz: klíč agenta z přehledu uložte do agent.cfg a Plánovač úloh ho spouští každých 5 minut.
Instalace
Stáhněte agenta
New-Item -ItemType Directory -Force C:\bloodkings | Out-Null; Invoke-WebRequest -Uri "https://YOUR-DOMAIN/status/agent.ps1" -OutFile C:\bloodkings\agent.ps1Vytvořte konfiguraci s adresou serveru a klíčem
Set-Content -Path C:\bloodkings\agent.cfg -Value @('API_URL="https://YOUR-DOMAIN/status/agent_api.php"', 'AGENT_KEY="YOUR_AGENT_KEY"', 'AUTO_UPDATE="1"')Soubor musí ležet ve stejné složce jako skript.
Spusťte agenta ručně a zkontrolujte výpis
powershell.exe -ExecutionPolicy Bypass -File C:\bloodkings\agent.ps1 -VerboseNaplánujte spouštění každých pět minut (PowerShell jako správce)
$action = New-ScheduledTaskAction -Execute "powershell.exe" -Argument '-ExecutionPolicy Bypass -File "C:\bloodkings\agent.ps1"'
$trigger = New-ScheduledTaskTrigger -Once -At (Get-Date) -RepetitionInterval (New-TimeSpan -Minutes 5) -RepetitionDuration (New-TimeSpan -Days 3650)
Register-ScheduledTask -TaskName "BloodKingsAgent" -Action $action -Trigger $trigger -User "SYSTEM" -RunLevel HighestUnregister-ScheduledTask -TaskName "BloodKingsAgent" -Confirm:$false
Remove-Item -Recurse -Force C:\bloodkingsPak v přehledu smažte monitor agenta, aby jeho klíč přestal platit.
Python agent v kontejneru python:3-alpine. Doplňte klíč agenta z přehledu.
Instalace
Stáhněte agenta
mkdir -p /opt/bk-agent && cd /opt/bk-agent && wget -O agent.py https://YOUR-DOMAIN/status/agent.py && wget -O docker-compose.agent.yml https://YOUR-DOMAIN/status/docker-compose.agent.ymlDoplňte adresu serveru a klíč do docker-compose.agent.yml
sed -i 's|STATUS_API_URL: .*|STATUS_API_URL: "https://YOUR-DOMAIN/status/agent_api.php"|; s|STATUS_AGENT_KEY: .*|STATUS_AGENT_KEY: "YOUR_AGENT_KEY"|' docker-compose.agent.ymlSpusťte kontejner
docker compose -f docker-compose.agent.yml up -dZkontrolujte výpis kontejneru
docker compose -f docker-compose.agent.yml logs -fcd /opt/bk-agent && docker compose -f docker-compose.agent.yml down
rm -rf /opt/bk-agentPak v přehledu smažte monitor agenta, aby jeho klíč přestal platit.
Stejný Bash agent jako na Linuxu.
Instalace
Stáhněte agenta
mkdir -p /opt/bk-agent && wget -O /opt/bk-agent/agent.sh https://YOUR-DOMAIN/status/agent.sh && chmod +x /opt/bk-agent/agent.shVytvořte konfiguraci s adresou serveru a klíčem
cat > /opt/bk-agent/agent.cfg <<'EOF'
API_URL="https://YOUR-DOMAIN/status/agent_api.php"
AGENT_KEY="YOUR_AGENT_KEY"
AUTO_UPDATE="1"
EOFSoubor musí ležet ve stejné složce jako skript.
Spusťte agenta ručně a zkontrolujte výpis
/opt/bk-agent/agent.sh --verboseZařaďte agenta do cronu, jednou za pět minut
( crontab -l 2>/dev/null || true; echo '*/5 * * * * /opt/bk-agent/agent.sh >/dev/null 2>&1' ) | crontab -( crontab -l 2>/dev/null | grep -v /opt/bk-agent/agent.sh || true ) | crontab -
rm -rf /opt/bk-agentPak v přehledu smažte monitor agenta, aby jeho klíč přestal platit.
Registrace více strojů jedním tokenem a co zkontrolovat, když se agent neukáže: na stránce ke stažení →
Poctivý rozsah
Časté dotazy
Ano. Licence MIT, žádná placená verze a žádný účet u nás. Provozujete to na vlastním hostingu.
Webhosting s PHP 8.2 nebo novějším, MySQL nebo MariaDB a cron, který každou minutu spustí cron.php. Sdílený hosting stačí, server nepotřebuje Docker. ZIP vydání už obsahuje sestavený přehled /app; Node.js potřebuje jen sestavení ze zdrojů.
Ne. Agenti jen odesílají požadavky HTTPS ven na váš server. Vzdálené akce, pokud je zapnete, přijdou v odpovědi na agentův vlastní požadavek.
Cron ho spustí jednou za minutu a agent skončí, nic nezůstává v paměti. V testech projektu s busyboxem udělá agent 0.1.9 asi 182 forků na teplý běh. Na vašem routeru hlásí čas CPU předchozího běhu, takže uvidíte skutečnou cenu.
Jen na server, na který agenty nasměrujete. MAC adresy, názvy a IP adresy zařízení zůstávají na routeru, posílají se jen počty na port, pokud si nezapnete seznam pojmenovaných zařízení. Tento web nic nenačítá od třetích stran.
Pomlčka znamená, že to nikdo nezměřil: chybí senzor nebo balíček, první vzorek se teprve zahřívá, nebo jsou data stará. Nula by byla měření, a tak ji aplikace nikdy nevypíše, když ji nenaměřila.
Ano. Agent pro routery se vyvíjí na Turrisu Omnia a instalace přidává řádek do cronu přes crontab, který Turris OS (cronie) respektuje.
Ano. Kontroly webů, TCP portů a heartbeaty žádného agenta nepotřebují a agenti jsou i pro Linux, Windows a Docker.
Proč vznikl
Začalo to doma s routerem Turris Omnia: WAN na modulu SFP, LTE modem jako záložní linka a disk mSATA. Obyčejná kontrola dostupnosti řekla, jestli je dům online, ale ne proč je pomalý ani jestli záloha zabere.
Agent se proto naučil číst router zevnitř a ujalo se jedno pravidlo: co nikdo nezměřil, je pomlčka. Stejné pravidlo platí v přehledu, na stavové stránce i na tomto webu.