Ricostruisci Jellyfin quando l’ambiente di runtime è diventato meno affidabile di una distribuzione pulita, ma conserva e verifica lo stato persistente prima di ricominciare.
La riparazione è preferibile quando la causa è nota e reversibile, ad esempio un errore di mount o di autorizzazioni. La ricostruzione pulita del runtime è preferibile quando la cronologia delle immagini, i pacchetti, le modifiche manuali e una deriva di configurazione sconosciuta fanno sì che ogni correzione introduca un’altra variabile. Il criterio decisionale è capire se puoi identificare il livello guasto e dimostrare quali dati vuoi conservare.
Ripara una singola dipendenza nota
Un mount mancante, un UID errato, un certificato scaduto o un singolo plugin danneggiato sono generalmente più economici da riparare sul posto che da ricreare attorno a un server funzionante. Le ricostruzioni aumentano il rischio di migrazione quando la causa principale è già isolata.
Il metodo USE incoraggia la diagnosi a livello della risorsa o del confine dell’errore prima di modificare l’hardware o l’architettura.
Correggi l’unico errore riproducibile e ripeti il test del flusso di lavoro originale. Se lo stesso sintomo scompare senza modificare lo stato del database, la ricostruzione sarebbe stata inutile.
Ricostruisci quando la deriva del runtime è l’incognita principale
Gli host longevi possono accumulare modifiche ai pacchetti, interventi manuali, vecchie variabili d’ambiente e container ricreati a partire da tag variabili. Un runtime pulito e dichiarativo può essere più facile da verificare rispetto all’applicazione di un’altra patch.
Una ricostruzione pulita diventa prevedibile quando le definizioni dei servizi e i volumi persistenti sono espliciti.
Esporta la definizione attuale, identifica i percorsi persistenti e crea un runtime pulito utilizzando una copia dello stato. Il confine dei dati persistenti dell’app deve rimanere invariato mentre il runtime viene sostituito.
Non ricostruire distruggendo i dati
Eliminare il database perché l’applicazione è guasta non è una ricostruzione del runtime; è un ripristino dello stato. Conserva utenti, stato di visione, metadati e configurazione, a meno che la corruzione non sia stata dimostrata e non esista un piano di recupero.
Un backup precedente alla modifica può fare la differenza tra un rollback e una ricostruzione; una testimonianza sul ripristino dopo un aggiornamento dipendeva dalla disponibilità di un backup prima che la nuova versione diventasse inutilizzabilmente lenta.
Esegui il backup dello stato guasto e verifica l’integrità del database prima di decidere cosa è eliminabile. Conserva le prove originali finché l’istanza sostitutiva non sarà stata convalidata.
Usa un ripristino pulito come test di accettazione
La prova più solida di una ricostruzione è una nuova installazione che si ricollega allo stato e ai contenuti multimediali noti senza modifiche non documentate sull’host. Se funziona, puoi dismettere con sicurezza il runtime precedente.
Un piano di ripristino testato verifica che il servizio sia effettivamente utilizzabile dopo il ripristino, invece di fermarsi a “i file sono stati copiati”.
Verifica gli utenti, il numero di elementi nelle librerie, la cronologia di visione, una riproduzione Direct Play, una transcodifica, le attività pianificate e un riavvio. Documenta ogni passaggio manuale ancora richiesto dalla ricostruzione.
Supporto e consigli
Altro da leggere

È meglio eseguire il backup di Jellyfin mentre è in funzione o arrestare prima il servizio?
Per semplicità, preferisci i backup con il servizio arrestato; usa gli snapshot a caldo solo quando lo stato dell’applicazione viene acquisito in modo coerente...

Perché Jellyfin funziona a temperature elevate o è rumoroso quando nessuno sta guardando contenuti in streaming?
Il calore in stato di inattività di solito indica attività in background o un carico di lavoro su un host condiviso, quindi identifica il...

Quanto spazio di archiviazione libero dovrebbe riservare Jellyfin per le attività in background?
Nessuna percentuale universale di spazio libero è adatta a Jellyfin; misura separatamente la crescita persistente e i picchi temporanei, quindi riserva un margine superiore...

