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
220 lines
16 KiB
Markdown
220 lines
16 KiB
Markdown
# Febe per Windows
|
||
|
||
La veste Windows di Febe (specifica §12): lo stesso motore e la stessa interfaccia del contenitore Docker, in
|
||
un'applicazione per Windows 10 e 11. La finestra di Febe mostra l'interfaccia; il browser con cui Febe visita Instagram
|
||
è una **seconda finestra, «Browser di Febe»**, che resta aperta ma fuori vista quando non ti serve.
|
||
|
||
> **Prima di tutto.** Scaricare con un programma è contro le condizioni d'uso di Instagram. Febe va piano per ridurre il
|
||
> rischio per l'account (ritmo umano, tetti, fermo al primo segnale), ma non può azzerarlo. Le storie che Febe apre
|
||
> risultano viste da te.
|
||
|
||
> **Stato.** Questa versione è stata costruita e provata su Linux: tutto ciò che non dipende da Windows ha le sue prove
|
||
> automatiche, ma **nessuna parte che richiede Windows è ancora stata eseguita su un Windows vero** (finestre, WebView2,
|
||
> area di notifica, registro, programma di installazione). Le prove da fare sono in fondo a questa pagina e in
|
||
> `docs/prove-dal-vivo.md`, parte C.
|
||
|
||
## Che cosa serve
|
||
|
||
- Windows 10 o 11 a 64 bit.
|
||
- Il **runtime WebView2** di Microsoft: c'è già in Windows 11 e in quasi tutti i Windows 10. Se manca, sia il programma
|
||
di installazione sia Febe lo dicono e offrono la pagina ufficiale:
|
||
<https://developer.microsoft.com/microsoft-edge/webview2/> (installazione «Evergreen», senza permessi di amministratore).
|
||
- Nessun permesso di amministratore: Febe si installa solo per il tuo utente.
|
||
|
||
## Installazione
|
||
|
||
1. Scarica `Febe-Setup-<versione>.exe` dalla pagina delle release del repository e aprilo.
|
||
2. Windows può avvisare che il programma non è firmato (SmartScreen): «Ulteriori informazioni» ▸ «Esegui comunque».
|
||
3. Il programma di installazione mette `Febe.exe` in `%LOCALAPPDATA%\Programs\Febe`, crea il collegamento nel menu Start
|
||
e, se lo lasci scelto, uno sul desktop. Febe compare in Impostazioni di Windows ▸ App installate (editore Alberto Balbo).
|
||
4. Alla fine puoi aprire Febe subito.
|
||
|
||
**Versione portabile.** `Febe-<versione>-portabile.zip` contiene lo stesso `Febe.exe` (e un `LEGGIMI.txt`): si copia
|
||
dove si vuole e si apre, senza installazione. Anche la versione portabile tiene i dati in `%LOCALAPPDATA%\Febe` e la
|
||
libreria in `Immagini\Febe`, finché non scegli altre cartelle.
|
||
|
||
`Febe.exe` è un file solo (circa 86 MB): contiene il runtime .NET, l'interfaccia e le librerie native (SQLite, SkiaSharp,
|
||
WebView2Loader). Al primo avvio Windows estrae le librerie native in `%TEMP%\.net\Febe`: è normale.
|
||
|
||
## Il primo collegamento a Instagram
|
||
|
||
1. Apri Febe: la finestra mostra l'interfaccia (la prima volta, la schermata di benvenuto).
|
||
2. Vai in **Impostazioni ▸ Collegamento** (o «Collegati a Instagram» dal benvenuto). Si apre in primo piano la finestra
|
||
**«Browser di Febe»** con la vera pagina di accesso di Instagram.
|
||
3. Scrivi tu nome utente, password e l'eventuale codice della verifica in due passaggi **in quella finestra**: vanno
|
||
direttamente alla pagina di Instagram. Febe non riceve e non salva la password; il salvataggio delle password e la
|
||
compilazione automatica del browser sono spenti.
|
||
4. Quando vedi la tua pagina iniziale di Instagram, torna alla finestra di Febe e premi **«Ho finito»**: Febe controlla
|
||
che la sessione ci sia (guarda solo se il cookie esiste, mai il suo valore) e rimette il browser fuori vista.
|
||
5. La prima sessione arriva qualche minuto dopo, con calma: nei primi giorni i tetti sono ridotti (avvio graduale).
|
||
|
||
La sessione resta nel profilo del browser, in `%LOCALAPPDATA%\Febe\browser`, e sopravvive ai riavvii di Febe e di
|
||
Windows (ipotesi S3, da confermare: vedi sotto).
|
||
|
||
### La finestra «Browser di Febe»
|
||
|
||
- Ha una dimensione fissa, sempre la stessa (la pagina è di 1280 × 900 punti), e sotto la pagina una barra con
|
||
«Indietro», «Ricarica» e l'indirizzo (senza la parte dopo il `?`).
|
||
- Quando non ti serve **non è chiusa né ridotta a icona**: è aperta ma spostata fuori dallo schermo, perché il browser
|
||
deve continuare a caricare e scorrere anche quando non lo guardi (ipotesi S2). Non ha un pulsante nella barra delle
|
||
applicazioni.
|
||
- La porti in primo piano dalla finestra di Febe: «Apri il browser» (Attività, striscia rossa di un arresto) o
|
||
«Portalo in primo piano» (Collegamento).
|
||
- **Mentre la usi il motore resta fermo.** Quando hai finito, chiudila (la X o «Ho finito» nel Collegamento): torna
|
||
fuori vista e il motore può ripartire. Dopo una verifica, «Riprendi» si accende solo dopo che hai usato il browser.
|
||
- «Scollega» (Collegamento) chiede conferma, ferma il motore, chiude il browser e cancella `Dati\browser` con la sessione.
|
||
Per chiudere la sessione anche dal lato di Instagram, prima esci dal sito usando tu il browser.
|
||
|
||
## Un account, un motore
|
||
|
||
**Non usare insieme Febe per Windows e il contenitore Docker con lo stesso account Instagram.** Due Febe che raccolgono
|
||
con lo stesso account sommano le visite e raddoppiano il rischio. Lo dice anche la pagina Collegamento. Per un secondo
|
||
account serve un secondo Febe con cartelle tutte sue (`Febe.exe --dati D:\FebeSecondo --libreria D:\FotoSecondo`).
|
||
Febe impedisce due avvii sulla stessa cartella dei dati: un secondo avvio porta in primo piano quello già aperto.
|
||
Vale anche subito dopo uno spostamento della cartella dei dati (il Febe che l'ha spostata tiene anche il nome della
|
||
nuova) e con due modi di scrivere la stessa cartella (nome corto, `subst`, collegamenti): finché Febe è aperto tiene
|
||
il file `febe.lock` nella cartella dei dati, e un secondo Febe che lo trova occupato si ferma e lo dice.
|
||
|
||
## Area di notifica
|
||
|
||
L'icona di Febe (il marchio: un quadrato blu con un anello e una luna) sta nell'area di notifica, accanto all'orologio.
|
||
Un clic apre la finestra; il menu ha **Apri**, **Metti in pausa** (o **Riprendi**, quando Febe è in pausa o fermo per una
|
||
verifica) ed **Esci**. Il suggerimento dell'icona dice che cosa sta facendo Febe.
|
||
|
||
**Chiudendo la finestra Febe resta attivo** nell'area di notifica e continua a lavorare (Impostazioni ▸ Generali ▸
|
||
Avvio, «Chiudendo la finestra, Febe resta attivo nell'area di notifica», acceso di serie). Per fermarlo davvero:
|
||
menu dell'icona ▸ **Esci**. Esci ferma tutto in ordine (motore, scaricamenti, browser): il browser si chiude in modo
|
||
pulito e la sessione resta scritta nel profilo.
|
||
|
||
### Notifiche di Windows
|
||
|
||
Gli avvisi di §13.3 (verifica richiesta, disconnessione, fermo per rallentamento e fine del fermo, storico completato,
|
||
formato non riconosciuto e ricetta sospesa, disco quasi pieno) arrivano come notifiche di Windows, dall'icona di Febe.
|
||
Si scelgono in Impostazioni ▸ Notifiche («Notifiche di Windows» e gli eventi), dove si può aggiungere anche Telegram:
|
||
gli avvisi sono gli stessi della veste Docker (`AlertService`, nella composizione condivisa), e le notifiche passano dal
|
||
guscio di Windows (`NativeShellAlertChannel` su `WindowsShell.NotifyAsync`). Un clic sulla notifica apre Febe. La prova
|
||
dal vivo è la parte D4 di `docs/prove-dal-vivo.md`.
|
||
|
||
## Avvio con il computer
|
||
|
||
Impostazioni ▸ Generali ▸ Avvio ▸ «Avvia Febe all'accensione del computer». Febe scrive il valore `Febe` in
|
||
`HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run` (solo per il tuo utente) e all'accensione parte con
|
||
`--nascosto`: solo l'icona nell'area di notifica, la finestra resta chiusa. Togliendo la spunta il valore sparisce;
|
||
lo toglie anche la disinstallazione.
|
||
|
||
Un Febe avviato con `--dati` (un secondo account) ha un valore suo, `Febe-` seguito da sedici cifre esadecimali, con
|
||
`--nascosto --dati "<cartella>"`: all'accensione parte quella cartella, e l'interruttore di un Febe non accende, non
|
||
mostra e non toglie l'avvio dell'altro. La disinstallazione toglie anche questi valori, se avviano il Febe.exe
|
||
disinstallato.
|
||
|
||
## Dove stanno le cose
|
||
|
||
| Che cosa | Dove | Note |
|
||
|---|---|---|
|
||
| Programma | `%LOCALAPPDATA%\Programs\Febe\Febe.exe` | Dove l'hai copiato, per la versione portabile |
|
||
| **Dati di Febe** | `%LOCALAPPDATA%\Febe` | Database `febe.sqlite`, **profilo del browser con la sessione di Instagram** (`browser\`), dati della finestra dell'interfaccia (`interfaccia\`), miniature, copie del database (`copie\`, sette giorni), registro (`registro\`, quattordici giorni) |
|
||
| **Libreria** | `Immagini\Febe` | Foto e video, una cartella per account, con `_febe.jsonl` |
|
||
|
||
- **Chi ha la cartella dei dati, o una sua copia, ha la sessione di Instagram.** Trattala come una password: niente
|
||
copie su chiavette, cartelle condivise o servizi di sincronizzazione (OneDrive, Dropbox…). `%LOCALAPPDATA%` non è
|
||
sincronizzato da OneDrive: lasciala lì.
|
||
- La cartella dei dati deve stare su un **disco locale**: su una cartella di rete Febe non parte e lo spiega.
|
||
- **Cambiare la libreria** (Impostazioni ▸ Generali ▸ Libreria ▸ «Cambia…»): vale subito per i nuovi file; gli account
|
||
che hanno già file restano nelle loro cartelle. Febe non sposta nessun file.
|
||
- **Cambiare la cartella dei dati** (Impostazioni ▸ Generali ▸ Dati di Febe ▸ «Cambia…»): la nuova cartella deve essere
|
||
vuota e su un disco locale. Lo spostamento avviene **al prossimo avvio**, prima che Febe apra qualunque cosa: copia
|
||
ogni file, lo rilegge e ne confronta lo SHA-256 con l'originale; solo se tutte le copie sono uguali usa la nuova
|
||
cartella e cancella la vecchia (che conteneva una copia della sessione). Se qualcosa va storto la vecchia cartella resta
|
||
quella in uso, intatta, e la copia parziale viene tolta. Per farlo subito: Esci e riapri Febe. La cartella scelta è
|
||
scritta in `HKEY_CURRENT_USER\Software\Febe` (`CartellaDati`); con `--dati` decide invece la riga di comando.
|
||
|
||
## Riga di comando
|
||
|
||
| Opzione | Che cosa fa |
|
||
|---|---|
|
||
| `--nascosto` | Parte con la sola icona nell'area di notifica (lo usa l'avvio con il computer) |
|
||
| `--dati <cartella>` | Cartella dei dati diversa (un secondo account, le prove); «Cambia…» allora non c'è |
|
||
| `--libreria <cartella>` | Libreria di partenza diversa (una cartella scelta poi nelle Impostazioni vince) |
|
||
| `--browser finestra\|composizione\|edge` | Come è ospitato il browser di Instagram (prove di S2, sotto); la scelta resta per gli avvii successivi |
|
||
| `--sviluppo` | Strumenti di sviluppo nella finestra dell'interfaccia (mai nel browser di Febe) |
|
||
| `--sito-di-prova http://127.0.0.1:8481` | Sviluppo e prove: il browser lavora sul sito di prova locale invece che su Instagram |
|
||
| `--accesso-di-prova` | Solo con `--sito-di-prova`: apre il sito una volta, come dopo un accesso |
|
||
| `--prima-sessione <secondi>` | La prima sessione dopo questi secondi invece che dopo 2–10 minuti |
|
||
|
||
## Sicurezza dell'interfaccia
|
||
|
||
L'interfaccia è servita da Febe stesso su `127.0.0.1`, su una porta scelta a ogni avvio, e risponde solo con il
|
||
**gettone di quell'avvio**, che conosce solo la finestra di Febe: la finestra apre `/?gettone=…` una volta, il gettone
|
||
diventa un cookie `HttpOnly`, `SameSite=Strict` e sparisce dall'indirizzo. Si controllano anche `Host` e `Origin`:
|
||
un'altra pagina aperta nel tuo browser non può comandare Febe. Gli indirizzi esterni (guida, repository, «Apri su
|
||
Instagram») si aprono nel tuo browser predefinito, mai nel browser di Febe.
|
||
|
||
## Il browser di Febe e le ipotesi S1–S3
|
||
|
||
Su Windows il browser di Instagram è WebView2 (il motore di Edge), pilotato con il protocollo DevTools attraverso
|
||
`CallDevToolsProtocolMethodAsync` e `GetDevToolsProtocolEventReceiver` (non il pacchetto `DevToolsProtocolExtension`,
|
||
deprecato), con lo **stesso elenco di comandi ammessi** del Chromium di Docker e gli stessi rifiuti: nessun comando
|
||
fuori elenco arriva al browser, `Runtime.evaluate` solo in lettura, nel registro solo i nomi dei comandi.
|
||
|
||
Per S2 (la pagina deve continuare a caricare e scorrere quando la finestra non è in vista) ci sono tre modi, nell'ordine
|
||
della specifica (§6.6); si sceglie con `--browser` e la scelta resta:
|
||
|
||
1. **`finestra`** (predefinito): la finestra «Browser di Febe» aperta ma fuori dallo schermo; il controllo WebView2
|
||
resta sempre «visibile» (`IsVisible` vero: se diventa falso WebView2 smette di disegnare) e il rilevamento
|
||
dell'occlusione è spento dagli argomenti del browser: `--disable-features=CalculateNativeWinOcclusion` e
|
||
`--disable-backgrounding-occluded-windows`. Non sono vietati dalla regola 2: cambiano come il browser organizza il
|
||
proprio lavoro, non ciò che dichiara (user agent, client hints, `navigator`, lingua, fuso e intestazioni restano
|
||
quelli di un Edge normale; nella pagina non entra nulla).
|
||
2. **`composizione`**: lo stesso, con WebView2 ospitato come visual di DirectComposition invece che come finestra figlia;
|
||
Febe passa al browser il mouse e il puntatore della zona della pagina.
|
||
3. **`edge`**: Microsoft Edge avviato come processo e pilotato come il Chromium di Docker (`ChromiumProcessHost`, porta
|
||
di debug fissa 9222 solo su 127.0.0.1), profilo in `Dati\browser\edge`; la sua finestra viene spostata fuori
|
||
dallo schermo. Se Edge non c'è, Febe usa la `finestra`. Ogni Edge avviato da Febe sta in un *job object* di Windows
|
||
che lo chiude insieme a Febe.exe, anche se Febe si chiude all'improvviso o da Gestione attività: un Edge rimasto
|
||
aperto terrebbe la porta 9222 e il browser di Febe non ripartirebbe più.
|
||
|
||
Le prove da fare su un Windows vero, con la procedura esatta, sono in `docs/prove-dal-vivo.md`, **parte C**. In breve:
|
||
|
||
- **S1** — con il sito di prova: una sessione intera (gesti, corpo delle risposte, scaricamenti) e l'anteprima di Attività.
|
||
- **S2** — la stessa sessione con il browser fuori vista, con la finestra di Febe ridotta a icona e con lo schermo bloccato;
|
||
poi, se serve, `composizione` e `edge`.
|
||
- **S3** — accesso a mano, «Esci», riapertura, riavvio di Windows: il collegamento deve restare.
|
||
|
||
## Disinstallare
|
||
|
||
Impostazioni di Windows ▸ App ▸ App installate ▸ Febe ▸ Disinstalla (oppure «Disinstalla Febe.exe» nella cartella del
|
||
programma). Prima esci da Febe (menu dell'icona ▸ Esci).
|
||
|
||
La disinstallazione toglie il programma, i collegamenti, la voce in App installate e l'avvio con il computer. **Non
|
||
cancella mai la cartella dei dati né la libreria** e non chiede nulla su di loro: alla fine dice dove sono. Se non ti
|
||
servono più, cancellale tu — la cartella dei dati contiene la sessione di Instagram.
|
||
|
||
## Costruire il programma di installazione
|
||
|
||
Da Linux (CI, rilascio) o da Windows con bash, con il .NET SDK 10 e NSIS 3 (`apt-get install nsis`):
|
||
|
||
```sh
|
||
installer/costruisci.sh # versione di Directory.Build.props
|
||
installer/costruisci.sh 0.2.0 # oppure una versione esplicita
|
||
```
|
||
|
||
Il risultato è in `out/`: `Febe-Setup-<versione>.exe` e `Febe-<versione>-portabile.zip`, ognuno sotto i 100 MB
|
||
(limite degli allegati di Gitea; con la versione 0.1.0: Febe.exe 86 MB, installazione 80 MB, zip 81 MB). Lo script
|
||
controlla che la pubblicazione abbia prodotto un solo file e che nulla superi il limite. Lo script NSIS è
|
||
`installer/febe.nsi` (Unicode, testi in italiano, versione passata con `/DVERSION=…`).
|
||
|
||
L'icona `src/Febe.Desktop/Febe.ico` (16, 24, 32, 48, 64, 128 e 256 pixel) è disegnata dal marchio dell'appendice C con
|
||
SkiaSharp e scritta a mano: per rigenerarla dopo un cambio del marchio,
|
||
`FEBE_RIGENERA_ICONA=1 dotnet test tests/Febe.Tests --filter IconTests`.
|
||
|
||
## Problemi comuni
|
||
|
||
| Che cosa vedi | Che cosa fare |
|
||
|---|---|
|
||
| All'avvio: «Manca il runtime WebView2 di Microsoft» | Installa il runtime dalla pagina ufficiale (il messaggio offre di aprirla), poi riapri Febe |
|
||
| «La cartella dei dati è su un disco di rete» o «non può scrivere» | Riapri Febe con una cartella dei dati su un disco locale (`--dati`), oppure libera la cartella |
|
||
| Aprendo Febe si porta solo in primo piano la finestra già aperta | È voluto: un solo Febe per cartella dei dati. Per fermarlo: menu dell'icona ▸ Esci |
|
||
| Il collegamento risulta perso dopo un riavvio | È l'ipotesi S3: riferiscilo (parte C di `docs/prove-dal-vivo.md`) con l'ora e il registro di quel giorno |
|
||
| Il browser sembra fermo mentre è fuori vista | È l'ipotesi S2: prova `Febe.exe --browser composizione`, poi `--browser edge`, e riferisci |
|
||
| Il registro | `%LOCALAPPDATA%\Febe\registro\febe-AAAA-MM-GG.log`: azioni ed esiti, mai password, cookie, tasti o contenuti |
|