Registro di casa 192.168.30.23:3000 (HTTP) nel modello Unraid, in compose e nel rilascio con buildx; profilo seccomp fuori da /dati. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Mzbb6zeFTjT6Rp8b92AVkA
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
-
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 gliinsecure-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. -
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 -
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;
/datisu/mnt/user/appdata/febe(disco di cache);/libreriadove vuoi le foto;/importain sola lettura;- password dell'interfaccia (obbligatoria, nascosta);
TZ,PUID99,PGID100 tra le impostazioni avanzate;- in «Extra Parameters»:
--restart=unless-stopped --stop-timeout 30 --security-opt seccomp=/mnt/user/appdata/febe-seccomp.json.
-
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ùcloneeunshare. 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
/datilo 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:
--security-opt seccomp=unconfined: la sandbox di Chromium resta attiva, ma il contenitore perde tutto il filtro seccomp di Docker.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»).
/datie/libreriarestano; il database si aggiorna da solo all'avvio. Prima di un aggiornamento importante puoi copiare a mano/dati/febe.sqlitea 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.