Files
Febe/docs/guida/Problemi-comuni.md
Alby96andClaude Opus 5.5 c87768766c
verifica / controlli (push) Successful in 22s
verifica / prove (push) Successful in 16m46s
verifica / installatore (push) Successful in 4m43s
verifica / immagine (push) Successful in 21m2s
Sessione salvata cifrata, copiata a «Ho finito» (#36, S4)
Il client del sito ha bisogno della sessione del browser di Febe: ora la copia
c'è, cifrata e dietro un interruttore, senza cambiare nulla di predefinito.

- Opzione «raccolta» (pagine predefinita, richieste): solo con «richieste» e
  almeno un'operazione configurata si costruiscono sessione salvata, client del
  sito e copia. Con Instagram nulla cambia: le dieci operazioni restano non
  configurate (mancano __spin_*, __req, __s, __dyn, __csr e altri).
- Cookie con dominio, percorso, solo-host, Secure, HttpOnly e scadenza, mandati
  solo dove il browser li manderebbe (RFC 6265).
- Sezione «page» del catalogo: dove la pagina tiene ogni valore; nuovi campi rev,
  hs, hsi, dpr, ccg, comet_req, entry_nonce. Il caricatore rifiuta
  un'operazione configurata con un valore di sessione senza fonte nella pagina.
- Dati/sessione/sessione.json: DPAPI su Windows, AES-256-GCM in Docker (chiave
  da FEBE_CHIAVE_SESSIONE o chiave.bin), scrittura atomica, file illeggibile =
  nessuna sessione. «Scollega» la cancella; chiave.bin resta.
- Copia a «Ho finito» con Network.getCookies e una sola Runtime.evaluate in sola
  lettura, solo da una pagina del sito e finché dura il permesso di guida.
- FEBE_PASSWORD e FEBE_CHIAVE_SESSIONE non passano a Chromium, Xvfb, ffmpeg.
- Sito di prova: csrftoken, cookie limitato a /api/, registro di moduli suo.
- Revisione su tre lenti: 11 punti confermati, tutti corretti.

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

133 lines
13 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 |