Erste Schritte mit HomeGate
Alles, was du brauchst, um deine Home-Services live zu bringen.
Erste Schritte
- 1 Konto erstellen — Registriere dich auf /register
- 2 Tailscale installieren — Installiere Tailscale auf deinem Homeserver
- 3 Dienst hinzufügen — Füge im Dashboard deinen Dienst mit deinem Tailscale-Auth-Key und der Ziel-IP hinzu
- 4 Online gehen — Dein Dienst ist über deine *.homegate.sh-Subdomain mit Auto SSL erreichbar
Unterstützte Protokolle
HomeGate unterstützt drei Protokolle:
HTTP/HTTPS
Für webbasierte Dienste wie Jellyfin, Nextcloud, Immich und jeden Dienst mit Weboberfläche. Der Datenverkehr wird über Caddy mit automatischem SSL geleitet. Du bekommst einen Domainnamen (z. B. abc123.homegate.sh) und kannst eigene Domains hinzufügen.
TCP
Für Dienste, die direkte TCP-Verbindungen nutzen, wie Minecraft Java Edition, Terraria oder SSH. Du erhältst einen Host:Port-Verbindungsstring, mit dem sich jeder verbinden kann.
UDP
Für Dienste, die UDP nutzen, wie Minecraft Bedrock, Valheim oder Factorio. Wie TCP, aber für UDP-Datenverkehr.
TCP- und UDP-Proxying ist im Dedicated+-Plan verfügbar.
Eigene Domains
Jeder Dienst bekommt eine kostenlose *.homegate.sh-Subdomain. Um deine eigene Domain zu nutzen, erstelle einen CNAME-Eintrag:
# Example: point your domain to your HomeGate subdomain
jellyfin.example.com CNAME abc123.homegate.sh
SSL-Zertifikate werden automatisch bereitgestellt, sobald der CNAME verifiziert ist. Dauert normalerweise weniger als eine Minute.
Naked Domains: CNAME-Einträge können nicht auf Root-Domains gesetzt werden (z. B. example.com). Verwende eine Subdomain wie stream.example.com, oder nutze einen DNS-Anbieter, der ALIAS/ANAME-Einträge unterstützt (Cloudflare, Route53).
Gameserver-Anleitungen
Schnellstart-Anleitungen für beliebte Gameserver. Jedes Spiel folgt dem gleichen Einrichtungsprozess.
- 1 Stelle sicher, dass der Gameserver auf deinem Rechner auf dem Standard-Port läuft
- 2 Installiere Tailscale auf demselben Rechner
- 3 Erstelle im HomeGate-Dashboard einen neuen Dienst mit dem richtigen Protokoll und Ziel-Port
- 4 Teile den Verbindungsstring mit deinen Spielern
Minecraft Java Edition
Minecraft Bedrock Edition
Valheim
Terraria
Factorio
Palworld
API-Referenz
HomeGate bietet eine REST API für programmatischen Zugriff auf alle Funktionen.
# Base URL
https://api.homegate.sh/v1
# Authentication
Authorization: Bearer <access_token>
# Add a service
POST /v1/services
{"name": "jellyfin", "ts_key": "tskey-auth-xxxx", "target": "100.100.1.5:8096"}
# Add a TCP service (Dedicated+)
POST /v1/services
{"name": "Minecraft Server", "targetPort": 25565, "protocol": "tcp"}
# TCP service response
{"id": "abc12345", "name": "Minecraft Server", "protocol": "tcp", "publicHost": "vps1.homegate.sh", "publicPort": 25565, "connectionString": "vps1.homegate.sh:25565", "status": "active"}
# Add a custom domain
POST /v1/services/:id/domains
{"hostname": "jellyfin.example.com"}
# Add an IP allowlist rule
POST /v1/services/:id/protection
{"type": "ip", "value": "203.0.113.0/24"}
Zugriffsschutz
IP-Allowlisting
Beschränke den Zugriff auf deinen Dienst nach IP-Adresse oder CIDR-Bereich. Nur Anfragen von erlaubten IPs erreichen deinen Dienst.
Header-Authentifizierung
Fordere einen eigenen Header (z. B. X-Auth-Token: my-secret) für alle Anfragen. Nützlich für Dienste, die Header-basierte Authentifizierung unterstützen, wie Immich oder Jellyfin.
Unterstützte Dienste
Webdienste (HTTP)
HomeGate funktioniert mit jedem HTTP-basierten Dienst. Einige beliebte Beispiele:
Gameserver (TCP/UDP)
Verfügbar im Dedicated+-Plan: