Zum Inhalt springen
CloudZH

Doku / Erste Schritte

Domain & HTTPS

CloudZH gibt jeder App ihre eigene HTTPS-Adresse unter deiner Domain, mit einem Wildcard-Zertifikat.

Auf dieser Seite steht example.com für deine eigene Domain und <server-ip> für die Adresse des Servers zu Hause, zum Beispiel 192.168.1.200. Keine Domain? Dann läuft CloudZH im LAN-Modus, siehe Domain oder Heimnetz.

DNS-Einträge

Lege einen Wildcard-Eintrag an, der auf deine öffentliche IP-Adresse zeigt. Deine Hauptdomain und deine E-Mail können bleiben, wo sie sind.

TypNameWertProxy
A*deine öffentliche IPDNS only

Deine öffentliche IP: auf dem Server curl -4 -s https://ifconfig.me.

Adressen, die du bekommst

AdresseVerwendung
app.example.comDashboard. Der Installer fragt nach der Subdomain und schlägt dash vor.
plex.example.comPlex, für Apps und Freunde ausserhalb deines Zuhauses
sonarr.example.com und weitereAdmin-Apps, hinter der Dashboard-Anmeldung
vpn.example.comWireGuard-Endpunkt. Muss direkt auf deine IP zeigen, nie über den Cloudflare-Proxy.

Deine Hauptdomain

Ohne weitere Einrichtung leitet example.com selbst zum Dashboard weiter, und sie darf genauso gut weiter auf deine bestehende Website oder deinen Mail-Host zeigen. Um stattdessen eine statische Website vom Server auszuliefern, richte den Root-Eintrag auf deine IP und veröffentliche einen Ordner mit einer index.html:

zh website deploy /home/<user>/my-site
zh website on
zh website status   # shows whether the DNS records already point here

www.example.com leitet dann auf example.com weiter, und zh website rollback holt die vorherige Version zurück.

Zertifikat

Caddy beantragt das Wildcard-Zertifikat über die DNS-Prüfung von Cloudflare (DNS-01), deshalb ist kein Port 80 nötig. Gib deinen API-Token ein, wenn der Installer danach fragt; zh cloudflare-token prüft und ersetzt ihn später. System Health zeigt, wann das Zertifikat gültig ist.

Innerhalb deines Heimnetzes

Von zu Hause aus löst app.example.com auf deine öffentliche IP auf, und der Verkehr geht durch den Router und wieder zurück. Viele Router machen das langsam. Lege auf deinem Computer einen Hosts-Eintrag an, damit es direkt zum Server geht:

<server-ip>  app.example.com

Zum Beispiel 192.168.1.200 app.example.com. Windows: C:\Windows\System32\drivers\etc\hosts. macOS und Linux: /etc/hosts. Die Leistungsdiagnose sagt dir, wann das zutrifft.