Hostsuar

DNS dinámico, gestión desde el área de clientes

La funcionalidad de DNS dinámico (DDNS) te permite crear y gestionar subdominios que apunten a direcciones IP dinámicas directamente desde tu área de clientes para dominios sin hosting asociado.

Esta herramienta es especialmente útil para acceso remoto a dispositivos domésticos, servidores caseros, dispositivos NAS, cámaras de seguridad, o cualquier servicio que necesite estar accesible desde internet pero disponga de una IP que cambia periódicamente.

Requisitos

  • Dominio registrado en tu cuenta
  • Sin servicio de hosting asociado (para dominios con hosting, usa el DNS dinámico desde cPanel)
  • Dispositivo o sistema capaz de realizar llamadas HTTP periódicas

Acceso a la funcionalidad

  1. Inicia sesión en tu área de clientes
  2. Ve a la sección "Dominios"
  3. Selecciona el dominio que deseas configurar
  4. Haz clic en la opción "DNS Dinámico"

Acceso a DNS dinámico

Configuración básica

En el formulario de creación, completa los siguientes campos:

  • Subdominio: Nombre del subdominio (opcional, deja vacío para el dominio raíz)
    • Ejemplos: servidor, nas, dev, cam01
    • Para el dominio raíz: deja el campo vacío
  • Tipo de registro: Selecciona entre:
    • A (IPv4): Para direcciones IP v4 (ej: 192.168.1.100)
    • AAAA (IPv6): Para direcciones IP v6 (ej: 2001:db8::1)

Haz clic en "Crear entrada DDNS" para generar la configuración y listo.

Limitaciones

  • Máximo 10 entradas DDNS por dominio
  • No duplicados: No puedes crear múltiples entradas para el mismo subdominio y tipo de registro
  • Solo dominios sin hosting: La funcionalidad no está disponible para dominios con hosting asociado

Gestión de entradas DDNS

Una vez creada la entrada, verás una tarjeta con la información completa:

  • Nombre completo: hostname.tudominio.com
  • Estado: Activo/Inactivo
  • Tipo de registro: A o AAAA
  • IP actual: Última IP registrada
  • Última actualización: Fecha y hora del último cambio

URL de actualización

La URL de actualización es única para cada entrada y tiene este formato:

https://ddns.hostsuar.com/update/TOKEN_UNICO_32_CARACTERES

Esta URL es la que debes configurar en tu dispositivo o sistema para mantener actualizada la IP por medio de llamadas a la misma.

Configuración en dispositivos

Routers domésticos

La mayoría de routers modernos incluyen soporte para DNS dinámico personalizado:

  1. Accede a la configuración de tu router
  2. Busca la sección "DNS dinámico" o "DDNS"
  3. Selecciona "Personalizado" o "Custom"
  4. Introduce la URL de actualización completa
  5. Configura el intervalo de actualización (recomendado: 5-10 minutos)

Dispositivos NAS

Synology DiskStation

  1. Ve a Panel de control > Conectividad externa > DDNS
  2. Selecciona "Personalizado"
  3. Introduce la URL de actualización
  4. Configura el intervalo

QNAP

  1. Accede a Panel de control > Conectividad externa > DDNS
  2. Selecciona "Custom DDNS"
  3. Configura la URL y parámetros

Scripts personalizados

Usando cURL (Linux/macOS)

#!/bin/bash
# Script para actualizar DNS dinámico

URL="https://ddns.hostsuar.com/update/TU_TOKEN_AQUI"

# Actualizar con detección automática de IP
curl -s "$URL"

# O especificar IP manualmente
# curl -s "$URL?ip=TU_IP_AQUI"

Usando PowerShell (Windows)

$url = "https://ddns.hostsuar.com/update/TU_TOKEN_AQUI"
Invoke-WebRequest -Uri $url -UseBasicParsing

Tarea cron (Linux)

Para ejecutar cada 5 minutos:

# Editar crontab
crontab -e

# Añadir línea:
*/5 * * * * /usr/bin/curl -s "https://ddns.hostsuar.com/update/TU_TOKEN"

Parámetros de la URL

Parámetro IP

Puedes especificar la IP de dos formas:

# Parámetro ip
https://ddns.hostsuar.com/ddns/update/TOKEN?ip=1.2.3.4

# Parámetro myip (compatibilidad)
https://ddns.hostsuar.com/ddns/update/TOKEN?myip=1.2.3.4

Detección automática

Si no especificas ningún parámetro, el sistema detectará automáticamente la IP desde la que realizas la petición:

https://ddns.hostsuar.com/update/TOKEN

Consultar estado de la entrada DDNS

Además de actualizar la IP, puedes consultar el estado actual de cualquier entrada DDNS sin realizar modificaciones.

URL de consulta

https://ddns.hostsuar.com/status/TOKEN

Respuesta de estado

{
  "hostname": "servidor.tudominio.com",
  "current_ip": "1.2.3.4",
  "type": "A",
  "enabled": true,
  "last_updated": "2025-01-15T14:30:45.000Z"
}

Campos de respuesta

  • hostname: Nombre completo del subdominio configurado
  • current_ip: Última dirección IP registrada
  • type: Tipo de registro DNS (A o AAAA)
  • enabled: Estado de la entrada (true/false)
  • last_updated: Fecha ISO de la última actualización (null si nunca se ha actualizado)

Casos de uso

  • Monitoreo: Verificar si tu dispositivo está actualizando correctamente
  • Debugging: Comprobar la IP actual registrada sin hacer cambios
  • Automatización: Integrar en scripts para validar antes de actualizar

Respuestas de la API

Actualización exitosa

{
  "success": true,
  "message": "DNS record updated successfully",
  "hostname": "servidor.tudominio.com",
  "ip": "1.2.3.4",
  "type": "A"
}

IP sin cambios

{
  "success": true,
  "message": "IP address is already up to date",
  "hostname": "servidor.tudominio.com",
  "ip": "1.2.3.4",
  "type": "A"
}

Errores comunes

{
  "error": "Invalid token",
  "code": "INVALID_TOKEN"
}

{
  "error": "DDNS entry is disabled",
  "code": "DDNS_DISABLED"
}

{
  "error": "Invalid IP format for record type",
  "code": "INVALID_IP"
}

Gestión avanzada

Activar/Desactivar entrada

Puedes activar o desactivar cualquier entrada sin eliminarla:

  • Desactivar: Detiene las actualizaciones DNS pero mantiene la configuración
  • Activar: Reanuda el funcionamiento normal

Regenerar token

Si sospechas que tu token ha sido comprometido, puedes regenerar un nuevo token:

  1. Haz clic en "Regenerar token"
  2. Confirma la acción
  3. Actualiza la configuración en todos tus dispositivos con el nuevo token

⚠️ Importante: Tras regenerar el token, el anterior dejará de funcionar inmediatamente.

Eliminar entrada

Para eliminar completamente una entrada DDNS:

  1. Haz clic en "Eliminar"
  2. Confirma la acción
  3. La entrada y su registro DNS asociado serán eliminados permanentemente

Solución de problemas

Cómo funciona el DNS dinámico

Es importante entender que DDNS solo gestiona registros DNS que apuntan a direcciones IP. El servicio:

  • Configura un TTL de 60 segundos para permitir actualizaciones rápidas
  • No proporciona certificados SSL/HTTPS: Estos deben ser configurados en el servidor de destino
  • Solo resuelve nombres a IPs: El contenido web o servicios deben estar funcionando en la IP de destino

Propagación DNS y cache

Aunque configuramos un TTL de 60 segundos para los registros DDNS, algunos factores pueden afectar la velocidad de actualización:

Cache de proveedores DNS

  • ISPs y proveedores: Algunos ignoran el TTL bajo y mantienen cache más prolongado
  • DNS públicos (Google 8.8.8.8, Cloudflare 1.1.1.1): Suelen respetar mejor el TTL configurado
  • Dispositivos locales: Routers y sistemas pueden tener su propio cache DNS

Problemas comunes

La IP no se actualiza

  1. Verifica el token: Asegúrate de usar el token correcto
  2. Comprueba el estado: La entrada debe estar activa
  3. Revisa la conectividad: El dispositivo debe tener acceso a internet
  4. Valida la IP: Para registros A usa IPv4, para AAAA usa IPv6
  5. Espera la propagación: Permite hasta 30 minutos para la propagación completa

Error "Sitio no seguro" o problemas HTTPS

  • DDNS no proporciona SSL: Los certificados HTTPS deben configurarse en tu servidor
  • Usa Let's Encrypt: Para certificados gratuitos en tu servidor

Error de token inválido

  • Verifica la URL: Copia exactamente la URL mostrada en el área de clientes
  • Regenera el token: Si persiste el problema, regenera un nuevo token

El dominio resuelve pero no hay contenido

  • Verifica el servidor: El servicio web debe estar ejecutándose en la IP de destino
  • Comprueba puertos: Asegúrate de que los puertos necesarios estén abiertos
  • Firewall: Revisa configuraciones de firewall en el router y servidor