Risoluzione dei problemi
Le soluzioni ai problemi più comuni, raccolte in un unico posto. Ogni sezione indica il sintomo; segui i passaggi in ordine.
Worker e cluster
Il live stream dal worker non si vede
Il worker si connette in uscita verso il master per l'enrollment e l'inferenza, ma il live stream è l'unico caso in cui è il master a connettersi al worker sulla porta 8765. Se l'enrollment funziona ma lo stream resta nero, quella connessione in entrata viene bloccata, il più delle volte da un firewall sulla macchina worker.
Windows: il Windows Defender Firewall blocca di default le connessioni in entrata sulla porta 8765. Apri PowerShell come Amministratore e aggiungi una regola in entrata:
New-NetFirewallRule -DisplayName "Superhome Worker 8765" -Direction Inbound -Protocol TCP -LocalPort 8765 -Action Allow -Profile Private,Domain
Assicurati anche che la tua rete sia impostata come Privata (non Pubblica) in Windows, altrimenti la regola non si applica.
Qualsiasi sistema operativo: verifica che il master raggiunga il worker. Da un terminale sulla stessa rete esegui curl -m 5 http://<IP_WORKER>:8765/api/status. Se va in timeout, la porta è bloccata (firewall) o non raggiungibile sulla rete.
Se il firewall è aperto e lo stream ancora non si vede, riavvia la macchina worker: è consigliato un riavvio completo perché le nuove regole e la rete del container abbiano effetto. Se dopo il riavvio ancora non funziona, esegui un riavvio pulito della modalità master-worker.
Problemi con lo stream RTSP della fotocamera
Se le rilevazioni non scattano mai, il worker potrebbe non ricevere il flusso della fotocamera. L'URL della fotocamera si configura sul master (rtsp_url). Verifica che lo stream sia valido aprendo lo stesso URL RTSP in VLC (Media → Apri flusso di rete → incolla l'URL rtsp://…). Se VLC non riesce a riprodurlo, il problema è la fotocamera/URL, non Superhome.
Riavvio pulito della modalità master-worker
Se il cluster va in uno stato anomalo (worker bloccato, non si riconnette, stream rotto dopo cambi di configurazione), esegui un re-enrollment pulito:
- Sul worker, dalla cartella che contiene
docker-compose.yml, ferma tutto incluso il volume dati:docker compose down -v - Sul master, apri l'Hub Superhome → Cluster e fai revoca del worker.
- Ricollega il worker da zero seguendo i passaggi di Aggiungi un worker (genera una nuova chiave di registrazione, avvia, approva).