# 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](Installazione-Docker-e-Unraid) | | 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](Installazione-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](Installazione-Docker-e-Unraid)); 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 | | «La chiave della sessione salvata non è valida» | `FEBE_CHIAVE_SESSIONE` è impostata ma non è una chiave di 32 byte: correggila con 32 byte in base64 (`openssl rand -base64 32`) o toglila (Febe userà `/dati/sessione/chiave.bin`), poi riavvia. Motore e browser restano spenti fino ad allora | | «La chiave della sessione salvata non si legge» | Con la raccolta «richieste», `/dati/sessione/chiave.bin` non è una chiave di Febe o non si legge: cancellalo (la sessione salvata non si leggerà più: basta rifare l'accesso) oppure imposta `FEBE_CHIAVE_SESSIONE`, poi riavvia | | «Valore non valido per FEBE_RACCOLTA» (o `--raccolta`) | I valori sono `pagine` o `richieste`: correggi o togli la variabile | ## 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» | | «La sessione per le richieste non è stata copiata» | Solo con la raccolta «richieste». Il messaggio dice perché: se il browser non era su una pagina del sito o era sulla pagina di accesso o di verifica, apri la tua pagina iniziale e premi di nuovo «Ho finito»; se nel frattempo il browser era tornato al motore, rifai l'accesso dalla pagina Collegamento. La sessione salvata di prima resta com'era | | «Sessione copiata…, ma non ancora scritta su disco» | Il disco ha rifiutato la scrittura (spazio, permessi di `/dati/sessione`): Febe usa la copia in memoria e riprova alla prossima scrittura. Controlla lo spazio e i permessi; il registro dice il tipo d'errore | | 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](Ipotesi-da-verificare)) | ## Il motore non scarica nulla Controlla in quest'ordine, guardando [Attività](Attivita-e-arresti): 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](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](Primo-collegamento) e [Attività e arresti](Attivita-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](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](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](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](Copie-e-ricostruzione) | | «Ricostruisci» è rifiutato | C'è un'importazione in corso: aspetta che finisca |