Collegare un dominio al tuo server con il Proxy Manager (HTTPS)
Il Proxy Manager di OuiPanel, il pannello di gioco di OuiHeberg, collega il tuo dominio a un'applicazione web del tuo server. Funziona come un reverse proxy, in HTTP o in HTTPS con un certificato Let's Encrypt. Questa guida ti mostra come creare il record DNS, verificarne la propagazione e poi collegare il dominio a una porta. Il Proxy Manager è disponibile sui server Python, Node.js, Minecraft e Hytale.
Ad esempio, la tua applicazione Node.js è in ascolto su una porta del tuo server. Con il Proxy Manager diventa raggiungibile su https://esempio.com.
| Tipo di server | Utilizzo |
|---|---|
| Node.js | Sito web, API REST, dashboard, bot Discord con pannello web |
| Python | Applicazione Flask o Django, API FastAPI, dashboard |
| Minecraft | Dynmap, BlueMap, Plan, interfaccia web di un plugin |
Ti serve un tuo dominio e l'accesso alla sua zona DNS. Il Proxy Manager non ne fornisce. La tua applicazione deve anche essere avviata e in ascolto su una porta del tuo server.
Trovare la destinazione DNS del server
Accedi a OuiPanel su dash.ouipanel.com e apri il tuo server.
Nel menu laterale, clicca su Proxy Manager.
La scheda La destinazione DNS di questo server indica il record da creare presso il tuo registrar. L'etichetta accanto al titolo mostra il proxy usato, ad esempio «Proxy FR».
| Colonna | Cosa indica |
|---|---|
| Tipo | Il tipo di record, sempre A |
| Nome | @ per il dominio principale, da sostituire con il sottodominio se serve |
| Valore | L'indirizzo IP del proxy, con un'icona per copiarlo |

Creare il record DNS presso il tuo registrar
Crea un record DNS di tipo A che punti il tuo dominio al Valore mostrato su OuiPanel.
| Campo | Valore |
|---|---|
| Tipo | A |
| Nome / Host | @ (dominio principale) o sottodominio (www, app, panel...) |
| Valore / Destinazione | L'indirizzo IP della scheda La destinazione DNS di questo server |
| TTL | 3600 (o Auto) |
Esempi in base al dominio
| Vuoi usare | Nome / Host da inserire |
|---|---|
esempio.com | @ o lascia vuoto |
www.esempio.com | www |
app.esempio.com | app |
panel.esempio.com | panel |
api.esempio.com | api |
Su Cloudflare
Accedi alla dashboard di Cloudflare e seleziona il tuo dominio.
Vai in DNS › Records, poi clicca su Add record.
Scegli il Type
A. In Name, scrivi@per il dominio principale o il sottodominio che vuoi.In IPv4 address, incolla l'indirizzo IP del proxy.
Disattiva il Proxy status per avere l'icona grigia «DNS only». Lascia il TTL su Auto.
Clicca su Save.
Il proxy di Cloudflare deve restare disattivato (icona grigia, non arancione). Altrimenti il certificato HTTPS non può essere emesso.
Verificare la propagazione DNS
Un nuovo record impiega un po' di tempo a diffondersi ovunque. OuiPanel lo ricorda sotto la destinazione DNS: la propagazione richiede da 5 minuti a 48 ore, a seconda del registrar.
| Registrar | Tempo abituale |
|---|---|
| Cloudflare | Da 1 a 5 minuti |
| Gandi | Da 30 minuti a 2 ore |
| Altri | Fino a 24 o 48 ore |
Verificare online
Questi strumenti gratuiti mostrano quale indirizzo restituisce il tuo dominio nel mondo.
| Strumento | Link |
|---|---|
| DNS Checker | dnschecker.org |
| What's My DNS | whatsmydns.net |
| MX Toolbox | mxtoolbox.com/DNSLookup.aspx |
Inserisci il tuo dominio, ad esempio
esempio.com.Scegli il tipo A.
Controlla che l'indirizzo mostrato sia quello della destinazione DNS di OuiPanel.
OuiPanel verifica il DNS anche quando colleghi il dominio, nel passaggio successivo.
Collegare il dominio su OuiPanel
Nel Proxy Manager, clicca su Aggiungi un dominio. Si apre il modulo Nuovo collegamento.
Compila i campi con i valori della tabella qui sotto.
Clicca su Verifica il DNS.
Quando il pannello mostra «Il DNS punta qui», clicca su Crea il reindirizzamento.
| Campo | Descrizione | Esempio |
|---|---|---|
| Nome di dominio | Il tuo dominio completo | esempio.com o app.esempio.com |
| Porta | La porta del tuo server su cui ascolta l'applicazione, scelta dall'elenco | 3000 |
| HTTPS | Casella Certificato richiesto, spuntata per impostazione predefinita. Il certificato Let's Encrypt si rinnova automaticamente. | Spuntata |
L'elenco Porta propone solo le porte assegnate al tuo server. Per aggiungerne una, apri Configurazione › Gestione porte, clicca su Assegna una nuova porta e imposta la tua applicazione su quella porta.

Il pulsante Crea il reindirizzamento resta grigio finché il DNS non è stato verificato. La verifica evita di chiedere un certificato per un dominio che non punta ancora al server, perché Let's Encrypt limita il numero di richieste a settimana.
| Messaggio | Cosa fare |
|---|---|
| Il DNS punta qui | Clicca su Crea il reindirizzamento. |
| Il DNS non punta qui | Il pannello mostra l'indirizzo atteso e quello trovato. Correggi il record o attendi la propagazione, poi verifica di nuovo. |
| La verifica non è andata a buon fine | Il pannello non è riuscito a interrogare i server dei nomi. Puoi comunque tentare la creazione, il pannello rifà il controllo prima di agire. |
Una volta creato il reindirizzamento, il dominio compare in Domini collegati. Apri https://esempio.com per controllare.
Non serve configurare l'HTTPS nella tua applicazione. Il Proxy Manager gestisce la cifratura e la tua applicazione continua a rispondere in HTTP.
Gestire i domini collegati
Ogni dominio collegato ha la sua scheda in Domini collegati. Puoi collegare più domini e sottodomini, ciascuno a una porta del tuo server.
| Elemento | Descrizione |
|---|---|
| Etichetta HTTPS o HTTP | Lucchetto chiuso se il dominio ha un certificato, aperto se risponde solo in HTTP |
| Proxy › Porta del server | Il percorso del reindirizzamento, dal proxy alla porta del tuo server |
| Apri il sito | Apre il dominio in una nuova scheda del browser |
| Rinnova il certificato | Richiede un nuovo certificato Let's Encrypt |
| Icona del cestino | Elimina il dominio |
Rinnovare il certificato
Il certificato si rinnova da solo 30 giorni prima della scadenza. Il pulsante Rinnova il certificato serve solo se il certificato non funziona. Se è ancora valido, il pannello mostra «Nessun rinnovo necessario» e propone Riemetti comunque.
Let's Encrypt consente solo cinque certificati identici a settimana per un dominio. Ogni nuova emissione ne consuma uno. Il sito continua a rispondere durante l'operazione.
Eliminare un dominio
Nella scheda del dominio, clicca sull'icona del cestino.
Nella finestra Eliminare questo dominio, clicca su Elimina il dominio.
Il sito smette di rispondere su quel nome e il suo certificato HTTPS viene rimosso. Il server, i suoi file e i suoi backup non vengono toccati. Puoi ricollegare il dominio più tardi.
Risolvere un problema
«Il DNS non punta qui» anche se il record esiste
| Causa | Soluzione |
|---|---|
| Propagazione in corso | Attendi, fino a 48 ore a seconda del registrar. |
| Indirizzo IP errato | Controlla che l'IP sia quello della scheda La destinazione DNS di questo server. |
| Proxy di Cloudflare attivo | Disattivalo, l'icona deve essere grigia. |
| Record CNAME invece di A | Eliminalo e ricrealo come record A. |
Il sito non si carica (errore 502 o 504)
| Causa | Soluzione |
|---|---|
| Applicazione ferma | Avvia il tuo server su OuiPanel. |
| Porta errata | Controlla che la porta collegata sia quella su cui ascolta l'applicazione. |
| Applicazione andata in crash | Guarda gli errori nella Console. |
L'applicazione funziona in locale ma non con il dominio
La tua applicazione deve ascoltare su tutte le interfacce (0.0.0.0), non su localhost. Negli esempi qui sotto, sostituisci 3000 con la porta collegata.
Node.js:
// Sbagliato
app.listen(3000, 'localhost');
app.listen(3000, '127.0.0.1');
// Corretto
app.listen(3000, '0.0.0.0');
Python (Flask):
# Sbagliato
app.run(host='127.0.0.1', port=3000)
# Corretto
app.run(host='0.0.0.0', port=3000)
«HTTPS richiesto, ma non ottenuto» o errore di certificato
In questo caso il dominio è collegato, ma solo in HTTP.
| Causa | Soluzione |
|---|---|
| Record DNS troppo recente | Elimina il dominio e ricollegalo tra qualche ora. |
| Proxy di Cloudflare attivo | Disattivalo, è obbligatorio. |
| DNS errato | Controlla che il dominio punti all'indirizzo IP giusto. |
«Questo dominio è già in uso»
Questo dominio è già collegato a un altro server OuiPanel.
Se è il tuo vecchio server, elimina il dominio dal suo Proxy Manager.
Se il vecchio server non esiste più, contatta il supporto di OuiHeberg.
Hai bisogno di aiuto?
Apri un ticket da Ticket › Aprire un ticket, oppure dal riquadro Contatta il supporto in fondo alla scheda del tuo server nell'area clienti. Puoi anche fare la tua domanda sul Discord di OuiHeberg.