FAQ ServBay — Problèmes courants et solutions

Lors de l’utilisation de l’environnement de développement web local ServBay, il peut arriver que des développeurs rencontrent certains problèmes. Ce document répond à deux questions fréquemment posées : comment mettre à jour ServBay Runtime et comment résoudre les problèmes d’accès aux sites locaux dûs à l’utilisation d’outils proxy comme ClashX Pro.

Comment mettre à jour ServBay Runtime ?

ServBay Runtime est le composant central de ServBay, essentiel au bon fonctionnement et à la stabilité des services hébergés. Lorsqu’une nouvelle version est disponible, ServBay vous invite à effectuer la mise à niveau au démarrage. Mettre à jour régulièrement le Runtime permet d’optimiser les performances, la stabilité et d’assurer la compatibilité du système.

Pour effectuer la mise à jour de ServBay Runtime, procédez comme suit :

1. Ouvrez l’application ServBay.
2. Dans la barre de navigation à gauche, sélectionnez Packages > Services généraux.
3. Dans le panneau de droite, repérez l’entrée nommée ServBay Runtime.
4. Si une mise à jour est disponible pour ServBay Runtime, une notification jaune ou un bouton de mise à niveau apparaîtra. Cliquez alors sur ce bouton jaune.
5. ServBay téléchargera et installera automatiquement la dernière version du Runtime. Patientez jusqu’à la fin de l’opération.

Après la mise à jour, ServBay Runtime fonctionnera avec la version la plus récente, offrant ainsi une meilleure stabilité et des performances accrues.

Pourquoi l’accès aux sites locaux dans ServBay devient-il impossible après l’activation de ClashX Pro (ou d’autres proxys) ?

De nombreux développeurs utilisent ServBay pour coder et tester localement, en configurant souvent des noms de domaines personnalisés (par exemple servbay.demo, myproject.servbay.demo), qui pointent généralement vers l’adresse de bouclage locale 127.0.0.1.

Lorsque vous activez ClashX Pro ou certains outils VPN/proxy (tels que Surge, Quantumult X, etc.), ces applications peuvent intercepter ou rediriger les requêtes DNS de façon à forcer la résolution de tous les domaines via leur serveur proxy. Ce comportement contourne le mécanisme DNS du système d’exploitation et le fichier hosts local (sur lequel repose la résolution des noms de domaine personnalisés de ServBay), empêchant ainsi la redirection correcte vers l’adresse IP locale et donc l’accès à votre site local.

Pour remédier à ce problème, vous devez ajouter une règle dans la configuration de votre proxy afin de ne pas intercepter les requêtes DNS ou le trafic concernant vos domaines de développement locaux. Cela se fait généralement en configurant une “liste de contournement”, une “liste blanche”, ou une “exclusion de proxy”.

Prenons l’exemple de ClashX Pro. Voici la procédure à suivre :

1. Ouvrez l’application ClashX Pro.
2. Dans la barre de menu de macOS, cliquez sur l’icône de ClashX Pro, puis choisissez Paramètres supplémentaires.
3. Dans la fenêtre de configuration qui s’ouvre, allez dans l’onglet Général.
4. Cherchez la zone intitulée Ignorer le proxy pour ces hôtes et domaines (ou libellé similaire).
5. Ajoutez vos domaines de développement local dans cette liste. Pour couvrir les domaines fréquents de ServBay, il est recommandé d’ajouter localhost, 127.0.0.1 ainsi que vos propres domaines personnalisés ou des jokers. Si vous utilisez le suffixe .servbay.demo pour vos domaines locaux, ajoutez par exemple *.servbay.demo. Les différentes entrées doivent généralement être séparées par une virgule ou une nouvelle ligne. Une configuration type pourrait être :

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

6. Enregistrez les modifications et, selon les instructions de ClashX Pro, rechargez ou appliquez la nouvelle configuration pour que les changements prennent effet.

(Illustration : configuration de l’ignorance du proxy pour certains hôtes et domaines dans ClashX Pro)

Une fois cette configuration mise en place, ClashX Pro ne perturbera plus la résolution de ces domaines locaux spécifiques et vos sites ServBay devraient de nouveau fonctionner normalement. Si le problème persiste, vérifiez que le domaine est bien configuré dans les paramètres Site de ServBay et que les services concernés (comme Caddy ou Nginx) sont opérationnels. Vous pouvez également utiliser des commandes terminal telles que ping yourproject.servbay.demo ou dig yourproject.servbay.demo pour diagnostiquer la résolution DNS de votre domaine.