Domini attivi convalidati, link specifici per negozio e un piano sicuro per sostituire i vecchi hostname.
1. Pianifica gli indirizzi
Ogni dominio base ha tre ruoli: Console per il tuo team, Checkout per i clienti e API pubblica per le integrazioni. I nomi predefiniti sono merchant, pay e api; puoi sceglierne altri e aggiungere alias.
| Ruolo | Primo dominio | Secondo dominio |
|---|---|---|
| Console | merchant.example.com | panel.example.org |
| Checkout | pay.example.com | payment.example.org |
| API pubblica | api.example.com | api.example.org |
Entrambi i domini raggiungono la stessa installazione. Non creano wallet, dati o permessi di accesso separati. Il dominio preferito di un negozio controlla i link generati; non isola gli utenti ospitati.
2. Aggiungi un dominio o gestisci gli alias
Apri Impostazioni → Sistema → Domini. Usa Aggiungi dominio sopra Domini attivi per una nuova base come example.org. Usa Gestione su una voce esistente per aggiungere alias o cambiare gli indirizzi principali.
Per esempio, mantieni sia merchant sia panel come nomi della console. Il primo nome, contrassegnato da una stella, è il principale per quel ruolo. Scegli il dominio base principale per i link predefiniti di sistema.
Un nome base attivo non viene rinominato sul posto; aggiungi invece un dominio sostitutivo. Le bozze mostrano In attesa di attivazione e non sono ancora attive. Scegli Continua al DNS per salvare e controllare.
3. Punta il DNS al VPS
Aggiungi un record A per ogni nuovo hostname, puntando all'IPv4 del VPS mostrato dal pannello. Aggiungi AAAA solo quando quell'indirizzo IPv6 raggiunge davvero il server. Rimuovi i record obsoleti; Wholly Crypto non modifica il DNS per te.
Mantieni in entrata TCP 80 e 443 aperti nei firewall del server e del provider. Lascia intatto l'accesso SSH. Fai clic su Controlla DNS. Controlla le coppie host/ruolo nuove o modificate rispetto al DNS autorevole; gli indirizzi attivi invariati vengono riutilizzati.
Usi Cloudflare?
Per la prima installazione, mantieni il proxy disattivato fino al completamento. Dopo puoi usare DNS diretto o tramite proxy senza cambiare modalità in Wholly Crypto. Let's Encrypt resta sul VPS.
Usa Full (strict) ↗. Mantieni raggiungibile la verifica HTTP del certificato ed escludi cache e verifiche browser/bot per richieste di console, checkout e API. Wholly Crypto deve poter verificare anche l'origine.
I controlli autorevoli aggirano le normali cache degli indirizzi di VPS/ISP. I visitatori possono ancora avere DNS vecchi nella cache e i cambi di nameserver possono richiedere più tempo.
4. Controlla, poi pubblica
Salvare una bozza o superare i controlli DNS non cambia le rotte attive.
Controlla aggiunte, rimozioni e cambi di indirizzo principale, poi scegli Continua all'attivazione → Convalida SSL e pubblica. Modifiche o un controllo DNS più vecchio di dieci minuti richiedono un nuovo controllo.
I nuovi indirizzi vengono controllati per verifiche dei certificati, HTTPS e servizio corretto. Le coppie host/ruolo attive invariate non ripetono questi controlli di rete, ma viene comunque convalidata l'intera configurazione Nginx.
Attendi il successo e il ritorno a Domini attivi. Apri ogni nuovo hostname e controllane il ruolo. In caso di errore, leggi il rapporto di distribuzione e lo stato del rollback prima di riprovare; non eliminare il dominio funzionante per forzare l'attivazione.
5. Scegli i domini per ogni negozio
Vai a Progetto → Negozi → seleziona negozio → Generale → Domini del negozio. Scegli gli host merchant, checkout e API attivi per quel negozio. Gli indirizzi in attesa non possono essere selezionati.
I link generati usano scelta del negozio → negozio predefinito del progetto → valore predefinito del sistema. Per esempio, il campo dell'API delle fatture links.checkout può usare payment.example.org per un negozio mentre un altro mantiene pay.example.com.
Configura separatamente le origini API di SDK e plugin del negozio; cambiare una preferenza del negozio non riscrive le impostazioni delle integrazioni. I nuovi tentativi IPN/webhook firmati conservati mantengono i link originali. Segnalibri e link dei clienti esistenti non vengono riscritti.
Gli alias della console richiedono comunque Basic Auth e un accesso all'applicazione. In Impostazioni → Sistema → Restrizioni IP di origine, le regole si applicano separatamente a ogni hostname. Mantieni aperto il checkout cliente, salvo che tu gestisca volutamente un checkout privato.
6. Sostituisci i vecchi indirizzi in due fasi
- Aggiungi e pubblica il sostituto mentre il vecchio hostname funziona ancora.
- Apri il nuovo indirizzo della console e accedi. Prova checkout e accesso API tramite i loro sostituti.
- Aggiorna preferenze del negozio, integrazioni, segnalibri e link pubblicati. Mantieni i vecchi alias pay/API finché clienti o client li usano.
- Dal nuovo indirizzo della console, gestisci il vecchio dominio o alias e prepara la rimozione. Controlla e pubblica la modifica prima di rimuoverne il record DNS.
Il pannello impedisce di rimuovere l'hostname della console che stai usando. Gli host ritirati vengono rifiutati, non reindirizzati automaticamente. Un cambio del solo indirizzo principale o una rimozione richiede comunque revisione e pubblicazione, anche quando non serve una nuova ricerca DNS.