Wie man OctoPrint hinter HTTPS und einem Reverse-Proxy verwendet

Ein Reverse-Proxy kann HTTPS und einen stabilen lokalen Namen hinzufügen, aber er kann auch den Pfad umschreiben oder OctoPrints Echtzeitverbindung blockieren. Testen Sie die API und WebSocket separat.

Printer Tools kommunizieren mit unterstützten Druckern und Kameras über lokale Protokolle. Halten Sie Geräte privat, bewahren Sie Anmeldeinformationen auf und verwenden Sie die aktuelle Kompatibilitätsmatrix als Referenz für modellbezogene Funktionen.

Printer Tools

Alle Ihre 3D-Drucker in einem Dashboard

Überwachen Sie Bambu Lab-, Klipper-, OctoPrint-, Creality-, Snapmaker-, Anycubic-, Flashforge-, Elegoo- und Prusa-Drucker in einer einzigen App

Verfügbar für Android, iPhone, iPad und Mac, mit Begleit-Apps für Apple Watch und Wear OS sowie optionalem Fernzugriff über VPN, OctoEverywhere oder Obico

Wählen Sie die beabsichtigte Basis-URL

Entscheiden Sie, ob OctoPrint am Proxy-Stamm oder an einem Unterpfad wie /octoprint/ betrieben wird. Die Proxy- und OctoPrint-Konfiguration müssen bezüglich dieser externen Adresse übereinstimmen.

Proxy-Header beibehalten

Leiten Sie den ursprünglichen Host und das Schema mit den von OctoPrint empfohlenen Headern weiter. Falsche Header können zu Weiterleitungen auf einen internen Hostnamen führen oder eine HTTPS-URL herabstufen.

Erlauben Sie WebSocket-Upgrade

Eine Seite oder ein REST-Endpunkt kann funktionieren, während der Live-Zustand fehlschlägt, wenn der Proxy die Handhabung von Upgrade und Connection abbrechen. Halten Sie die Timeouts lang genug für eine persistente WebSocket.

Halten Sie Authentifizierung und Vertrauen gültig

Verwenden Sie ein Zertifikat, das das Telefon validieren kann, und senden Sie das API-Zertifikat nur an den vorgesehenen Host. Deaktivieren Sie keine Zertifikatsprüfungen, um eine Namensabweichung zu verbergen.

Lokale Fehlerbehebung-Checkliste

Testen Sie den externen Basispfad.
Überprüfen Sie Weiterleitungsziele.
Überprüfen Sie REST und WebSocket unabhängig voneinander.
Verwenden Sie ein vertrauenswürdiges Zertifikat und privaten Zugriff.

Häufig gestellte Fragen

Warum funktioniert die Webseite, aber der Live-Status nicht?

Der Proxy kann HTTP korrekt bereitstellen, während er WebSocket-Upgrades blockiert.

Kann ein selbstsigniertes Zertifikat automatisch funktionieren?

Das Telefon muss ihm korrekt vertrauen und der Zertifikatsname muss übereinstimmen.

Sollte der Proxy OctoPrint öffentlich zugänglich machen?

Nein. HTTPS ersetzt keine Zugangskontrolle und kein privates Netzwerk.