Parfois, vous aurez besoin d’exposer un serveur local, fonctionnant sur votre ordinateur, à l’internet. Cela peut être utile pour tester une application web avant de la déployer sur un serveur distant.
Découvrez comment utiliser ngrok, un outil courant pour exposer des serveurs web locaux à Internet.
Utilisation de ngrok pour le développement du Web local
ngrok est une solution de tunneling permettant d’exécuter des serveurs web locaux sur internet depuis 2015.
En utilisant ngrok, vous pouvez créer une URL publique qui mappe vers votre serveur local, ce qui permet aux autres d’accéder facilement à leur travail depuis n’importe où dans le monde. Vous pouvez ensuite tester vos applications à partir de différents appareils et navigateurs web, et les dépanner à l’aide des journaux de requêtes et de réponses de ngrok.
Lorsque vous utilisez un tunnel public, vous pouvez avoir des problèmes de sécurité. ngrok supporte les tunnels sécurisés avec le cryptage SSL, ce qui le rend sûr à utiliser pour les données et les applications sensibles. Toutes ces caractéristiques ont fait de ngrok un outil précieux et populaire pour les développeurs travaillant sur un projet personnel ou collaborant avec d’autres.
Installation de ngrok sur votre ordinateur
L’utilisation des fonctions primaires de ngrok est entièrement gratuite et très simple. Bien qu’il existe une version payante de ngrok qui offre plus de fonctionnalités. Voyons comment installer et configurer ngrok sur votre ordinateur.
Pour installer ngrok sur votre ordinateur, rendez-vous sur la page officielle de téléchargement de ngrok.
Vous devez ensuite procéder au téléchargement de ngrok pour votre système d’exploitation spécifique, soit en téléchargeant le fichier ZIP et en l’extrayant, soit en l’installant à l’aide d’un gestionnaire de paquets comme Chocolatey ou Homebrew.
Pour installer ngrok avec Chocolatey ou Homebrew sur Windows et macOS, vous devez avoir installé l’un ou l’autre des gestionnaires de paquets.
Pour installer Chocolatey sous Windows, exécutez cette commande dans l’administrateur de Windows PowerShell :
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
Pour installer Homebrew sur macOS, exécutez cette commande dans votre terminal :
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Vous avez maintenant les gestionnaires de paquets appropriés, et vous pouvez installer ngrok sur votre ordinateur en utilisant l’un ou l’autre.
Créer un nouveau tunnel ngrok local avec votre compte
Pour créer un tunnel ngrok afin d’exposer votre serveur local, vous devez vous inscrire à un compte ngrok et créer un jeton d’authentification.
Étape 1 : S’inscrire
Rendez-vous sur la page d’inscription de ngrok, remplissez le formulaire avec les informations requises et cliquez sur S’inscrire.
Étape 2 : Ajouter le jeton à la configuration
Maintenant que vous avez un compte, vous devez ajouter votre jeton d’authentification généré automatiquement à la page de configuration. ngrok.yml fichier de configuration. Ce jeton est unique à votre compte, vous devez donc le garder en sécurité. Pour ajouter le jeton d’authentification, accédez à l’onglet Votre Authtoken dans la barre de navigation latérale.
Vous pouvez copier votre jeton d’authentification et exécuter la commande suivante dans votre terminal pour définir le fichier de configuration :
ngrok config add-authtoken YOUR_AUTH_TOKEN
Étape 3 : Exécuter ngrok
Une fois que vous avez terminé les étapes précédentes, vous pouvez créer un tunnel ngrok pour exécuter votre serveur.
Pour ce faire, exécutez la commande suivante avec un numéro de port préféré.
Par exemple :
ngrok http 3000
Vous avez maintenant un tunnel ngrok local qui fonctionne sur votre ordinateur.
Gestion des problèmes courants de configuration
- Restrictions du pare-feu : Si votre ordinateur est derrière un pare-feu, vous devrez peut-être ajuster ses paramètres pour permettre à ngrok de se connecter à l’Internet.
- Jeton d’authentification incorrect : Si vous entrez un jeton d’authentification incorrect au démarrage de ngrok, vous pouvez recevoir un message d’erreur indiquant que votre jeton n’est pas valide. Confirmez votre jeton ou réinitialisez-le sur le site Web en cliquant sur l’icône Réinitialiser l’Authtoken bouton.
- Permission refusée : Si vous recevez une erreur « permission denied » lors du démarrage de ngrok, vous devrez peut-être exécuter la commande ngrok en tant qu’administrateur ou avec des privilèges élevés.
Les avantages de l’utilisation de ngrok pour le développement Web local
Que vous travailliez sur un projet personnel ou que vous collaboriez avec une équipe, ngrok est un outil précieux dans votre boîte à outils de développement web. Sa compatibilité avec diverses plateformes et langages de programmation le rend approprié pour le test d’applications web, la collaboration, ou la démonstration de projets aux clients.
