Uso Final

Agregar un dominio

  1. Entrar al servidor → pestaña Proxy (ícono de enlace 🔗, al lado de Backups).
  2. Click en New Domain.
  3. Completar el formulario:
    • Domain name: el dominio ya debe tener un registro A apuntando a la IP pública del nodo antes de cargarlo acá. Si no resuelve todavía:
      • En modo None o Cloudflare: el tráfico simplemente no va a llegar hasta que el DNS propague.
      • En modo Let's Encrypt: la emisión del certificado va a fallar (certbot no puede completar el challenge HTTP-01 sin DNS resuelto).
    • Port (solo aparece si el server tiene más de una allocation): a qué IP:puerto del server apunta este dominio. Por ejemplo, con un server que tiene el 25565 corriendo una app y el 25566 otra completamente independiente, se puede crear un dominio para cada una eligiendo el puerto correspondiente acá. Si no se toca, usa la allocation primaria del server (el comportamiento de siempre).
    • SSL mode: None, Cloudflare, Let's Encrypt o Custom certificate (pegar certificado y clave propios). Ver el detalle de cada uno en Modos SSL. El backend rechaza cualquier modo que el administrador del nodo haya bloqueado, aunque el modal siempre muestra las cuatro opciones.
  4. Click en Create Domain.

Qué esperar después de crear un dominio

El dominio aparece en la lista con estado:

  • ● Awaiting DNS: solo aparece si el administrador del nodo activó la verificación de propiedad de dominio. Ver la sección siguiente.
  • ● Pending (icono girando): el job todavía no corrió o está corriendo. La lista hace polling automático cada 10 segundos, no hace falta refrescar la página a mano.
  • ● Active: el proxy ya está funcionando en el nodo. Si el administrador del nodo activó "Show nginx config path", debajo del nombre del dominio se muestra además la ruta del .conf generado (solo visible en pantallas medianas/grandes); por defecto esa opción está apagada y no se muestra nada ahí.
  • ⚠ Error: algo falló. El mensaje de error aparece truncado debajo del dominio; pasar el mouse por encima (tooltip) muestra el texto completo. Ver Solución de problemas para interpretar los mensajes más comunes.

Si un dominio queda en Pending por más de uno o dos minutos, casi siempre significa que no hay un worker de cola corriendo en el panel; eso es algo que debe resolver el administrador, no el usuario final.

Verificar la propiedad de un dominio

Si el administrador del nodo activó "Require domain ownership verification", el dominio nuevo no se aplica de inmediato: queda en Awaiting DNS y debajo del nombre aparece un recuadro con un registro TXT a publicar, algo así:

ini
_pawproxy-verify.midominio.com = "a1b2c3..."

Pasos:

  1. Ir al panel de DNS del dominio (fuera de Pterodactyl: Cloudflare, Namecheap, etc.) y crear un registro TXT con ese nombre y ese valor exactos.
  2. Esperar a que propague (normalmente minutos, a veces más según el proveedor).
  3. Volver a la pestaña Proxy y hacer click en Verify now.
  4. Si el registro todavía no se ve, el botón muestra un error pidiendo reintentar en un rato. No hace falta borrar y volver a crear el dominio, se puede reintentar las veces que haga falta.
  5. En cuanto la verificación encuentra el TXT con el valor correcto, el dominio pasa a Pending y sigue el flujo normal de aplicación en Wings.

Eliminar un dominio

  1. En la fila del dominio, click en el ícono de basura.
  2. Confirmar en el modal ("Delete this domain? Wings will remove the nginx configuration from the node and revoke the certificate (if any). This cannot be undone.").
  3. El botón de borrar está deshabilitado mientras el dominio está en estado Pending.

El borrado es inmediato en la base de datos (el registro se elimina, no queda "soft deleted"), pero la limpieza real en el nodo (borrar el .conf, revocar el certificado, recargar nginx) corre de forma asíncrona igual que la creación.

Límites que puede encontrar el usuario

  • "This server has reached the maximum of N domains.": el admin del nodo puso un tope de dominios por servidor.
  • "The domain 'x' is already in use on this panel.": ese dominio ya está asignado a otro servidor (o al mismo). Los dominios son únicos en todo el panel, no por servidor.
  • "Let's Encrypt SSL mode is not enabled for this node." / "Cloudflare SSL mode is not enabled for this node." / "Custom SSL certificates are not enabled for this node.": el admin del nodo bloqueó ese modo específico.
  • "A certificate and private key are required for custom SSL mode.": falta pegar el certificado o la clave (o ambos) al elegir el modo Custom certificate.
  • "The selected network allocation does not belong to this server.": no debería aparecer nunca desde la UI normal (el selector de puerto solo lista allocations propias del server), solo si se llama a la API directamente con un allocation_id ajeno.
  • "The node hosting this server does not have the domain proxy feature enabled.": el admin todavía no configuró el proxy para ese nodo. El usuario no puede resolver esto por su cuenta, tiene que pedirle al administrador que lo habilite.

Siguiente: Modos SSL en detalle →