Co je to NodeInfo? Průvodce pro Meshtastic, Fediverse a Nextcloud

Vítejte u našeho podrobného a velmi obsáhlého průvodce technologií, která nenápadně, ale zásadně pohání celou řadu moderních distribuovaných platforem. Tou technologií je NodeInfo. Ať už se zajímáte o decentralizované sítě z čistě akademického hlediska, s oblibou budujete vlastní server doma v obývacím pokoji, nebo se jen snažíte pochopit, jak spolu komunikují různé nezávislé webové platformy bez asistence jediné obří korporace, NodeInfo hraje vždy naprosto klíčovou roli v tom, jak jednotlivé uzly (takzvané nody) sdílejí životně důležité informace o sobě navzájem. Tento jednoduchý, ale velmi efektivní protokol se v posledních letech stal de facto uznávaným standardem pro komplexní sítě jako Fediverse (do kterého patří celosvětově velmi populární sociální síť Mastodon), privátní open-source cloudová řešení jako Nextcloud a poměrně překvapivě dokonce i pro komunitní rádiové sítě, jako je inovativní Meshtastic.

Aby celá složitá infrastruktura mohla vůbec spolehlivě fungovat a aby se desítky a tisíce nezávislých počítačů dokázaly na dálku propojit a „domluvit“, je zcela nezbytné mít pevně daná pravidla a jasnou komunikaci. Podobně jako v reálném světě velmi pečlivě sledujeme stav našeho vozidla, aby nás nenechalo na holičkách na dálnici, a proto s předstihem pravidelně a důsledně kontrolujeme kola, i v moderní IT infrastruktuře je absolutně nezbytné, aby každý počítačový uzel zapojený v síti transparentně a bez chyb komunikoval o svém vlastním aktuálním stavu, svých technických schopnostech a specifikacích služeb, které svému okolí poskytuje. Pojďme se tedy dopodrobna podívat na to, jak to vlastně celé funguje v praxi, proč je tento formát tak kriticky důležitý pro stabilitu sítě a jak jej můžete v roli správce serveru správně nainstalovat a nakonfigurovat.

Obsah

Co je to NodeInfo a k čemu slouží?

Koncept nazvaný NodeInfo představuje standardizovaný, široce uznávaný způsob, kterým může víceméně jakýkoliv server (označovaný z angličtiny často jako uzel či jednoduše node) vystavit veřejně nebo privátně dostupná metadata o sobě samém. Z technického hlediska se jedná o promyšlenou specifikaci využívající formátu JSON (JavaScript Object Notation), která přesně definuje předvídatelný a jednotný způsob dotazování serveru za účelem efektivního zjištění technických detailů, aktuálních statistik uživatelů a desítek dalších užitečných informací o dané softwarové instanci.

Hlavním a nejdůležitějším účelem celého protokolu NodeInfo je spolehlivě umožnit jak nejrůznějším automatizovaným softwarovým systémům, botům či crawlerům, tak i běžným lidským uživatelům relativně snadno zjistit, jaký konkrétní software v jaké verzi momentálně běží na daném vzdáleném serveru, jaké specifické komunikační protokoly plně podporuje (například velmi zmiňovaný a dnes populární ActivityPub), kolik má momentálně aktivních nebo registrovaných uživatelů, a nebo také zcela prostou, avšak důležitou informaci: zda vůbec aktuálně přijímá nové registrace pro další účastníky. Právě díky těmto zdánlivým maličkostem a preciznímu protokolu mohou žít a dýchat decentralizované sítě, které, i když jsou reálně roztříštěny a běží na stovkách, tisících nebo dokonce desetitisících zcela různých fyzických i virtuálních serverech napříč glóbem, se nakonec dokážou softwarově propojit do jednoho ohromného, logického, kooperujícího a spolupracujícího celku.

Získat a neustále udržovat alespoň hrubý přehled nad takto rozvětvenou, měnící se infrastrukturou je naprosto nezbytné, abyste se vyhnuli drtivým chybám, zpomalení či pádům služeb. Jakýkoli neodhalený technický problém v takto obrovské síti lze do značné míry velmi dobře přirovnat k situaci, kdy máte silné podezření na závažnou závadu na vašem osobním autě během důležité cesty. V takovém krizovém případě vás určitě bude okamžitě zajímat, co přesně se může v následujících kilometrech pokazit a jak dlouho celý váš systém vůbec vydrží, podobně jako se znepokojeně a s obavami ptáte, pokud vás zrovna trápí poškozená či naříznutá pneumatika, a netušíte, zda dojedete do cíle bez asistenční služby.

Evoluce protokolu: Od verze 1.0 k 2.1

Od svého vzniku prošel standard NodeInfo výrazným vývojem. Zatímco první verze 1.0 a 1.1 byly navrženy především pro starší federované sítě jako Diaspora nebo Friendica, moderní verze 2.0 a 2.1 přinesly obrovskou flexibilitu a zjednodušení datové struktury. Dnešní protokol je díky tomu absolutně agnostický vůči konkrétním sociálním sítím. Neomezuje se jen na určité typy projektů, ale umožňuje libovolné aplikaci deklarovat svá vlastní specifická metadata do připraveného pole metadata. Díky tomu si klienti mohou přečíst základní, standardizované metriky nezávisle na platformě, ale pokud rozumí rozšířeným strukturám, mohou využít i specifické údaje pro daný software.

NodeInfo v komunitní radiové síti Meshtastic

Možná poněkud překvapivým, ale o to více fascinujícím moderním využitím těchto myšlenek je plná integrace osvědčených konceptů NodeInfo do rychle rostoucího open-source projektu s názvem Meshtastic. Meshtastic je v základu zcela nezávislý hardwarový a softwarový komunitní projekt určený primárně pro textovou decentralizovanou komunikaci s využitím drobných, nízkoenergetických rádiových modulů pracujících na technologii zvané LoRa. Zde se význam trochu posouvá a „node“ (uzel) v tomto kontextu nepředstavuje vzdálený velký server s gigabajty dat, nýbrž jednotlivá malá, často bateriemi poháněná rádiová zařízení, která nosí uživatelé po kapsách nebo montují na střechy budov za účelem pokrytí celého města.

Každé takové zařízení připojené do sítě Meshtastic zcela automaticky a opakovaně vysílá do éteru malé datové pakety nazvané příhodně NodeInfo. Tyto rádiové zprávy obsahují základní, nicméně kriticky důležitou identifikaci odesílatele: takzvané krátké i dlouhé jméno uzlu, přesnou hardwarovou MAC adresu příslušného zařízení, informace o aktuálním stavu baterie, případně polohu z GPS modulu a v neposlední řadě také další diagnostická metadata, která slouží ke správě a zmapování rádiové topologie. Mimořádně důležitým konfiguračním parametrem u těchto rádiových mesh sítí je takzvaný broadcast interval, tedy exaktní časový úsek (například každých pár minut či hodin), ve kterém dané rádiové zařízení svůj NodeInfo paket opakovaně odesílá do volného éteru. Tím všem ostatním naslouchajícím účastníkům, kteří se momentálně nacházejí v rádiovém dosahu (přímo či nepřímo prostřednictvím směrování v mesh síti), dává naprosto jasně na vědomí, že je nadále online, funkční a plně aktivní a schopné předávat zprávy pro další členy sítě.

Velmi precizní a správné nastavení těchto vysílacích intervalů (broadcast interval), a tím pádem také spolehlivé sdílení těchto identifikačních informací formou NodeInfo paketů, představuje naprostý základ a zajišťuje plynulé, bezproblémové hladké směrování zpráv i v nesmírně náročném přírodním či městském terénu, kde by klasické mobilní operátorské sítě s přehledem selhaly. Propojení mnoha desítek či tisíců těchto drobných, nenápadných vysílačů tak nakonec tvoří vysoce spolehlivou, decentralizovanou, komunitně spravovanou a na centrální autoritě nezávislou komunikační síť schopnou odolat výpadkům internetu i přírodním katastrofám.

Federované sítě: Mastodon, ActivityPub a Fediverse

Ve světě sociálních médií je dnes hodně slyšet o alternativách a decentralizaci. Když se řekne slovo Fediverse (tedy spojení slov federovaný vesmír), drtivá většina lidí si jako první logicky představí známou sociální síť Mastodon, která již několik let slouží jako poměrně silná alternativa k tradičním, velkým, nadnárodním, centralizovaným komerčním platformám. Ale na pozadí není jen jedna služba. Celé toto obrovské ekosystémové prostředí totiž stojí a padá primárně na standardizovaném komunikačním protokolu zvaném ActivityPub. A právě pro samotné takzvané objevování (discovery) vlastností, možností a existencí nejrůznějších serverů je naprosto klíčový a nepostradatelný právě standard NodeInfo.

Každá jednotlivá existující Mastodon instance (tedy de facto každý provozovaný server) poskytuje na své adrese vyhrazený a definovaný veřejný koncový bod, přes který ochotně sdílí svá základní veřejná metadata. Možná se ale ptáte, jak se všechny tyto izolované sítě a ostrůvky informací sdružují a dohledávají? Běžnou praxí je, že různé centrální nebo komunitní adresáře a repozitáře (jako je například velmi populární projekt fediverse.observer) používají roboty, kteří automaticky a pravidelně procházejí hlubiny internetu, objevují nové domény a sbírají veřejná data z těchto nespočetných uzlů. Z pečlivě parsované a standardizované JSON NodeInfo odpovědi se tito roboti, agregátory a další klienti bez potíží dozví například ty nejdůležitější informace:

Přesný typ a aktuální verzi použitého aplikačního softwaru (zda jde o Mastodon, Pleroma, Misskey, Lemmy, Pixelfed a další).
Celkový počet aktuálně aktivních uživatelů zaznamenaných za posledních 30 dní (důležitá metrika nazývaná MAU – Monthly Active Users) a půlroční statistiky (HAU).
Celkový počet příspěvků a statusů, které byly na serveru vygenerovány, pro určení jeho historické aktivity a diskové zátěže.
Informaci o tom, zda daná instance v tuto chvíli vůbec povoluje registraci dalších nových uživatelů, či zda je uzavřená a přístupná pouze přes osobní pozvánku od administrátora.

Bez takovéto vysoce standardizované, počítačově čitelné a spolehlivé API odpovědi by bylo prakticky naprosto nemožné vytvořit jakýkoliv fungující globální adresář těchto serverů. Celý svět Fediverse nám tak ukazuje a velmi hmatatelně dokazuje pravou technologickou sílu jednoduché, avšak mimořádně dobře strukturované komunikace pomocí otevřeně sdílených metadat, na které se všichni nezávislí aktéři shodnou bez nutnosti podpisovat složité smlouvy.

Konfigurace /.well-known/nodeinfo na serverech (Nextcloud)

Základním, nepřehlédnutelným a kriticky důležitým technickým pilířem úspěšného fungování tohoto standardu z pohledu webových administrátorů je zcela specifická a pevně dohodnutá URL adresa s přesným tvarem: /.well-known/nodeinfo. Tento mechanismus umístění ve složce .well-known (tedy „dobře známé“) vychází ze standardů IETF (Internet Engineering Task Force), které definují, kam mají automatizované nástroje chodit hledat globální konfigurace – na stejném principu funguje například populární ověřování certifikátů přes Let’s Encrypt. Pokud na jakémkoliv vlastním webovém serveru implementujete pro svou aplikaci standard NodeInfo, tento server by měl na této pevně předem definované cestě bez chyb vracet jasně strukturovaný a validní JSON soubor, který následně odkazuje klienta na konkrétní implementovanou verzi samotných NodeInfo dat.

Velmi známým, hojně využívaným a často diskutovaným příkladem nasazení tohoto standardu v praxi mimo oblast sociálních sítí je Nextcloud – celosvětově velmi populární open-source řešení určené pro soukromé ukládání dat, správu kalendářů a sdílenou firemní či rodinnou kolaboraci. Pokud se coby administrátor snažíte v rámci důvěry a spolupráce propojit různé nezávislé Nextcloud servery natrvalo dohromady (takzvaná federace cloudu), NodeInfo zde slouží primárně k bezpečnému a automatickému ověření technické identity a velmi rychlému zjištění podporovaných síťových funkcí na straně cílového cloudu.

Obrovské množství běžných i pokročilých správců nejrůznějších serverů se ale čas od času při konfiguraci s tímto na první pohled banálním nastavením velmi intenzivně trápí a ztrácí cenné hodiny času. Pokud váš Nextcloud uzel například v administrátorském panelu sveřepě vrací chybovou hlášku ve smyslu „NodeInfo endpoint not found“, je vždy naprosto nutné přerušit práci, zkontrolovat hlavní i dodatečná nastavení vašeho webového serveru (nejčastěji se jedná o platformy Apache či Nginx) a opakovaně a velmi pečlivě se ujistit, že ona magická adresa /.well-known/nodeinfo je opravdu na úrovni webového serveru správně a bez chyb přesměrována na interní routu a řídící skripty samotné PHP aplikace a nevrací zbytečně chybu 404 Not Found.

Obecná dlouhodobá správa a diagnostika takovéto serverové konfigurace samozřejmě bezesporu vyžaduje hluboké odborné IT znalosti, porozumění regulárním výrazům v konfiguračních souborech a hlavně pevné nervy. Běžný správce serveru se často musí na dlouhé hodiny ponořit opravdu velmi hluboko do spletité technické dokumentace. V širším a filozofickém úhlu pohledu to má překvapivě mnoho společného například s nutnou preventivní údržbou složitých průmyslových a dopravních strojů – pouhý laik z ulice občas instinktivně a z podstaty věci tuší, že motor na dálnici zní jinak a „tady něco evidentně není v pořádku“, ale vysoce profesionální a finální zásah včetně kompletní precizní diagnostiky problému jsou nakonec ve finále přesně stejně komplexní a složité úkoly jako například pochopit a bezchybně zjistit, co obnáší pneuservis a absolutně veškerá periodická i mimořádná údržba moderního profesionálního vozového parku, od nákupu správných ráfků až po ekologickou likvidaci sjetých pneumatik.

Využití v programování a IT infrastruktuře

Pro profesionální softwarové vývojáře, architekty a nadšence představuje dobře zpracovaný protokol NodeInfo naprosto skvělý, výkonný a lehce implementovatelný nástroj, jak do svých stávajících nebo nově vytvářených vlastních aplikací velmi čistě a elegantně implementovat jakoukoliv detekci a pokročilé statistiky třetích decentralizovaných služeb. Pomocí standardních a všude dostupných HTTP GET webových požadavků může každý vývojář poměrně jednoduše za několik minut práce vytáhnout oficiální formátovaný NodeInfo dokument ze stovek či tisíců roztroušených serverů a velmi svižně tak z nuly vybudovat svůj vlastní, vysoce výkonný agregační nástroj nebo přehledný vizuální dashboard, aniž by musel složitě parsovat surové a zmatené zdrojové HTML kódy stránek s pochybnou strukturou.

Z čistě metodického a programátorského hlediska potom vypadá celý životní cyklus zjišťování metadat a celý proces zhruba takto:

Jako úplně první krok vaše aplikace automaticky zavolá pevně danou URL adresu, typicky https://vasedomena.tld/.well-known/nodeinfo.
Pokud server tuto technologii podporuje, v reakci okamžitě získáte základní úvodní JSON dokument obsahující pole s různými momentálně podporovanými a dostupnými verzemi tohoto formátu (např. stabilní verze 2.0 nebo experimentální 2.1) a také k nim přiřazené unikátní příslušné podrobnější cílové absolutní URL adresy (často ve formátu /nodeinfo/2.0).
Následně váš algoritmus dynamicky vybere preferovanou a podporovanou verzi formátu a z vašeho klienta provedete druhý a finální HTTP požadavek na tuto konkrétní, serverem dynamicky navrhnutou vybranou cílovou URL.
V posledním, závěrečném kroku bezpečně přečtete masivnější výsledný komplexní JSON datový payload obsahující přesné a garantované údaje o konkrétním provozovaném softwaru, jeho verzi, souhrnném počtu aktuálních lokálních uživatelů a také tolik důležité otevřenosti serveru k budoucí nové registraci.

Možná si říkáte, že to zbytečně zpomaluje provoz sítě, protože klient musí vždy dělat dva dotazy místo jednoho. Avšak tento striktní dvoukrokový indikační proces je ve skutečnosti velmi chytře navržen zcela úmyslně, a to z důvodu, aby do budoucna pohodlně a bez stresu umožňoval jakékoliv zásadnější upgrady a modifikace samotné specifikace, aniž by tím riskoval masivní, nekontrolované a destruktivní rozbití cenné zpětné kompatibility napříč celou obrovskou internetovou sítí plnou staršího softwaru. Dotazující se webový API klient si tak totiž v rámci tohoto obousměrného dialogu s naprostým klidem a sám podle svých vlastních vývojářských možností zvolí a vybere právě takovou kompatibilní verzi datového schématu, se kterou bezpečně, otestovaně a zcela nativně umí dále pracovat a zpracovávat ji.

Nejčastější problémy a jejich řešení

Při nasazování komplikovaných federovaných, případně plně a striktně decentralizovaných informačních sítí, bohužel v reálném světě velmi pravděpodobně vždy po čase narazíte na několik běžných, avšak záludných a poměrně typických technických překážek přímo spojených právě s implementací nebo konfigurací standardu NodeInfo.

Problém 1: Zablokování vnitřního síťového směrování a takzvané „Routing issues“

Velice často, dokonce snad nejčastěji, se administrátorům stane poměrně frustrující a na první pohled nepochopitelná věc. Plně nakonfigurovaný reverzní proxy server Nginx nebo Apache prostě a jednoduše nepředává veškeré odchycené webové požadavky na speciální adresu /.well-known/nodeinfo správně dál do pozadí (do backend aplikace napsané v Ruby, PHP nebo Node.js). Nejrychlejším a většinou i jediným funkčním trvalým řešením je v tomto případě velmi podrobná a analytická vizuální kontrola samotného hostovacího souboru v /etc/nginx/sites-available/ s nastavenými pravidly pro takzvaný rewrite mod (přepisování vstupních URL adres). Například u složitých systémů jako oblíbeného Mastodonu nebo cloudového giganta Nextcloudu zpravidla zcela postačí bez větších vlastních a rizikových úprav pouze mechanicky a do puntíku zkopírovat jejich oficiální, masivně a plně doporučenou vzorovou defaultní konfiguraci z nejnovější oficiální vývojářské dokumentace na GitHubu a webový server následně s klidem restartovat.

Problém 2: Typicky nesprávně nastavené či zcela ignorované HTTP hlavičky Content-Type

Formální standardní specifikace protokolu NodeInfo naprosto jasně, zřetelně a velice striktně a nekompromisně říká, že každá platná odpověď webového serveru na tento specifický datový dotaz musí bezpodmínečně obsahovat jasně definovaný a určený určitý MIME typ HTTP hlavičky, kterým je ve většině klasických případů obligátní označení typu application/json nebo případně pro některé specifické striktní implementace dokonce mnohem specifičtější profil application/jrd+json. Pokud snad vinou špatné defaultní webové konfigurace váš server v dobré víře vrací jinak zcela platný a bezchybný textový JSON dokument zabalený nešťastně avšak neúprosně s hlavičkou s označením text/html (což je standardní výstup určený běžně pro zobrazení v klasických internetových prohlížečích), všichni pokročilejší a striktnější roboti a validátoři na světě jej okamžitě bez jakéhokoliv dalšího parsování surově a bez náhrady odmítnou zpracovat a vy tak zůstanete pro celou síť prakticky doslova izolovaní a neviditelní.

Problém 3: Citlivá a složitá otázka ohledně bezpečnosti a absolutního uživatelského soukromí

Pravidelné, dlouhodobé a automatizované vystavování veřejných strukturovaných statistických metadat ve svém výsledku fakticky pro mnoho lidí a organizací poměrně nepříjemně znamená, že naprosto a dokonale kdokoliv s běžným přístupem na základní volný internet může de facto vteřinu po vteřině zcela zřetelně a velice podrobně zjišťovat veškeré choulostivé provozní informace o samotné struktuře, objemu a počtech vaší lokální doménové a uživatelské základny a její skutečné denní frekventované aktivitě. Nemálo pečlivých firemních IT profesionálů a privátních správců nejrůznějších menších, striktně intimních a uzavřených firemních komunitních instancí, tak toto transparentní chování logicky považuje za nepřijatelné a zásadní a alarmující bezpečnostní riziko nebo masivní komerční či osobní narušení vlastního hlídaného datového soukromí uživatelů jejich služby. Naštěstí ale na tohle autoři tohoto softwaru po nátlaku a požadavcích administrátorské komunity z bezpečnostních kruhů pamatovali a obvykle tak drtivá většina dostupného moderního federovaného softwaru na dnešním trhu umožňuje po hlubším pohledu do pokročilého systémového nastavení plně omezit, falešně zamaskovat nebo zcela do nuly znemožnit to, co se globálně přes tento NodeInfo komunikační kanál nakonec fyzicky doopravdy odesílá ven. Čímž můžete svá vzácná firemní či osobní soukromá data alespoň do určité částečné, smysluplné a přijatelné kompromisní míry a úrovně docela obstojně chránit a utajit před zraky analytiků a sběračů velkých dat.

Velice precizní a důsledné optimální nastavení vaší komplexní osobní či firemní softwarové IT infrastruktury pro komunikaci je totiž v důsledku a celkově vzato v absolutním finále stejně naprosto důležité, zásadní a nezbytné pro hladký život celého ekosystému, jako pro majitele řádně a zodpovědně svěřit svůj zbrusu nový či drahý poškozený automobil výhradně těm skutečně prověřeným a správným profesionálům a školeným odborníkům s letitou praxí na konkrétní vozidlo a značku v autorizovaných velkých i malých centrech. Pokud se tak například ocitnete v té zoufalé situaci, že složitě na trhu a dlouhé hodiny do noci náhodně procházíte a filtrujete po desítkách nejrůznější menší, větší, levné či prémiové lokální zprostředkovatele či online poskytovatele běžných IT webových a serverových hostingových spolehlivých i pochybných služeb (například virtuálních serverů pro váš NodeInfo projekt), je to vždy proces nakonec zcela a nesmírně podobný, jako když naslepo a nervózně s velkými obavami dlouho se strachem hledáte a pátráte opravdu na vyhlášený kvalitní, poctivý a férový pneuservis v obrovské záplavě zmatečných výsledků neznámé kvality na internetu – ne zcela všechny nablýskané a lákavé sponzorované reklamní lukrativní a lákavé nabídky slibující bezkonkurenční služby zobrazené na titulních internetových portálech a katalozích jsou totiž bohužel reálně tak slibované, skvěle hodnocené a ve finále i stoprocentně objektivně spolehlivé pro běžného, nezkušeného a často bezradného koncového laického klienta. Ve světě aut, cloudu i počítačů se zkrátka doopravdy absolutně vždy, v každém detailu a nekompromisně ve výsledku stoprocentně vyplatí předem raději oželet trochu nervů navíc, nespěchat, a nakonec raději s rozmyslem investovat značně víc cenného životního času do opravdu mimořádně důkladného prvotního, precizního a stabilního výchozího technického nastavení a pravidelné namátkové kontroly všech parametrů.

Závěrem a pro celkové hmatatelné shrnutí celého tohoto fascinujícího tématu z oblasti internetového protokolu NodeInfo lze se vší vážností a bez jakýchkoliv okolků říci, že tato kdysi experimentální specifikace se po delších dlouholetých vývojářských peripetiích, diskuzích na fórech a drobných krocích stala jedním z velmi tichých, skromných, ale o to více mocných architektonických pilířů celého decentralizovaného webu. Bez jakéhokoliv ohledu na to, zda doma po večerech v rámci svého koníčku nadšenecky stavíte malou komunitní rádiovou síť Meshtastic pro komunikaci s přáteli přes kopec, a nebo v naprostém protikladu k tomu v profesionální firemní sféře budujete obrovský korporátní a plně federovaný open-source cloud s desítkami terabajtů citlivých zákaznických firemních dat pomocí robustního systému Nextcloud, pochopení tohoto nenápadného malého JSON protokolu vám obrovsky pomůže si uvědomit, jak elegantní a promyšlené je dnes propojování svobodného a na centrální autoritě nezávislého internetu. Je to právě NodeInfo, díky kterému tento zdánlivý chaos dává obrovský, logický a plně funkční smysl napříč celou obrovskou sítí jménem Fediverse a zaručuje všem zúčastněným stranám a softwarovým klientům naprosto přesné informace k tomu, aby spolu mohly tyto aplikace nezávisle a svobodně den za dnem po celém světě v dokonalé míru a klidu koexistovat.