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
154 lines
9.6 KiB
Markdown
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).
|