🛡️ Manuale di amministrazione
Questo manuale è destinato a chi installa ed esegue LibreFolio. La maggior parte delle operazioni di amministrazione avviene dalla riga di comando, tramite variabili d'ambiente o nella scheda Amministrazione delle impostazioni dell'app.
📚 Guide
🐳 Distribuzione ed esposizione
- 📦 Installazione sull'host: Configurazione manuale usando Python, Node.js e Pipenv direttamente sulla macchina host.
- 🐳 Docker avanzato: Distribuzione containerizzata tramite Docker Compose, binding dei volumi e configurazione della proprietà GID/UID dell'utente.
- 🌐 Esposizione sicura: Esponi in modo sicuro la tua istanza privata di LibreFolio su Internet.
- 🔍 Verificare la sicurezza della connessione: Verifica che i tuoi utenti si connettano in sicurezza, e correggi il cookie di sessione o il reverse proxy quando non è così.
⚙️ Configurazione del sistema
- 📝 Variabili d'ambiente: Elenco completo delle variabili
.envsupportate (PORT,JWT_SECRET,LIBREFOLIO_DATA_DIR, ecc.) e precedenza di risoluzione delle variabili. - ⚙️ Impostazioni globali: Configura le impostazioni di runtime a livello di sistema (TTL sessione, limiti di caricamento, intervalli di sincronizzazione dei dati di mercato).
🧹 Manutenzione e operazioni
- 🛠️ Strumenti di amministrazione CLI: Come usare lo script
dev.pyper attività amministrative (gestione utenti, aggiornamenti del database). - 📂 Struttura del filesystem: Dettagli su dove vengono archiviati database, log, caricamenti e cartelle temporanee, e su come eseguire backup.
🔔 Notifiche di aggiornamento
Quando un amministratore accede, LibreFolio controlla su GitHub se è disponibile una versione stabile più recente. Se esiste, la finestra Nuova versione disponibile mostra la tua versione e quella più recente affiancate, con un link Come aggiornare alla guida all'aggiornamento e un link Note di rilascio su GitHub.
- Ricordamelo dopo chiude la finestra fino a un accesso successivo.
- Salta questa versione interrompe la richiesta automatica per quella versione; una più recente viene annunciata di nuovo.
- Una versione viene annunciata solo quando la sua immagine Docker può essere scaricata, e la finestra attende che nessun'altra finestra o guida sia aperta.
- Senza accesso a Internet, il controllo automatico fallisce silenziosamente: nessun errore, nessun banner.
- Per controllare subito, usa Verifica aggiornamenti nel changelog: segnala gli errori e anche le versioni che hai saltato.
👥 Altri utenti — quando qualcuno che non è un amministratore esegue il controllo
Per gli utenti che non sono amministratori, non viene eseguito alcun controllo all'accesso. Se uno di loro esegue Verifica aggiornamenti ed esiste una versione più recente, la finestra di dialogo Aggiornamento disponibile — contatta un amministratore elenca gli amministratori, con i loro indirizzi e-mail quando disponibili, così sanno a chi rivolgersi.
🔐 Mantieni gli utenti connessi dopo un riavvio
LibreFolio firma ogni sessione di login con una chiave segreta, JWT_SECRET.
- Non impostata (impostazione predefinita): viene creata una nuova chiave casuale a ogni avvio, quindi tutti devono accedere di nuovo dopo un riavvio o un aggiornamento.
- Impostata: le sessioni sopravvivono ai riavvii. Impostala anche se diversi server LibreFolio separati condividono gli stessi utenti dietro un load balancer.
🔑 1. Genera una chiave
Non c'è Python sull'host? Esegui invece il comando all'interno del container:
📝 2. Aggiungila al file .env e riavvia
Riavvia LibreFolio (con Docker Compose: docker compose up -d). Mantieni la chiave privata: chiunque la conosca può falsificare una sessione.
I worker di un singolo ./dev.py server --workers … condividono una chiave tra loro. La durata di una sessione è la Durata sessione in Impostazioni globali. Per i dettagli, consulta la pagina per sviluppatori Architettura di sicurezza.