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

Protocolos soportados

HomeGate soporta tres protocolos:

HTTP/HTTPS

Para servicios web como Jellyfin, Nextcloud, Immich y cualquier servicio con interfaz web. El tráfico se enruta a través de Caddy con SSL automático. Obtienes un nombre de dominio (p. ej., abc123.homegate.sh) y puedes añadir dominios personalizados.

TCP

Para servicios que usan conexiones TCP directas, como Minecraft Java Edition, Terraria o SSH. Obtienes una cadena de conexión host:puerto a la que cualquiera puede conectarse.

UDP

Para servicios que usan UDP, como Minecraft Bedrock, Valheim o Factorio. Igual que TCP pero para tráfico UDP.

El proxy TCP y UDP está disponible en el plan Dedicated+.

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).

Guías de servidores de juegos

Guías rápidas para servidores de juegos populares. Cada juego sigue el mismo proceso de configuración.

  1. 1 Asegúrate de que el servidor del juego está ejecutándose en tu máquina en el puerto predeterminado
  2. 2 Instala Tailscale en la misma máquina
  3. 3 En el panel de HomeGate, crea un nuevo servicio con el protocolo y puerto de destino correctos
  4. 4 Comparte la cadena de conexión con tus jugadores

Minecraft Java Edition

Protocolo: TCP Puerto predeterminado: 25565

Minecraft Bedrock Edition

Protocolo: UDP Puerto predeterminado: 19132

Valheim

Protocolo: UDP Puerto predeterminado: 2456

Terraria

Protocolo: TCP Puerto predeterminado: 7777

Factorio

Protocolo: UDP Puerto predeterminado: 34197

Palworld

Protocolo: UDP Puerto predeterminado: 8211

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

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

Servicios web (HTTP)

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

Jellyfin :8096
Immich :2283
Plex :32400
Nextcloud :443
OpenClaw :3080
Ollama :11434
Vaultwarden :8080
Home Assistant :8123
Gitea :3000
Grafana :3000
Cualquier servicio basado en HTTP

Servidores de juegos (TCP/UDP)

Disponible en el plan Dedicated+:

Minecraft Java Edition TCP :25565
Minecraft Bedrock Edition UDP :19132
Valheim UDP :2456
Terraria TCP :7777
Factorio UDP :34197
Palworld UDP :8211
Cualquier servicio TCP o UDP