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

154 lines
9.6 KiB
Markdown

# 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://<IP di Unraid>: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).