Aggiunta di un dominio personalizzato al tuo progetto

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…

Ogni progetto Orbit viene servito a un indirizzo kaps.run gratuito, e puoi allegare i tuoi domini accanto ad esso con un certificato SSL fornito automaticamente. Questa guida copre l'aggiunta di un dominio, il record DNS di cui hai bisogno, come leggere gli stati di verifica, la scelta di un dominio primario e cosa controllare quando un dominio resta bloccato.

Prima di Iniziare

Ti serve un progetto Orbit con almeno una distribuzione riuscita, un dominio di cui controlli il DNS e un piano che include domini personalizzati. I domini personalizzati sono inclusi in Liftoff e Apex; il piano gratuito Launch non li include. Vedi Orbit Plan Limits.

Passaggio 1: Aggiungi il Dominio in Orbit

Apri il tuo progetto in Orbit.
Apri la scheda Domain, oppure fai clic su Manage domains dalla scheda Custom domains in Settings.
Sotto Add a domain, digita il nome host, ad esempio app.example.com.
Fai clic su Add.

Inserisci un nome host semplice. Non includere https://, una barra finale o un percorso: il modulo rifiuta qualsiasi cosa che non sia un nome host semplice con "Enter a valid hostname like app.example.com".

Domain tab of an Orbit project

Puoi aggiungere fino a 25 domini a un progetto. Il primo che aggiungi diventa il dominio primario.

Se il dominio è già allegato a un progetto Orbit diverso, Orbit lo rifiuta. Rimuovilo dall'altro progetto prima.

Passaggio 2: Aggiungi il Record DNS

Orbit mostra un pannello DNS setup con il record esatto da creare: un CNAME, con il Name e il Value da utilizzare. Il target è lo stesso indipendentemente da chi ospita il tuo DNS.

Se il Tuo Dominio Utilizza Kapsule DNS

Fai clic su Domains nella barra laterale di KPanel.
Fai clic sul tuo dominio.
Nell'editor DNS, aggiungi un record CNAME utilizzando il Name e il Value mostrati nella scheda Orbit Domain.

Se il Tuo Dominio Utilizza un Altro Provider DNS

Accedi a quel provider e aggiungi lo stesso record CNAME. L'interfaccia è diversa, ma il tipo di record, il nome e il valore no.

I domini apex (example.com senza sottodominio) non possono accettare un CNAME semplice secondo lo standard DNS. Molti provider offrono CNAME flattening o un record ALIAS o ANAME che raggiunge lo stesso risultato; usa quello se il tuo provider lo offre. Se non lo fa, pubblica su un sottodominio come www.example.com e reindirizza l'apex ad esso presso il tuo provider DNS o registrar.

Passaggio 3: Attendi la Verifica e l'SSL

Orbit controlla il DNS di sua iniziativa e la scheda Domain riporta dove è arrivato:

Quello che vedi	Quello che significa
Checking DNS…	Un controllo è in corso proprio ora
CNAME not detected yet	Il record non si è ancora propagato, oppure non è corretto
CNAME verified: SSL provisioning…	Il record si risolve, il certificato è in fase di emissione
SSL active: CNAME verified	Il dominio è live e viene servito su HTTPS

Fai clic su Re-check DNS per forzare un controllo piuttosto che aspettare il prossimo automatico.

La propagazione del DNS richiede da pochi minuti a diverse ore a seconda del TTL sui tuoi record precedenti. Il certificato viene emesso entro un minuto o due dal rilevamento del CNAME e si rinnova automaticamente finché il dominio rimane allegato.

Prima di aggiungere il record, abbassa il TTL sul record esistente per quel nome host e attendi che il vecchio TTL scada. Il passaggio avviene allora in minuti piuttosto che in ore. Questo è importante soprattutto quando stai spostando un nome host attivo piuttosto che aggiungerne uno nuovo.

Scelta del Dominio Primario

Con più di un dominio allegato, uno è contrassegnato come Primary. Fai clic su Set as primary domain su qualsiasi dominio verificato per cambiarlo. Il primario è l'indirizzo canonico del progetto; gli altri continuano a essere serviti.

Rimozione di un Dominio

Fai clic su Remove domain sulla riga.

La rimozione di un dominio lo mette fuori servizio immediatamente. I visitatori smettono di raggiungere il tuo progetto su quel nome host subito, e il certificato per esso non viene più mantenuto. Il record DNS presso il tuo provider non viene rimosso: eliminalo tu stesso una volta che non ne hai più bisogno, oppure continuerà a puntare a un nome host che non risponde più per te.

Il tuo progetto continua a essere servito al suo indirizzo kaps.run indipendentemente.

SSL è Automatico e Gratuito

Non acquisti mai, non carichi e non rinnovi un certificato per un dominio Orbit. Una volta che il CNAME si risolve, un certificato viene emesso e poi rinnovato automaticamente. Non c'è nessuna schermata di gestione dei certificati perché non c'è niente da gestire.

Risoluzione dei Problemi

Bloccato su "CNAME not detected yet".

Controlla il tipo di record. Un record A che punta a un indirizzo IP non verifica; deve essere un CNAME al valore che Orbit ti ha dato.
Controlla il nome del record. Molti editor DNS aggiungono la zona per te, quindi inserire app.example.com può produrre app.example.com.example.com. Inserisci solo app se l'editor mostra la zona come suffisso.
Controlla la presenza di un record in conflitto. Un A, AAAA o CNAME esistente con lo stesso nome vincerà o renderà la zona non valida. Rimuovilo.
Controlla di aver modificato la zona che è effettivamente autoritativa. Se hai spostato i nameserver di recente, potresti stare modificando la copia del vecchio provider.
Aspetta il TTL del record che hai sostituito.

Verificato, ma il certificato non si attiva. Un record CAA sul dominio può impedire l'emissione. Rimuovilo oppure aggiungi una voce che consenta l'autorità di certificazione che Kapsule utilizza. Se non sei sicuro, contatta il supporto con il nome del dominio.

"This domain is already attached to another project." Esattamente quello che dice. Trova l'altro progetto Orbit e rimuovi il dominio lì prima.

"Domain limit reached." Sei a 25 domini su questo progetto. Rimuovine uno che non ti serve più.

Il dominio si risolve ma mostra il sito sbagliato. Controlla il target CNAME carattere per carattere. È facile allegare il dominio a un progetto e puntare il DNS a un altro.

Letture Correlate

What Is Orbit? per come funziona l'indirizzo kaps.run
Configuring Redirects and Rewrites per inviare i vecchi percorsi ai nuovi una volta che il dominio è live
Orbit Plan Limits per quali piani includono domini personalizzati