«Aggiungi account» ha una sola casella: mentre Alberto scrive compaiono subito i suggerimenti locali, poi i profili di Instagram con la foto, come chiesto in #37. Il browser di Febe scrive nella casella «Cerca» di Instagram con tasti veri da una mappa chiusa (mai Invio, Tab o Esc), controlla prima il fuoco, legge la risposta della pagina e non clicca mai un risultato. La ricerca ha una categoria propria nel Governatore, con tetti larghi che non consumano quelli della raccolta, e si dà il turno con il motore sull'unica pagina; a fine sessione la pagina torna comunque al riposo. Le foto passano dal CDN con un permesso ciascuna e restano solo in memoria. Le risposte di Alberto del 15 novembre (controllo del fuoco, turni, evento requestWillBeSent, niente foto dei seguiti per ora) sono in §6.1 e in docs/decisioni.md. Su Instagram vero la ricerca parte quando i bersagli search-open e search-box saranno raccolti dal vivo. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
126 lines
11 KiB
Markdown
126 lines
11 KiB
Markdown
# 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 |
|
||
|
||
## 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. **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 |
|