Agregar un Dominio Personalizado a Tu Proyecto

Every Orbit project serves on a free kaps.run address, and you can attach your own domains alongside it with an SSL certificate provisioned automatically. This guide covers adding a domain, the DNS…

Cada proyecto Orbit se sirve en una dirección kaps.run gratuita, y puedes adjuntar tus propios dominios junto a ella con un certificado SSL aprovisionado automáticamente. Esta guía cubre la adición de un dominio, el registro DNS que necesitas, cómo leer los estados de verificación, elegir un dominio primario y qué verificar cuando un dominio se queda atascado.

Antes de Empezar

Necesitas un proyecto Orbit con al menos una implementación exitosa, un dominio del que controles el DNS y un plan que incluya dominios personalizados. Los dominios personalizados se incluyen en Liftoff y Apex; el plan Launch gratuito no los incluye. Consulta Límites del Plan Orbit.

Paso 1: Agregar el Dominio en Orbit

Abre tu proyecto en Orbit.
Abre la pestaña Domain, o haz clic en Manage domains desde la tarjeta Custom domains en Settings.
Bajo Add a domain, escribe el nombre de host, por ejemplo app.example.com.
Haz clic en Add.

Ingresa un nombre de host simple. No incluyas https://, una barra diagonal final o una ruta: el formulario rechaza cualquier cosa que no sea un nombre de host simple con "Enter a valid hostname like app.example.com".

Domain tab of an Orbit project

Puedes agregar hasta 25 dominios a un proyecto. El primero que agregues se convierte en el dominio primario.

Si el dominio ya está adjunto a un proyecto Orbit diferente, Orbit lo rechaza. Elimínalo del otro proyecto primero.

Paso 2: Agregar el Registro DNS

Orbit muestra un panel DNS setup con el registro exacto a crear: un CNAME, con el Name y Value a usar. El destino es el mismo sin importa quién aloje tu DNS.

Si Tu Dominio Usa Kapsule DNS

Haz clic en Domains en la barra lateral de KPanel.
Haz clic en tu dominio.
En el editor DNS, agrega un registro CNAME usando el Name y Value mostrados en la pestaña Orbit Domain.

Si Tu Dominio Usa Otro Proveedor DNS

Inicia sesión en ese proveedor y agrega el mismo registro CNAME. La interfaz difiere, pero el tipo de registro, nombre y valor no.

Los dominios apex (example.com sin subdominio) no pueden tomar un CNAME simple según el estándar DNS. Muchos proveedores ofrecen CNAME flattening o un registro ALIAS o ANAME que logra lo mismo; usa eso si el tuyo lo tiene. Si no, publica en un subdominio como www.example.com y redirige el apex al mismo en tu proveedor DNS o registrador.

Paso 3: Esperar la Verificación y SSL

Orbit verifica DNS por su cuenta y la pestaña Domain informa dónde ha llegado:

Lo que ves	Lo que significa
Checking DNS…	Ahora mismo se está ejecutando una verificación
CNAME not detected yet	El registro no se ha propagado o no es correcto
CNAME verified: SSL provisioning…	El registro se resuelve, se está emitiendo el certificado
SSL active: CNAME verified	El dominio está activo y se sirve sobre HTTPS

Haz clic en Re-check DNS para forzar una verificación en lugar de esperar la siguiente automática.

La propagación DNS toma desde unos pocos minutos hasta varias horas según el TTL en tus registros anteriores. El certificado se emite dentro de un minuto o dos después de que se detecte el CNAME y se renueva automáticamente mientras el dominio permanezca adjunto.

Antes de agregar el registro, reduce el TTL en el registro existente para ese nombre de host y espera a que expire el TTL antiguo. El cambio entonces toma minutos en lugar de horas. Esto importa más cuando estás moviendo un nombre de host activo en lugar de agregar uno nuevo.

Elegir el Dominio Primario

Con más de un dominio adjunto, uno está marcado como Primary. Haz clic en Set as primary domain en cualquier dominio verificado para cambiarlo. El primario es la dirección canónica del proyecto; los otros continúan sirviendo.

Eliminar un Dominio

Haz clic en Remove domain en la fila.

Eliminar un dominio lo saca del servicio inmediatamente. Los visitantes dejan de alcanzar tu proyecto en ese nombre de host de inmediato, y el certificado para él ya no se mantiene. El registro DNS en tu proveedor no se elimina: elimínalo tú mismo una vez que ya no lo necesites, o seguirá apuntando a un nombre de host que ya no responde para ti.

Tu proyecto continúa sirviendo en su dirección kaps.run sin importar qué.

SSL es Automático y Gratuito

Nunca compres, subas ni renueves un certificado para un dominio Orbit. Una vez que el CNAME se resuelve, se emite un certificado y luego se renueva automáticamente. No hay pantalla de gestión de certificados porque no hay nada que gestionar.

Solución de Problemas

Atascado en "CNAME not detected yet".

Verifica el tipo de registro. Un registro A que apunta a una dirección IP no se verifica; debe ser un CNAME al valor que te dio Orbit.
Verifica el nombre del registro. Muchos editores DNS agregan la zona por ti, así que ingresar app.example.com puede producir app.example.com.example.com. Ingresa solo app si el editor muestra la zona como sufijo.
Verifica si hay un registro conflictivo. Un A, AAAA o CNAME existente con el mismo nombre ganará o hará que la zona sea inválida. Elimínalo.
Verifica que hayas editado la zona que es realmente autoritativa. Si recientemente moviste nameservers, es posible que estés editando la copia del proveedor anterior.
Espera el TTL del registro que reemplazaste.

Verificado, pero el certificado no se activa. Un registro CAA en el dominio puede evitar la emisión. Elimínalo o agrega una entrada que permita la autoridad de certificación que Kapsule usa. Si no estás seguro, contacta con soporte con el nombre de dominio.

"This domain is already attached to another project." Exactamente lo que dice. Encuentra el otro proyecto Orbit y elimina el dominio allí primero.

"Domain limit reached." Estás en 25 dominios en este proyecto. Elimina uno que ya no necesites.

El dominio se resuelve pero muestra el sitio incorrecto. Verifica el destino CNAME carácter por carácter. Es fácil adjuntar el dominio a un proyecto y apuntar DNS a otro.

Lecturas Relacionadas

What Is Orbit? para cómo funciona la dirección kaps.run
Configuring Redirects and Rewrites para enviar rutas antiguas a nuevas una vez que el dominio está activo
Orbit Plan Limits para qué planes incluyen dominios personalizados