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 e accessibile tramite il tuo sottodominio *.homegate.sh con SSL automatico
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).
Riferimento API
HomeGate fornisce una REST API per l'accesso programmatico a tutte le funzionalita.
# 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 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
HomeGate funziona con qualsiasi servizio basato su HTTP. Alcuni esempi popolari: