Files
Febe/docs/guida/Problemi-comuni.md
T
Alby96andClaude Opus 5.5 c49df4ca7b Browser mai bianco né muto: pagina iniziale, finestra che resta, fotogrammi che ripartono (#52)
Il browser di Febe a volte era bianco o non mostrava nulla. Le cause erano
diverse e si correggono insieme.

- Pagina iniziale. Se il browser è a riposo su about:blank e Alberto lo apre
  («Usa il browser», «Apri il browser»), Febe lo porta sulla home del sito
  quando è collegato, altrimenti sulla pagina di accesso. È un'azione di
  Alberto, sotto il suo permesso di guida, non del motore: Febe aspetta che
  la sessione finisca e prende il turno della pagina.
  Il nuovo pulsante «Pagina iniziale» sta nella barra della finestra di
  Windows e nella vista remota. Su about:blank la barra dice «Il browser è a
  riposo su una pagina vuota». «Indietro» non torna più sulla pagina di
  riposo.
- Disconnessione. «Apri il browser» nella striscia rossa apre la pagina di
  accesso. Con --accesso-di-prova il primo controllo all'avvio non segnala
  più una disconnessione finta.
- Windows: la finestra resta.
  - Lasciare una pagina di Febe non nasconde più la finestra «Browser di
    Febe» e non la rimette a riposo: finisce solo il permesso tenuto dalla
    pagina (cancel con pageLeft, IConnectionService.ReleaseAsync).
  - Sullo schermo la finestra ha il suo pulsante nella barra delle
    applicazioni, così ridurla a icona non la fa sparire. Dopo 2 minuti
    ridotta a icona torna fuori vista (S2).
  - Se lo schermo è troppo piccolo, la finestra si restringe all'area di
    lavoro e la pagina si rimpicciolisce con ZoomFactor, con le stesse misure
    CSS.
  - I bordi della pagina si riapplicano, con NotifyParentWindowPositionChanged,
    quando la finestra si mostra, si sposta o riparte il processo GPU.
  - Una pagina che non risponde mentre Alberto guida resta com'è.
  - IBrowserWindow.ShowAsync lascia il posto a
    IConnectionService.ShowBrowserAsync.
- Docker: fotogrammi che ripartono. La vista remota ha un watchdog. Riavvia
  i fotogrammi dopo una pagina nuova caricata senza fotogrammi e dopo circa
  2 s di silenzio. L'attesa raddoppia fino a 30 s finché la pagina resta
  ferma. Se il riavvio non porta nulla, la vista riceve un'immagine ferma
  (Page.captureScreenshot, già fra i comandi ammessi).
  RemoteViewSession ha ora un registro vero: avvii, riavvii e silenzi vanno
  a livello Info, categoria «vista», senza indirizzi.
  Se dopo 8 s non arriva nessuna immagine, l'interfaccia mostra «Nessuna
  immagine dal browser» con «Riprova».

Nessun comando CDP nuovo e nessuna dipendenza nuova. Aggiornati PROTOCOLLO.md
e la guida (Primo collegamento, Attività e arresti, Installazione Windows,
Problemi comuni).

Prove nuove:
- ScreencastWatchdogTests, RemoteViewFramesTests (Chromium vero, solo CI
  Linux)
- Home e Indietro in RemoteViewStartTests
- RemoteViewSocketTests
- ConnectionApiTests
- BrowserStartPageTests
- BrowserWindowDecisionTests e BrowserWindowTests (WebView2 vero)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 12:51:12 +01:00

11 KiB
Raw Blame History

Problemi comuni

Che cosa vedi, perché succede, che cosa fare. Quasi sempre il primo posto da guardare è il registro: in Docker /dati/registro/febe-AAAA-MM-GG.log e docker logs febe; su Windows la cartella registro dentro la cartella dei dati.

Avvio e configurazione

Che cosa vedi Che cosa fare
L'interfaccia mostra solo la pagina «Febe non può partire» con «Manca la password dell'interfaccia» Imposta FEBE_PASSWORD nel contenitore e riavvialo. Fino ad allora motore e browser restano spenti, e nessun dato è perso
«La cartella dei dati è su un disco di rete» Collega /dati (su Windows la cartella dei dati) a una cartella su un disco locale: su Unraid l'appdata sul disco di cache. SQLite e il profilo del browser in rete si rovinano
«La cartella dei dati non è scrivibile» Controlla PUID/PGID e i permessi della cartella sul server
Il contenitore si ferma subito con un messaggio su PUID=0 Febe non gira come root: usa un utente normale (su Unraid 99/100)
Unraid non crea il contenitore: «opening seccomp profile … no such file» Manca /mnt/user/appdata/febe-seccomp.json: è il passo 2 dell'installazione
Nel registro: «Il browser non parte… No usable sandbox» Il contenitore gira senza il profilo seccomp dedicato: aggiungi --security-opt seccomp=… (vedi la sezione sulla sandbox in Installazione con Docker e Unraid)
La pagina Collegamento dice «Il browser di Febe non è disponibile» Febe non ha avviato il suo browser: leggi il registro, riavvia; di solito è la sandbox (riga sopra) o la porta di debug occupata
La porta è occupata Cambia la porta pubblicata (o FEBE_PORTA)
Unraid non scarica l'immagine Il registro 192.168.30.23:3000 è in HTTP: deve stare fra gli insecure-registries del Docker di Unraid (vedi l'installazione); se il pacchetto non è pubblico, accedi dal terminale: docker login 192.168.30.23:3000
Il browser rifiuta l'interfaccia con un errore 400 sul nome FEBE_HOST è impostata e il nome con cui apri l'interfaccia non è nell'elenco: aggiungilo
«Password sbagliata» anche con quella giusta, poi «bloccato» Dopo 5 errori da uno stesso indirizzo (20 in tutto) l'accesso si blocca per 15 minuti: aspetta, poi riprova
Su Windows: Febe dice che manca WebView2 Installa il runtime WebView2 dal collegamento che Febe mostra

Collegamento

Che cosa vedi Che cosa fare
La vista remota è lenta o non risponde La vista è un'immagine della pagina inviata dal server: aspetta qualche secondo dopo ogni clic. Se dice «La vista remota non risponde», premi «Riprova»; se si apre in un'altra finestra, la precedente si chiude da sola (una vista alla volta)
La vista remota dice «Nessuna immagine dal browser» La vista è aperta ma la pagina non arriva. Febe riavvia da solo l'invio delle immagini quando si fermano; premi «Riprova». Se resta così, guarda il registro (categoria «vista»: avvii, riavvii e silenzi) e riferisci il caso
Il browser è bianco, o la barra dice «Il browser è a riposo su una pagina vuota» È la pagina vuota su cui Febe lascia il browser quando non lo usa: premi «Pagina iniziale» (la home di Instagram se sei collegato, altrimenti la pagina di accesso)
«Ho finito» dice che l'accesso non è riuscito Nella pagina deve comparire la tua pagina iniziale di Instagram, non il modulo di accesso: completa l'accesso, poi di nuovo «Ho finito»
Dopo un riavvio Febe chiede di nuovo l'accesso Non dovrebbe: la sessione è nel profilo del browser in /dati/browser. Controlla che /dati sia un volume persistente e non sia stato cancellato; riferisci il caso (è la voce S3 di Ipotesi da verificare)

Il motore non scarica nulla

Controlla in quest'ordine, guardando Attività:

  1. Ricetta «Da configurare». Se in Attività vedi «non può girare su instagram: la mappa dei bersagli non è ancora compilata», è lo stato attuale del progetto per storie, raccolte e schede Taggati e Reel: aspettano i bersagli dei comandi (ipotesi H11, vedi Ipotesi da verificare). Non è un guasto, e quelle ricette non vengono sospese.
  2. Non collegato, verifica richiesta o sessione chiusa: la barra laterale lo dice. Vedi Primo collegamento e Attività e arresti.
  3. Fuori fascia o giorno non attivo: Attività dice «Fuori fascia» e quando riprende.
  4. In pausa: «Riprendi».
  5. Avvio appena fatto: la prima sessione parte 2–10 minuti dopo l'avvio.
  6. Tetto raggiunto (ambra o pieno in «Limiti di oggi»), oppure avvio graduale con i tetti ancora bassi.
  7. L'account è In pausa, Solo archivio o Non raggiungibile, oppure ha «Tieni aggiornato» spento ed è già stato scaricato una volta.
  8. Disco pieno: vedi sotto.

Cercare un profilo da aggiungere

Che cosa vedi Che cosa fare
Sotto «Da Instagram» c'è «Febe non sa ancora dove sta «Cerca» su questo sito: per ora vedi solo i profili che segui.» Su Instagram mancano ancora i bersagli del pannello «Cerca» (search-open, search-box, ipotesi H11 di Ipotesi da verificare): si raccolgono con una prova dal vivo. Intanto usa i suggerimenti dei profili che segui, la riga «Aggiungi @nome per nome utente» o incolla più nomi
«Stai usando il browser di Febe…» Mentre usi tu il browser (accesso, verifica, pagina Browser) Febe non cerca: premi «Ho finito», e la ricerca riprende da sola con il testo che c'è nella casella
«Febe è in pausa…» Premi «Riprendi»: la ricerca riprende da sola
«… non è riuscita: riprova», «Instagram non ha mandato risultati…» Riscrivi lo stesso testo (basta uno spazio in più) o aggiungi una lettera: Febe ci riprova
Un profilo che segui ha solo le iniziali Febe non conserva le foto dei profili che segui: la foto arriva solo se il profilo compare anche fra i risultati di Instagram per lo stesso testo, o se l'account è già in Febe
«È l'indirizzo di un post, di un reel…» Hai incollato l'indirizzo di un post, di un reel o di una storia: serve quello del profilo, instagram.com/nome.utente
«Fuori dalla fascia oraria…» o «Febe è fermo…» Fuori fascia e durante un arresto Febe non apre Instagram, neanche per cercare. I suggerimenti locali funzionano; la ricerca riprende da sola quando la fascia si apre o l'arresto finisce
«In attesa del turno…» per qualche secondo Una sessione sta facendo un passo della raccolta sull'unica pagina del browser: i risultati arrivano appena la pagina è libera
Nessun suggerimento mentre scrivi Su Instagram Febe cerca da due lettere in su. I profili che segui compaiono già dalla prima lettera, ma solo se l'elenco dei seguiti è stato letto almeno una volta («Leggi l'elenco»)
Su Windows i risultati di Instagram non arrivano mai La scrittura nella casella di Instagram con il browser di Windows non è ancora stata provata dal vivo: riferisci il caso, con il rapporto di diagnostica

File e libreria

Che cosa vedi Che cosa fare
File «da scaricare» che non arrivano Gli scaricamenti hanno un loro tetto giornaliero di dati; durante un fermo continuano solo quelli già in coda. Un indirizzo scaduto torna «da scaricare» e si recupera rileggendo il post; per le storie scadute non c'è recupero
Elementi «falliti» Dopo cinque tentativi non riusciti un file resta «fallito»; anche una storia scaduta prima dello scaricamento finisce così
Nel visualizzatore: «Il file non è sul disco» Il file è stato spostato o cancellato fuori da Febe. Rimettilo dov'era o elimina l'elemento
«N doppioni da decidere» Foto che sembrano la stessa immagine salvata due volte: decidi tu in «Doppioni da decidere» (vedi Libreria)
Un elemento eliminato torna Hai usato «Eliminalo e lascia che torni»: elimina di nuovo con «Elimina dalla libreria»
Il CSV si apre male in Excel Aprilo con doppio clic (non con «Importa testo» impostando un altro separatore): è fatto per Excel in italiano, con ; e UTF-8 con BOM

Disco quasi pieno

L'avviso «Disco quasi pieno» arriva quando sul disco della libreria o della cartella dei dati restano meno di 10 GB o meno del 5%. Libera spazio su quel disco. Per spostare la libreria: in Docker cambia il volume /libreria (sposta prima i file, con Febe fermo); su Windows usa «Cambia…» in Impostazioni ▸ Generali (i nuovi account vanno nella cartella nuova, quelli vecchi restano dove sono). La cartella dei dati: in Docker sposta il volume /dati con il contenitore fermo; su Windows «Cambia…» vale dal prossimo avvio di Febe.

Formato non riconosciuto, ricetta sospesa, bersaglio non trovato

Vuol dire che Instagram ha cambiato le sue risposte o le sue pagine. Febe non insiste: dopo tre volte di fila sospende la ricetta e Attività lo dice. Che cosa fare:

  1. Avvia la sonda passiva e raccogli un campione nuovo navigando tu le pagine interessate (procedura in docs/prove-dal-vivo.md, parte A, nel repository).
  2. Ripulisci e verifica il campione, e fallo arrivare a chi aggiorna i lettori o la mappa dei bersagli.
  3. Dopo l'aggiornamento di Febe, premi «Riattiva» sulla ricetta sospesa in Attività.

Non riattivare una ricetta solo per farla ripartire: si sospenderebbe di nuovo dopo tre tentativi.

Avvisi

Messaggio di «Invia una prova» Che cosa fare
«Telegram non riconosce il gettone del bot» Copia di nuovo il gettone per intero dal messaggio di BotFather
«Il gettone del bot non ha la forma giusta» Il gettone è fatto di cifre, due punti e una lunga serie di lettere, senza spazi
«Telegram non trova la chat» Controlla l'identificativo e scrivi almeno un messaggio al bot prima di riprovare
«Il bot non può scriverti» Apri la chat con il bot e premi «Avvia» (o sbloccalo; in un gruppo, aggiungilo)
«Telegram non ha risposto» o «non è raggiungibile» Il server (in Docker, il contenitore) deve poter uscire su Internet verso api.telegram.org
«Questa istanza di Febe non invia messaggi Telegram» Sei nella dimostrazione o in una prova: lì non parte nulla

Gli avvisi che non sono arrivati sono elencati in Attività ▸ Avvisi come «Avviso non inviato». Vedi Avvisi e Telegram.

Importazione

Che cosa vedi Che cosa fare
«Sposta» non c'è La sorgente è in sola lettura (sempre, in Docker con /importa): si può solo copiare
Non trovi la cartella da importare (Docker) Deve stare dentro il volume /importa del contenitore
La sorgente è rifiutata È dentro o sopra la cartella dei dati, sopra la libreria o dentro una cartella di account di Febe
«Importa N file» importa meno file di quanti ne hai Le cartelle senza account e i doppioni non ancora decisi restano fuori: il pulsante dice quanti
Date sbagliate su una libreria di 4K Stogram Il riconoscitore dei nomi di 4K Stogram è un'ipotesi non verificata: rifai l'analisi senza l'opzione, o controlla date e codici nella revisione

Database

Che cosa vedi Che cosa fare
Il database si è rovinato o è sparito Torna a una copia di copie/, oppure ricostruiscilo dalla libreria: vedi Copie e ricostruzione
«Ricostruisci» è rifiutato C'è un'importazione in corso: aspetta che finisca