# 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](Home). E leggi [Sicurezza e riservatezza](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: ```sh 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://:8480/`, entra con la password e segui il [Primo collegamento](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. ```sh 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. ```sh 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](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](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](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](Problemi-comuni).