Inizia con HomeGate
Tutto il necessario per mettere online i tuoi servizi domestici.
Per iniziare
- 1 Crea un account — Registrati su /register
- 2 Installa Tailscale — Installa Tailscale sul tuo server domestico
- 3 Aggiungi un servizio — Dalla dashboard, aggiungi il tuo servizio con la tua chiave di autenticazione Tailscale e l'IP di destinazione
- 4 Vai online — Il tuo servizio è accessibile tramite il tuo sottodominio *.homegate.sh con SSL automatico
Protocolli supportati
HomeGate supporta tre protocolli:
HTTP/HTTPS
Per servizi web come Jellyfin, Nextcloud, Immich e qualsiasi servizio con interfaccia web. Il traffico viene instradato attraverso Caddy con SSL automatico. Ottieni un nome di dominio (es. abc123.homegate.sh) e puoi aggiungere domini personalizzati.
TCP
Per servizi che usano connessioni TCP dirette, come Minecraft Java Edition, Terraria o SSH. Ottieni una stringa di connessione host:porta a cui chiunque può connettersi.
UDP
Per servizi che usano UDP, come Minecraft Bedrock, Valheim o Factorio. Come TCP ma per il traffico UDP.
Il proxy TCP e UDP è disponibile nel piano Dedicated+.
Domini personalizzati
Ogni servizio ottiene un sottodominio gratuito *.homegate.sh. Per usare il tuo dominio, crea un record CNAME:
# Example: point your domain to your HomeGate subdomain
jellyfin.example.com CNAME abc123.homegate.sh
I certificati SSL vengono generati automaticamente una volta verificato il CNAME. Di solito ci vuole meno di un minuto.
Domini bare: i record CNAME non possono essere impostati su domini root (es. example.com). Usa un sottodominio come stream.example.com, oppure un provider DNS che supporta record ALIAS/ANAME (Cloudflare, Route53).
Guide server di gioco
Guide rapide per i server di gioco più popolari. Ogni gioco segue lo stesso processo di configurazione.
- 1 Assicurati che il server di gioco sia in esecuzione sulla tua macchina sulla porta predefinita
- 2 Installa Tailscale sulla stessa macchina
- 3 Nella dashboard di HomeGate, crea un nuovo servizio con il protocollo e la porta di destinazione corretti
- 4 Condividi la stringa di connessione con i tuoi giocatori
Minecraft Java Edition
Minecraft Bedrock Edition
Valheim
Terraria
Factorio
Palworld
Riferimento API
HomeGate fornisce una REST API per l'accesso programmatico a tutte le funzionalità.
# 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"}
Protezione degli accessi
Allowlist IP
Limita l'accesso al tuo servizio per indirizzo IP o range CIDR. Solo le richieste dagli IP autorizzati raggiungeranno il tuo servizio.
Autenticazione via header
Richiedi un header personalizzato (es. X-Auth-Token: my-secret) per tutte le richieste. Utile per servizi che supportano l'autenticazione basata su header come Immich o Jellyfin.
Servizi supportati
Servizi web (HTTP)
HomeGate funziona con qualsiasi servizio basato su HTTP. Alcuni esempi popolari:
Server di gioco (TCP/UDP)
Disponibile nel piano Dedicated+: