
Comment utiliser OctoPrint derrière HTTPS et un proxy inverse
Un proxy inverse peut ajouter HTTPS et un nom local stable, mais il peut également réécrire le chemin ou bloquer la connexion en temps réel de OctoPrint. Testez l’API et le WebSocket séparément.
Printer Tools communique avec les imprimantes et caméras prises en charge via des protocoles locaux. Gardez les appareils privés, préservez les identifiants et utilisez la matrice de compatibilité actuelle comme référence pour les capacités spécifiques à chaque modèle.
Choisissez l’URL de base souhaitée
Décidez si OctoPrint se trouve à la racine du proxy ou à un sous-chemin tel que /octoprint/. La configuration du proxy et d’OctoPrint doit être d’accord sur cette adresse externe.
Conservez les en-têtes du proxy
Transférez l’hôte et le schéma d’origine avec les en-têtes recommandés par OctoPrint. Des en-têtes incorrects peuvent créer des redirections vers un nom d’hôte interne ou dégrader une URL HTTPS.
Autoriser le passage à WebSocket
Une page ou un point de terminaison REST peut fonctionner alors que l’état actif échoue si le proxy supprime la gestion de Upgrade et Connection. Maintenez les délais assez longs pour un WebSocket persistant.
Maintenez l’authentification et la confiance valides
Utilisez un certificat que le téléphone peut valider et envoyez la crédential API uniquement à l’hôte prévu. Ne désactivez pas les vérifications de certificat pour masquer une incompatibilité de nom.
Liste de contrôle locale de dépannage
- Testez le chemin de base externe.
- Vérifiez les destinations de redirection.
- Vérifiez REST et WebSocket indépendamment.
- Utilisez un certificat de confiance et un accès privé.
Questions fréquemment posées
Pourquoi la page web fonctionne-t-elle mais le statut en direct ne fonctionne pas ?
Le proxy peut servir correctement HTTP tout en bloquant le passage à WebSocket.
Un certificat auto-signé peut-il fonctionner automatiquement ?
Le téléphone doit lui faire confiance correctement et le nom du certificat doit correspondre.
Le proxy doit-il exposer OctoPrint publiquement ?
Non. HTTPS ne remplace pas le contrôle d’accès et le réseau privé.





