Como usar OctoPrint atrás de HTTPS e um proxy reverso

Um proxy reverso pode adicionar HTTPS e um nome local estável, mas também pode reescrever o caminho ou bloquear a conexão em tempo real do OctoPrint. Teste a API e o WebSocket separadamente.

Printer Tools se comunicam com impressoras e câmeras suportadas através de protocolos locais. Mantenha os dispositivos privados, preserve as credenciais e use a matriz de compatibilidade atual como autoridade para as capacidades específicas do modelo.

Printer Tools

Todas as suas impressoras 3D num único painel

Monitorize impressoras Bambu Lab, Klipper, OctoPrint, Creality, Snapmaker, Anycubic, Flashforge, Elegoo e Prusa a partir de uma única app

Disponível para Android, iPhone, iPad e Mac, com apps complementares para Apple Watch e Wear OS e acesso remoto opcional por VPN, OctoEverywhere ou Obico

Escolha a URL base pretendida

Decida se OctoPrint ficará na raiz do proxy ou em um subcaminho como /octoprint/. A configuração do proxy e do OctoPrint deve concordar com esse endereço externo.

Preserve os cabeçalhos do proxy

Encaminhe o host e o esquema originais com os cabeçalhos recomendados pelo OctoPrint. Cabeçalhos incorretos podem criar redirecionamentos para um hostname interno ou rebaixar uma URL HTTPS.

Permitir a mudança de protocolo para WebSocket

Uma página ou endpoint REST pode funcionar enquanto o estado ao vivo falha se o proxy descartar o manuseio Upgrade e Connection. Mantenha os tempos limite longos o suficiente para um WebSocket persistente.

Mantenha a autenticação e a confiança válidas

Use um certificado que o telefone possa validar e envie a credencial da API apenas para o host pretendido. Não desative a verificação de certificado para ocultar uma incompatibilidade de nomes.

Lista de verificação de solução de problemas local

Teste o caminho base externo.
Verifique os destinos de redirecionamento.
Verifique o REST e o WebSocket de forma independente.
Use um certificado confiável e acesso privado.

Perguntas frequentes

Por que a página web funciona, mas o status ao vivo não?

O proxy pode servir HTTP corretamente enquanto bloqueia a mudança de protocolo para WebSocket.

Um certificado autoassinado pode funcionar automaticamente?

O telefone deve confiá-lo corretamente e o nome do certificado deve corresponder.

O proxy deve expor o OctoPrint publicamente?

Não. HTTPS não substitui o controle de acesso e a rede privada.