Que fait portless ?
Configurez et utilisez portless pour obtenir des URLs de serveur de développement local nommées (par exemple https://myapp.localhost au lieu de http://localhost:3000).
Fonctionnalités
- URLs nommées : remplacez les numéros de port par des noms de domaine locaux personnalisés.
- HTTPS local : bénéficiez de certificats SSL auto-signés pour vos environnements de développement.
- Proxy intégré : redirigez automatiquement les requêtes vers vos serveurs locaux.
- Compatible : fonctionne avec la plupart des serveurs de développement (Vite, Webpack, Node.js, etc.).
Comment ça marche
portless crée un proxy local qui écoute sur le port 443 de votre machine et redirige les requêtes vers vos serveurs de développement en fonction du nom de domaine utilisé. Par exemple, si vous nommez votre application "monapp", vous pourrez y accéder via https://monapp.localhost.
Prérequis
- Node.js version 18 ou supérieure
- npm ou yarn
- Privilèges administrateur (pour modifier les fichiers hosts et les certificats)
Installation
npm install -g portless
Utilisation
- Lancez votre serveur de développement normalement (ex:
npm run dev). - Dans un autre terminal, exécutez :
portless run monapp --target http://localhost:3000
Cela créera une URL https://monapp.localhost pointant vers http://localhost:3000.
Configuration avancée
Créez un fichier portless.config.json à la racine de votre projet :
{
"apps": {
"monapp": {
"target": "http://localhost:3000",
"ssl": true
},
"api": {
"target": "http://localhost:4000"
}
}
}
Dépannage
Problèmes de proxy
- Assurez-vous que le port 443 n'est pas déjà utilisé par un autre service.
- Vérifiez les logs de
portlessavecportless logs.
Certificats SSL
- Si vous rencontrez des erreurs de certificat, exécutez
portless cert install. - Sur macOS / Linux, vous devrez peut-être autoriser manuellement le certificat racine.
Ports en conflit
- Utilisez
portless statuspour voir les applications actives. - Arrêtez une application avec
portless stop monapp.