Nastavenie vlastného maticového servera na Raspberry Pi a operačnom systéme Umbrel OS

Nastavenie Matrix servera na Raspberry Pi s Umbrel OS a presmerovaním portov na Fritzboxe

UPOZORNENIE - TENTO NÁVOD JE EXPERIMENTÁLNY

Tento návod popisuje, ako nastaviť Matrix server (Synapse) na Raspberry Pi s operačným systémom Umbrel OS a ako nakonfigurovať presmerovanie portov na Fritzboxe, aby bol server dostupný aj mimo vašej siete.

---

Návod ešte nie je úplný. Autor nenesie žiadnu zodpovednosť za tento návod. Návrhy na zlepšenie sú vítané.

---

Požiadavky

• Raspberry Pi (odporúča sa minimálne Raspberry Pi 4 s 4 GB RAM)
• Umbrel OS nainštalovaný na SD karte alebo SSD
• Router Fritzbox s administrátorským prístupom
• Statická lokálna IP adresa pre Raspberry Pi
• Doména alebo subdoména pre Matrix server (napr. cez MyFritz alebo DynDNS službu)
• Základné znalosti Linuxu a konfigurácie siete

Krok 1: Inštalácia Umbrel OS na Raspberry Pi

1. Stiahnite si najnovšiu verziu Umbrel OS z oficiálnej stránky: umbrel.com.
2. Použite Raspberry Pi Imager na nahranie Umbrel OS na SD kartu alebo SSD.
3. Pripojte Raspberry Pi k sieti, zapojte ho do napájania a spustite.
4. Otvorte prehliadač a prejdite na používateľské rozhranie Umbrel zadaním lokálnej IP adresy Raspberry Pi (napr. http://192.168.1.x). IP adresu nájdete v rozhraní Fritzboxu pod „Domáca sieť > Sieť“.

Krok 2: Inštalácia Matrix servera (Synapse) na Umbrel

1. Prihláste sa do webového rozhrania Umbrel.
2. Prejdite do Umbrel App Store a vyhľadajte „Synapse“ (Matrix server).
3. Kliknite na „Inštalovať“ a postupujte podľa pokynov na dokončenie inštalácie.
4. Po inštalácii sa Synapse automaticky nakonfiguruje. Zapíšte si predvolený port (8448 pre HTTPS) a prístupové údaje, ktoré sa zobrazia v rozhraní Umbrel.
5. Vytvorte administrátorského používateľa pre Matrix server:

 # Otvorte terminál na Raspberry Pi (cez SSH alebo priamo v Umbrel).
 # Spustite príkaz:

register_new_matrix_user -c /path/to/homeserver.yaml http://localhost:8008

 # Postupujte podľa pokynov na vytvorenie používateľa.

Krok 3: Nastavenie statickej IP adresy pre Raspberry Pi

Aby presmerovanie portov fungovalo správne, Raspberry Pi potrebuje pevnú IP adresu:

1. Otvorte webové rozhranie Fritzboxu (napr. http://fritz.box).
2. Prejdite na „Domáca sieť > Sieť > Nastavenia siete“.
3. Nájdite Raspberry Pi v zozname pripojených zariadení.
4. Aktivujte možnosť „Vždy priradiť tomuto zariadeniu rovnakú IPv4 adresu“ a uložte zmeny.

Krok 4: Konfigurácia presmerovania portov na Fritzboxe

Aby bol Matrix server dostupný zvonku siete, musíte uvoľniť porty 8448 (pre Matrix federáciu) a prípadne 443 (pre klientov):

1. Otvorte webové rozhranie Fritzboxu (http://fritz.box).
2. Prejdite na „Internet > Zdieľanie > Presmerovanie portov“.
3. Kliknite na „Nové presmerovanie portu“.
4. Nastavte nasledujúce parametre:

 * Zariadenie: Vyberte Raspberry Pi s predtým nastavenou statickou IP adresou.
 * Aplikácia: Vyberte „Iná aplikácia“.
 * Protokol: TCP.
 * Port na zariadení: 8448.
 * Externý port: 8448.
 * Voliteľné pre klientov: Zopakujte postup pre port 443, ak ho chcete použiť pre klientov.

1. Ak služba MyFritz používa port 443, zmeňte port MyFritz pod „Internet > Zdieľanie > Služby Fritzboxu“ na iný port (napr. 4443).
2. Uložte nastavenia.

Krok 5: Nastavenie DynDNS alebo MyFritz pre externú dostupnosť

Keďže väčšina domácich pripojení má dynamické IP adresy, budete potrebovať DynDNS službu alebo MyFritz:

1. **Nastavenie MyFritz**:

 * V rozhraní Fritzboxu prejdite na „Internet > MyFritz“.
 * Aktivujte MyFritz a vytvorte účet s vašou e-mailovou adresou.
 * Zapíšte si MyFritz adresu (napr. vasemeno.myfritz.net).
 * Uistite sa, že je aktivovaná možnosť „Prístup na Fritzbox cez HTTPS“.

1. **Alternatíva: Nastavenie DynDNS**:

 * Zaregistrujte sa u poskytovateľa DynDNS, ako je dynv6.com alebo no-ip.com.
 * Nakonfigurujte DynDNS službu vo Fritzboxe pod „Internet > Zdieľanie > DynDNS“.
 * Voliteľne nainštalujte ddclient na Raspberry Pi, aby sa IP adresy automaticky aktualizovali.

Krok 6: Konfigurácia Matrix servera pre externé použitie

1. Otvorte konfiguračný súbor Synapse (homeserver.yaml), ktorý sa zvyčajne nachádza v /var/lib/synapse.
2. Upravte nasledujúce parametre:

  public_baseurl: https://vasemeno.myfritz.net:8448
  server_name: vasemeno.myfritz.net
  

1. Reštartujte Synapse server:

sudo systemctl restart synapse

1. Otestujte dostupnosť zadaním URL https://vasemeno.myfritz.net:8448 v prehliadači (mal by sa zobraziť Matrix server).

Krok 7: Nastavenie SSL/TLS pre bezpečné pripojenia

Pre bezpečné pripojenie by ste mali použiť SSL/TLS certifikát:

1. Použite službu ako Let's Encrypt na získanie bezplatného certifikátu.
2. Nainštalujte certbot na Raspberry Pi:

sudo apt-get install certbot

1. Spustite príkaz na vytvorenie certifikátu pre vašu doménu:

sudo certbot certonly --standalone -d vasemeno.myfritz.net

1. Nakonfigurujte Synapse na použitie certifikátov úpravou ciest v homeserver.yaml:

  tls_certificate_path: "/path/to/fullchain.pem"
  tls_private_key_path: "/path/to/privkey.pem"
  

1. Znova reštartujte server.

Krok 8: Testovanie a riešenie problémov

1. Otvorte Matrix klienta (napr. Element) a pripojte sa k vášmu serveru (https://vasemeno.myfritz.net).
2. Ak server nie je dostupný, skontrolujte:

 * Presmerovanie portov vo Fritzboxe.
 * Nastavenia firewallu na Raspberry Pi (Umbrel OS má štandardne otvorený firewall pre Synapse).
 * Konfiguráciu DynDNS/MyFritz.
 * Logy Synapse v /var/log/synapse.

Poznámky

• **Bezpečnosť**: Uvoľnite iba potrebné porty (8448 pre federáciu, 443 pre klientov). Používajte silné heslá a aktivujte dvojfaktorovú autentifikáciu vo vašom Matrix klientovi.
• **Výkon**: Raspberry Pi je vhodný pre malé až stredne veľké inštancie Matrixu. Pre väčšie inštancie s mnohými používateľmi zvážte výkonnejší hardvér.
• **IPv6**: Ak váš poskytovateľ internetu používa DS-Lite pripojenie, presmerovanie portov je zložitejšie. V takom prípade použite MyFritz alebo VPN službu na prístup k serveru.

Zdroje

• Dokumentácia Umbrel OS
• Matrix.org
• Návody na presmerovanie portov Fritzboxu