Documentación

Empieza con HomeGate

Todo lo que necesitas para poner tus servicios domésticos en línea.

Primeros pasos

  1. 1
    Crea una cuenta — Regístrate en /register
  2. 2
    Instala Tailscale — Instala Tailscale en tu servidor doméstico
  3. 3
    Añade un servicio — Desde el panel de control, añade tu servicio con tu clave de autenticación de Tailscale y la IP de destino
  4. 4
    Publica — Tu servicio es accesible a través de tu subdominio *.homegate.sh con SSL automático

Dominios personalizados

Cada servicio recibe un subdominio gratuito *.homegate.sh. Para usar tu propio dominio, crea un registro CNAME:

# Example: point your domain to your HomeGate subdomain

jellyfin.example.com   CNAME   abc123.homegate.sh

Los certificados SSL se provisionan automáticamente una vez verificado el CNAME. Suele tardar menos de un minuto.

Dominios raíz: Los registros CNAME no se pueden configurar en dominios raíz (p. ej., example.com). Usa un subdominio como stream.example.com, o utiliza un proveedor DNS que soporte registros ALIAS/ANAME (Cloudflare, Route53).

Referencia de la API

HomeGate ofrece una REST API para acceder a todas las funciones de forma programática.

# 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"}

Protección de acceso

Lista de IPs permitidas

Restringe el acceso a tu servicio por dirección IP o rango CIDR. Solo las peticiones desde las IPs permitidas llegarán a tu servicio.

Autenticación por cabecera

Requiere una cabecera personalizada (p. ej., X-Auth-Token: mi-secreto) para todas las peticiones. Útil para servicios que soportan autenticación por cabecera como Immich o Jellyfin.

Servicios compatibles

HomeGate funciona con cualquier servicio basado en HTTP. Algunos ejemplos populares:

Jellyfin :8096
Immich :2283
Plex :32400
Nextcloud :443
Ollama :11434
Vaultwarden :8080
Home Assistant :8123
Gitea :3000
Grafana :3000