Domande Frequenti su ServBay

Durante l'utilizzo dell'ambiente di sviluppo web locale ServBay, potresti incontrare alcune difficoltà. Questo documento risponde a due delle domande più comuni: come aggiornare ServBay Runtime e come risolvere i problemi di accesso ai siti locali causati da strumenti proxy come ClashX Pro.

Come aggiornare ServBay Runtime?

ServBay Runtime è il componente centrale di ServBay ed è fondamentale per garantire il funzionamento stabile del servizio e delle applicazioni ospitate. Quando viene rilasciata una nuova versione, ServBay ti avviserà al momento dell'avvio suggerendo l'aggiornamento. Mantenere Runtime aggiornato migliora la stabilità, le prestazioni complessive e la compatibilità di ServBay.

Per aggiornare ServBay Runtime, segui questi passaggi:

1. Apri l'applicazione ServBay.
2. Nella barra di navigazione a sinistra della finestra di ServBay, seleziona Pacchetti > Servizi Generali.
3. Nel pannello di destra, trova la voce ServBay Runtime.
4. Se è disponibile un aggiornamento per ServBay Runtime, vedrai una notifica di aggiornamento gialla oppure un pulsante di aggiornamento. Clicca su questo pulsante giallo.
5. ServBay inizierà a scaricare e installare la versione più recente del Runtime. Attendi pazientemente il completamento dell’aggiornamento.

Dopo l'aggiornamento, ServBay Runtime sarà in esecuzione all'ultima versione, con maggiore stabilità e prestazioni migliorate.

Perché dopo aver utilizzato ClashX Pro (o altri strumenti proxy) non riesco più ad accedere ai siti locali in ServBay?

Molti sviluppatori usano ServBay per lo sviluppo e il test locale, spesso configurando domini personalizzati locali (ad esempio servbay.demo, myproject.servbay.demo ecc.) che vengono normalmente risolti verso l'indirizzo di loopback locale 127.0.0.1.

Quando utilizzi ClashX Pro o altri strumenti VPN/proxy (come Surge, Quantumult X, ecc.), questi strumenti potrebbero forzare tutte le richieste DNS a passare attraverso il server proxy intercettando o reindirizzando le richieste stesse. Questo comportamento bypassa il processo di risoluzione DNS del sistema operativo e le impostazioni locali del file hosts (su cui fa affidamento la risoluzione dei domini locali di ServBay), impedendo così che i domini di sviluppo configurati su ServBay vengano correttamente collegati all’IP locale, con conseguente impossibilità di accedere ai siti locali.

Per risolvere questo problema, è necessario aggiungere una regola nella configurazione dello strumento proxy affinché ignori o non intercetti le richieste DNS dei tuoi domini di sviluppo locale. Questo si realizza solitamente configurando voci come "Bypass proxy", "Ignora proxy", "Whitelist" o "Excluded domains".

Prendendo ClashX Pro come esempio, ecco come configurare:

1. Apri l'app ClashX Pro.
2. Trova l'icona di ClashX Pro nella barra menu di macOS, cliccaci sopra e seleziona Altre impostazioni.
3. Nella finestra delle impostazioni, vai alla scheda Generali.
4. Trova il campo chiamato Ignora le impostazioni proxy per questi host e domini (o denominazione simile).
5. Aggiungi i tuoi domini di sviluppo locale a questo elenco. Per coprire i domini più comuni di ServBay si consiglia di includere localhost, 127.0.0.1 e tutti i domini specifici o wildcard utilizzati in ServBay. Ad esempio, se usi .servbay.demo come suffisso dei tuoi domini locali, aggiungi *.servbay.demo. Solitamente, più voci si separano tramite virgola , o con una nuova riga. Una configurazione tipica potrebbe essere:

   localhost, 127.0.0.1, *.servbay.demo, yourproject.servbay.demo

6. Salva le impostazioni e, secondo quanto suggerito da ClashX Pro, potrebbe essere necessario ricaricare o applicare la configurazione affinché le modifiche abbiano effetto.

(Illustrazione: Impostazione degli host e domini esclusi dal proxy in ClashX Pro)

Dopo questa configurazione, ClashX Pro non interferirà più con la risoluzione DNS di questi domini locali e i tuoi siti web ServBay potranno essere raggiunti correttamente. Se il problema persiste, assicurati di aver configurato correttamente il dominio nelle Impostazioni del sito di ServBay e che i servizi relativi (come Caddy o Nginx) siano attivi. Puoi anche usare i comandi terminale ping yourproject.servbay.demo oppure dig yourproject.servbay.demo per diagnosticare la risoluzione dei domini.