CloudZH-Dokumentation
Alles, was du brauchst, um CloudZH zu installieren, deine Medien-Apps einzurichten, Freunde einzuladen und den Server gesund zu halten.
Was CloudZH ist
CloudZH macht aus einem Linux-Rechner zu Hause (Ubuntu, Debian oder Raspberry Pi OS) einen verwalteten Server. Es bringt ein Web-Dashboard, einen App Store mit 30+ Apps, eine Mediathek für deine Freunde, ein WireGuard-VPN, Health-Checks mit sicheren Reparaturen und den Befehl zh auf dem Server.
Wie es aufgebaut ist
| Teil | Was er tut |
|---|---|
| Caddy | Der einzige Eingang. HTTPS für jede Subdomain mit einem Wildcard-Zertifikat. Admin-Apps sind erst nach der Dashboard-Anmeldung erreichbar. |
| Dashboard | Die Weboberfläche. Läuft ohne Privilegien in einem gehärteten Container. |
| Agent | Ein kleiner root-Dienst mit einer festen Liste von Befehlen, erreichbar über einen Unix-Socket. Installiert Apps, führt Reparaturen aus, liest Logs. |
| Apps | Docker Compose, ein Ordner pro App unter /opt/cloudzh/apps, Daten unter /srv/data. |
| Native Teile | WireGuard und UniFi OS Server laufen ausserhalb von Docker. Sie werden nur auf dem Server mit zh installiert. |
Was CloudZH nicht enthält
Keine Medien, keine Indexer und keine Torrent-Clients. Du bringst einen Usenet-Anbieter und Indexer deiner Wahl mit und nutzt die Apps mit Inhalten, die du nutzen darfst.
Platzhalter
Befehle und Adressen in dieser Dokumentation enthalten Platzhalter. Ersetze sie samt spitzen Klammern durch deine eigenen Werte.
| Platzhalter | Steht für | Beispiel |
|---|---|---|
<user> | Der Linux-Benutzer, den du bei der Installation von Ubuntu angelegt hast | anna |
<server-ip> | Die Adresse des Servers in deinem Heimnetz. Auf dem Server zeigt ip -4 -br addr sie in der Zeile des Netzwerkadapters, vor dem /. Auch dein Router führt sie bei seinen Geräten auf. | 192.168.1.200 |
example.com | Deine eigene Domain. app.example.com bedeutet app. gefolgt von deiner Domain. | app.example.com |
Aus ssh <user>@<server-ip> wird also zum Beispiel ssh anna@192.168.1.200.