Accéder à un hôte virtuel via Localtonet
Sur cette page 10 sections
- Pourquoi un hôte virtuel exige le bon en-tête Host
- Avant de commencer
- Créer le tunnel
- Ouvrir la page HTTP
- Remplir le formulaire
- Démarrer le tunnel
- Option 1 : définir l'en-tête Host dans le tunnel
- Option 2 : ajouter le nom du tunnel à l'hôte virtuel
- Apache
- Nginx
- Option 3 : utiliser votre propre domaine
- Plusieurs hôtes virtuels
- Le sécuriser
- Problèmes courants
- Pages associées
Mettez en ligne un site d'un serveur Apache ou Nginx local, y compris les configurations XAMPP, WampServer et MAMP avec plusieurs sites : créez un tunnel HTTP et veillez à ce que le serveur web reçoive un nom d'hôte qu'il connaît.
Pourquoi un hôte virtuel exige le bon en-tête Host #
Avec les hôtes virtuels basés sur le nom, un seul serveur web répond pour plusieurs sites sur le même port. Il choisit le site d'après l'en-tête Host de chaque requête : une requête pour mysite.test obtient le site dont la configuration nomme mysite.test.
Un tunnel HTTP transmet l'en-tête Host du visiteur à votre serveur web sans le modifier. Un visiteur qui ouvre l'adresse du tunnel envoie donc le nom d'hôte du tunnel, par exemple un nom se terminant par .localto.net, et non mysite.test. Votre serveur web ne connaît pas ce nom et répond avec son site par défaut, qui est généralement le premier de la configuration, ou la page d'accueil de XAMPP ou de WampServer.
Il existe trois façons de corriger cela. Choisissez-en une :
| Option | Ce que vous modifiez | Idéal pour |
|---|---|---|
| Définir l'en-tête Host dans le tunnel | Un en-tête de requête dans les paramètres du tunnel. Rien à toucher sur le serveur web. | Un aperçu rapide d'un site statique ou simple. |
| Ajouter le nom du tunnel à l'hôte virtuel | Une ligne dans la configuration du serveur web. | Les applications qui construisent des liens et des redirections à partir du nom d'hôte. |
| Utiliser votre propre domaine | Le tunnel utilise un domaine qui vous appartient, et l'hôte virtuel porte son nom. | Un site qui doit conserver une seule adresse. |
Avant de commencer #
- Un compte Localtonet et le client Localtonet connecté avec votre AuthToken sur l'ordinateur qui exécute le serveur web. Consultez Démarrage rapide.
- Un hôte virtuel qui fonctionne dans un navigateur sur cet ordinateur, par exemple
http://mysite.test. - Le port sur lequel le serveur web écoute. XAMPP et WampServer utilisent
80. MAMP utilise8888, sauf si vous l'avez modifié.
Créer le tunnel #
-
Ouvrir la page HTTP #
Ouvrez Mes tunnels › HTTP et développez Créer un tunnel HTTP.
-
Remplir le formulaire #
Champ Ce qu'il faut saisir Type d'URL Sous-domaine aléatoire pour les options 1 et 2. Pour l'option 3, choisissez Domaine personnalisé. Jeton d'appareil Le jeton utilisé par le client Localtonet sur l'ordinateur. Région du serveur Choisissez une région proche de votre appareil pour une latence plus faible. Adresse IP locale 127.0.0.1. Saisissez l'adresse, pas le nom de l'hôte virtuel : le nom circule dans l'en-têteHost.Port local Le port du serveur web, par exemple 80.Sélectionnez Créer le tunnel.
-
Démarrer le tunnel #
Le tunnel apparaît sous Vos tunnels. Sélectionnez Démarrer et notez l'adresse publique dans la colonne URL. Si vous l'ouvrez maintenant, vous voyez le site par défaut du serveur web. L'étape suivante corrige cela.
Le formulaire du tunnel est décrit en détail sur la page HTTP / HTTPS.
Option 1 : définir l'en-tête Host dans le tunnel #
Le tunnel peut remplacer l'en-tête Host avant qu'une requête n'atteigne votre serveur web. Ce réglage est un en-tête de requête nommé Host :
- Sélectionnez Paramètres sur la ligne du tunnel.
- À côté de En-têtes, sélectionnez Gérer. La fenêtre En-têtes HTTP s'ouvre sur En-têtes de requête.
- Sélectionnez Hôte sous Suggestions, ou sélectionnez Ajouter un en-tête de requête et saisissez
Hostcomme nom. - Comme valeur, saisissez le nom de votre hôte virtuel, par exemple
mysite.test. La suggestion renseignelocalhost; remplacez-le. Saisissez uniquement le nom d'hôte, sanshttp://et sans chemin. - Sélectionnez Enregistrer.
Le tableau de bord décrit ainsi l'en-tête de requête Hôte : votre service reçoit ce nom d'hôte au lieu de l'adresse du tunnel, ce qui est utile lorsqu'un serveur web local choisit le site d'après le nom d'hôte. Sans en-tête de requête Host, votre service reçoit le nom d'hôte utilisé par le visiteur.
Ouvrez à nouveau l'adresse du tunnel. Le serveur web reçoit désormais Host: mysite.test et répond avec ce site. Pour revenir en arrière, supprimez l'en-tête et enregistrez.
L'application voit aussi le nom local. Un logiciel qui construit des liens et des redirections à partir de l'en-tête Host, ou d'une adresse de site configurée, envoie désormais les visiteurs vers mysite.test, qui n'existe que sur votre ordinateur. Si les pages se chargent sans styles ou si une connexion redirige vers le nom local, utilisez plutôt l'option 2 ou 3.
L'API propose le même réglage que le remplacement de l'en-tête Host d'un tunnel HTTP. Consultez API. Les autres en-têtes de requête et de réponse sont traités sur la page En-têtes et réécritures.
Option 2 : ajouter le nom du tunnel à l'hôte virtuel #
Indiquez au serveur web que le nom d'hôte du tunnel appartient à votre site. Copiez le nom d'hôte depuis l'URL du tunnel, sans https://, et ajoutez-le comme alias. Laissez les En-têtes du tunnel vides.
Apache #
Dans XAMPP, les hôtes virtuels se trouvent dans apache\conf\extra\httpd-vhosts.conf. Ajoutez une ligne ServerAlias :
<VirtualHost *:80>
ServerName mysite.test
ServerAlias <TUNNEL_HOST>
DocumentRoot "C:/xampp/htdocs/mysite"
</VirtualHost>Redémarrez Apache.
Nginx #
Ajoutez le nom d'hôte du tunnel à server_name :
server {
listen 80;
server_name mysite.test <TUNNEL_HOST>;
root /var/www/mysite;
index index.html index.php;
}Vérifiez la configuration et rechargez Nginx :
sudo nginx -t && sudo nginx -s reloadUn tunnel HTTP conserve son sous-domaine jusqu'à ce que vous supprimiez le tunnel ; l'alias reste donc valide d'un redémarrage à l'autre.
Option 3 : utiliser votre propre domaine #
Lorsque le tunnel s'exécute sur un domaine qui vous appartient, les visiteurs envoient ce domaine dans l'en-tête Host, et vous nommez l'hôte virtuel d'après lui. Aucun remplacement d'en-tête ni alias n'est nécessaire, et les liens que l'application construit sont corrects.
- Ajoutez le domaine à votre compte et créez le tunnel HTTP avec Type d'URL défini sur Domaine personnalisé. Les étapes figurent sur la page Domaines personnalisés. Les domaines personnalisés nécessitent du solde.
- Définissez
ServerName(Apache) ouserver_name(Nginx) de l'hôte virtuel sur ce domaine, comme dans les extraits ci-dessus.
Sous-domaine personnalisé fonctionne de la même manière, avec un nom de votre choix au lieu d'un nom aléatoire. Il nécessite aussi du solde.
Plusieurs hôtes virtuels #
Un tunnel HTTP a une seule adresse publique et atteint un seul site. Pour chaque hôte virtuel supplémentaire, créez un autre tunnel HTTP vers la même Adresse IP locale et le même Port local, et appliquez-lui l'une des options. L'offre gratuite autorise un seul tunnel au total. Consultez Offres et solde.
Le sécuriser #
Un site de développement n'est souvent pas prêt à être vu par des inconnus. Un tunnel HTTP peut demander aux visiteurs de s'identifier avant qu'une requête n'atteigne votre serveur web :
- Authentification basique ? dans les Paramètres du tunnel demande un nom d'utilisateur et un mot de passe aux visiteurs.
- Restriction IP › Gérer n'autorise la connexion qu'aux adresses que vous indiquez. Cela nécessite du solde.
- Fournisseurs SSO oblige les visiteurs à se connecter d'abord auprès d'un fournisseur d'identité. Cela nécessite du solde.
Les trois sont décrits sur la page Contrôle d'accès. Pour une démonstration, Date d'expiration arrête le tunnel à la date que vous définissez. Consultez Limites et expiration.
Problèmes courants #
Je vois la page d'accueil de XAMPP ou de WampServer, ou le mauvais site
Le serveur web n'a pas reconnu le nom d'hôte et a servi son site par défaut. Appliquez l'une des trois options. Avec l'option 1, vérifiez que le nom de l'en-tête est Host et que sa valeur correspond à ServerName ou server_name du site. Avec l'option 2, vérifiez que l'alias ne contient pas de faute de frappe et redémarrez le serveur web.
La page se charge sans styles, ou les liens mènent à mysite.test
L'application construit ses adresses à partir du nom local. Utilisez l'option 2 ou 3 pour que l'application voie le nom public. Les applications qui conservent une adresse de site doivent aussi voir cette adresse modifiée : pour WordPress, mettez à jour l'URL du site avec l'adresse du tunnel ou utilisez un domaine personnalisé.
Le site redirige vers http:// et le navigateur affiche un avertissement ou une boucle
Les visiteurs utilisent HTTPS sur l'adresse du tunnel, alors que le tunnel parle en HTTP simple à votre serveur web. Une application qui force HTTPS d'elle-même peut ne pas remarquer que le visiteur est déjà en HTTPS. Dans En-têtes, l'en-tête de requête X-Forwarded-Proto proposé dans les Suggestions, avec la valeur https, indique à une telle application que les visiteurs utilisent HTTPS.
Les visiteurs voient d'abord une page d'avertissement Localtonet
Sur les comptes sans solde, Localtonet affiche cette page une fois à chaque visiteur d'un tunnel HTTP. Les requêtes qui portent un en-tête localtonet-skip-warning avec une valeur quelconque l'ignorent, tout comme les tunnels des comptes avec du solde.
Mon serveur web n'écoute qu'en HTTPS
Définissez le Port local du tunnel sur le port HTTPS, généralement 443, et activez SslStream ? dans les Paramètres du tunnel. Cet interrupteur concerne les services locaux qui utilisent eux-mêmes HTTPS ou TLS.
« Vous devez acheter du solde pour utiliser cette fonctionnalité. »
Sous-domaine personnalisé, Domaine personnalisé, Restriction IP et Fournisseurs SSO nécessitent du solde. Ajoutez-en sous Solde.