Files
Febe/docs/guida/Problemi-comuni.md
T

110 lines
8.5 KiB
Markdown
Raw 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 1 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 | Accedi al registro di Gitea dal terminale: `docker login gitea.encke-hake.ts.net` |
| 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) |
| «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](Ipotesi-da-verificare)) |
## Il motore non scarica nulla
Controlla in quest'ordine, guardando [Attività](Attivita-e-arresti):
1. **Raccolta da Instagram non ancora attiva.** Se in «Appena fatto» vedi «non può girare su instagram: la mappa dei
bersagli non è ancora compilata», è lo stato attuale del progetto: le ricette su Instagram aspettano i risultati
della sonda (ipotesi H1–H11, vedi [Ipotesi da verificare](Ipotesi-da-verificare)). Non è un guasto.
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.
## 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 |