Files
Febe/docs/guida/Installazione-Docker-e-Unraid.md
T
2026-10-14 00:59:18 +00:00

9.6 KiB

Installazione con Docker e Unraid

La veste Docker è un solo contenitore con l'interfaccia web, il motore, un Chromium vero su un display virtuale (Xvfb) e la libreria su disco. La usi dal browser di casa; il browser di Febe lo vedi e lo usi dalla vista remota della pagina Impostazioni ▸ Collegamento a Instagram.

Prima di tutto. Scaricare con un programma è contro le condizioni d'uso di Instagram: leggi il riquadro sul rischio nella pagina iniziale. E leggi Sicurezza e riservatezza prima di decidere su quale rete pubblicare l'interfaccia.

Che cosa serve

  • Un server con Docker (Unraid va benissimo), processore x86-64 (l'immagine è per linux-x64).
  • Un disco locale per la cartella dei dati (su Unraid: l'appdata sul disco di cache).
  • Lo spazio per la libreria: può stare anche su una condivisione o sull'array.
  • Una password per l'interfaccia, lunga: è la sola cosa che protegge la vista remota del browser.

Volumi

Volume Che cosa contiene Dove metterlo
/dati Database (febe.sqlite), profilo del browser con la sessione di Instagram (browser/), miniature, copie giornaliere del database (copie/, sette giorni), registro (registro/, quattordici giorni), file temporanei Su un disco locale del server. Su Unraid /mnt/user/appdata/febe. Mai una condivisione di rete: SQLite e il profilo del browser lì si rovinano, e Febe si rifiuta di partire
/libreria Foto e video, una cartella per account, ognuna con il suo _febe.jsonl Dove vuoi, anche su una condivisione. Febe non cancella e non sostituisce mai un file da solo
/importa Cartelle da importare (pagina Importa) Sempre in sola lettura (:ro): Febe copia, gli originali non si toccano

Variabili

Variabile Significato Predefinito
FEBE_PASSWORD Password dell'interfaccia. Obbligatoria: senza, il motore e il browser non partono e l'interfaccia mostra solo la pagina che spiega il problema nessuno
FEBE_PORTA Porta dell'interfaccia dentro il contenitore 8480
TZ Fuso orario: fascia del motore, date nei nomi dei file, fuso dichiarato dal browser Europe/Rome
LANG Lingua del contenitore e quindi del browser it_IT.UTF-8
PUID, PGID Utente e gruppo con cui gira Febe e di cui sono i file 99, 100 (Unraid)
FEBE_HOST Facoltativa: i nomi con cui raggiungi l'interfaccia, separati da virgole (tower.local,192.168.1.10). Se c'è, ogni altro nome è rifiutato qualunque nome
FEBE_PROXY_FIDATO 1 se davanti c'è un proxy con HTTPS che passa X-Forwarded-Host e X-Forwarded-Proto: allora il cookie di sessione viaggia solo in HTTPS spenta
FEBE_SENZA_SANDBOX 1 avvia Chromium senza la sua sandbox: è il compromesso descritto sotto, da usare solo se il profilo seccomp non si può usare spenta

La password non si passa mai sulla riga di comando e non finisce nei registri. Febe non gira come root: con PUID=0 il contenitore si ferma con un messaggio.

Porte

Si pubblica solo la porta dell'interfaccia (8480). La porta di debug del browser (9222) ascolta solo su 127.0.0.1 dentro il contenitore: non va mai pubblicata, e Febe si rifiuta di usare il browser se la trova aperta altrove.

Installazione su Unraid

  1. L'immagine è 192.168.30.23:3000/alby96/febe:latest, sul registro dei container del Gitea di casa. Il registro risponde in HTTP: il Docker di Unraid deve averlo fra gli insecure-registries, come per le altre immagini di casa. Se Unraid scarica già quelle, è a posto; altrimenti aggiungi "insecure-registries": ["192.168.30.23:3000"] alla configurazione del demone Docker e riavvia Docker. Se il pacchetto non è pubblico, accedi dal terminale: docker login 192.168.30.23:3000.

  2. Dal terminale di Unraid, una volta sola, estrai dall'immagine il profilo seccomp e mettilo dove il modello lo cerca, fuori dalla cartella dei dati:

    docker run --rm --entrypoint cat 192.168.30.23:3000/alby96/febe:latest \
      /usr/share/febe/seccomp.json > /mnt/user/appdata/febe-seccomp.json
    
  3. Docker ▸ Aggiungi contenitore ▸ modello da docker/unraid/febe.xml (o dal suo indirizzo, http://192.168.30.23:3000/Alby96/Febe/raw/branch/main/docker/unraid/febe.xml). Controlla:

    • porta 8480;
    • /dati su /mnt/user/appdata/febe (disco di cache);
    • /libreria dove vuoi le foto; /importa in sola lettura;
    • password dell'interfaccia (obbligatoria, nascosta);
    • TZ, PUID 99, PGID 100 tra le impostazioni avanzate;
    • in «Extra Parameters»: --restart=unless-stopped --stop-timeout 30 --security-opt seccomp=/mnt/user/appdata/febe-seccomp.json.
  4. Apri http://<IP di Unraid>:8480/, entra con la password e segui il Primo collegamento.

Docker Compose

docker/compose.yml nel repository è un esempio pronto: immagine, porta, volumi (con /importa in sola lettura), variabili, profilo seccomp con percorso relativo al file, restart: unless-stopped, 30 secondi per fermarsi. Anche qui il registro 192.168.30.23:3000 deve stare fra gli insecure-registries del Docker.

FEBE_PASSWORD='una frase lunga' docker compose -f docker/compose.yml up -d

Senza il repository, scarica dalla release l'archivio febe-compose-X.Y.Z.tar.gz: dentro c'è compose.yml con accanto chromium/seccomp.json, il profilo che il file indica.

tar -xzf febe-compose-X.Y.Z.tar.gz && cd febe-compose-X.Y.Z
FEBE_PASSWORD='una frase lunga' docker compose up -d

Le cartelle si cambiano con FEBE_DATI, FEBE_LIBRERIA e FEBE_IMPORTA (predefinite sotto /srv/febe).

La sandbox di Chromium

Chromium isola le pagine che apre in una sandbox. Dentro Docker la sandbox ha bisogno di creare spazi dei nomi utente, che il profilo seccomp predefinito di Docker vieta: con le impostazioni normali Chromium non parte affatto (No usable sandbox!).

  • Impostazione consigliata, già scritta nel modello di Unraid e in compose.yml: il profilo seccomp dedicato di Febe (docker/chromium/seccomp.json), cioè quello di Docker più clone e unshare. Con questo profilo la sandbox di Chromium è completa e il resto del filtro di Docker resta attivo. Così non c'è nessun compromesso sulla sandbox.
  • Docker legge il profilo sul server quando crea il contenitore, per questo il file sta fuori dalla cartella dei dati (passo 2 sopra): dentro /dati lo potrebbe cambiare l'utente del contenitore. Il contenitore non lo aggiorna da sé; se le note di una versione lo chiedono, ripeti l'estrazione. Nelle prime anteprime il profilo stava in /dati/seccomp.json: se «Extra Parameters» indica ancora quel file, estrai il profilo nel posto nuovo e correggi il percorso.

Se il profilo dedicato non si può usare, ci sono due alternative, in quest'ordine:

  1. --security-opt seccomp=unconfined: la sandbox di Chromium resta attiva, ma il contenitore perde tutto il filtro seccomp di Docker.
  2. FEBE_SENZA_SANDBOX=1: Chromium parte con --no-sandbox. È un compromesso: una pagina che sfruttasse un difetto del browser non troverebbe la sandbox di Chromium a fermarla, solo i limiti del contenitore. Si accetta soltanto perché quel browser visita esclusivamente Instagram, e solo se le due strade sopra non sono possibili. Chromium mostra anche una barra d'avviso in alto, che toglie circa 50 pixel alla pagina.

Febe non sceglie da solo: se Chromium non parte, il registro dice perché. La prova della sandbox è stata fatta il 13 ottobre 2026 in un contenitore con il Chromium dell'ambiente di sviluppo; con l'immagine vera va ripetuta sul server (vedi Ipotesi da verificare, voce S5).

Salute del contenitore

GET /salute risponde senza password {"stato":"ok"} oppure {"stato":"problema"} quando un problema di configurazione ferma Febe. L'immagine ha un controllo di salute che lo chiede ogni 30 secondi; Unraid mostra lo stato accanto al contenitore. Da terminale: docker inspect --format '{{.State.Health.Status}}' febe.

Registro

Il registro di Febe è in /dati/registro/febe-AAAA-MM-GG.log (un file al giorno, quattordici giorni, al massimo 20 MB al giorno) e nell'output del contenitore (docker logs febe). Contiene azioni ed esiti, nomi utente sì; mai password, cookie, tasti, didascalie, corpi delle risposte, indirizzi firmati del CDN, né il gettone del bot Telegram.

Arresto e aggiornamento

  • Allo stop (docker stop, aggiornamento, riavvio di Unraid) Febe chiude la vista remota, ferma il motore, poi Chromium in modo che la sessione di Instagram resti scritta nel profilo, poi Xvfb. Lascia 30 secondi (--stop-timeout 30); di solito ne bastano pochi.
  • Aggiornare: scarica la nuova immagine e ricrea il contenitore (su Unraid «Force update»). /dati e /libreria restano; il database si aggiorna da solo all'avvio. Prima di un aggiornamento importante puoi copiare a mano /dati/febe.sqlite a contenitore fermo; le copie giornaliere sono comunque in /dati/copie (vedi Copie e ricostruzione).
  • Il collegamento è fatto per sopravvivere ai riavvii e alla ricreazione del contenitore: la sessione è in /dati/browser. È provato in locale; nel contenitore vero è la voce S3 di Ipotesi da verificare, da confermare.

Un account, un motore

Il contenitore e Febe per Windows non vanno usati insieme sullo stesso account: due Febe che raccolgono con lo stesso account sommano le visite e raddoppiano il rischio. La sessione nasce e resta nel browser del contenitore: i cookie non si copiano da un'altra macchina.

Se qualcosa non va: Problemi comuni.