Proxy HTTPS
Le reverse proxy intégré à Joppa : ports, protocoles, en-têtes transmis, pages d'erreur et démarrage automatique.
Le proxy reçoit toutes les requêtes vers vos domaines .test, les déchiffre avec le certificat du domaine, puis les transmet au serveur de dev.
Ports et adresses
| Port | Rôle |
|---|---|
| 443 | HTTPS |
| 80 | Redirige vers HTTPS |
Le proxy écoute sur 127.0.0.1 (et ::1 quand IPv6 est disponible). Il n’accepte que les connexions de votre machine.
Ce qui passe
- HTTP/2 et HTTP/1.1.
- WebSockets : le rechargement à chaud (HMR) de Vite, Next.js ou Astro fonctionne.
- Server-Sent Events : les flux restent ouverts.
- En-têtes :
Hostd’origine conservé ;X-Forwarded-Proto: https,X-Forwarded-Host,X-Forwarded-Port: 443etX-Forwarded-Forajoutés.
Pages d’erreur
| Cas | Réponse |
|---|---|
Domaine .test inconnu de Joppa |
Une page « Domaine non configuré » (et non une erreur de certificat) |
| Le serveur de dev ne répond pas | Une page 502 « Le serveur de dev ne répond pas » |
Démarrer et arrêter
- Réglages › Proxy : état, Démarrer / Arrêter, et Démarrer le proxy à l’ouverture de Joppa (activé par défaut).
- La palette ⌘ K : « Redémarrer le proxy HTTPS », « Arrêter le proxy ».
- La barre des menus : Démarrer le proxy / Arrêter le proxy.
- Le terminal :
joppa proxy start/joppa proxy stop.
Quand le proxy est arrêté, un bandeau le rappelle en haut de la fenêtre, et l’icône du Dock passe en rouge.
Joppa en arrière-plan
Fermer la fenêtre ne quitte pas Joppa : le proxy continue de servir vos domaines, et Joppa reste dans la barre des menus. Son menu liste vos projets et leurs domaines (un clic les ouvre), l’état du proxy, Ouvrir Joppa… et Quitter Joppa. Une seule instance tourne à la fois : relancer l’app ramène la fenêtre existante.