Se il repository multimediale di Synapse sta riempiendo il disco, innanzitutto verifica quale directory o volume sta crescendo, quindi utilizza le impostazioni di conservazione supportate da Synapse o l'API di amministrazione per rimuovere i file multimediali. Non eliminare i file direttamente da media_store: Synapse conserva i metadati multimediali nel suo database e la rimozione dei file dietro Synapse può lasciare riferimenti interrotti o rendere difficile la verifica della pulizia. La politica più sicura dipende dal fatto che lo spazio sia utilizzato da caricamenti locali, file multimediali memorizzati nella cache da altri server domestici, miniature o un altro servizio che condivide lo stesso disco.
Cos'è che occupa quello spazio?
Il repository multimediale di Synapse memorizza avatar, allegati e miniature caricati localmente. Memorizza inoltre nella cache i file multimediali recuperati da server Matrix remoti e le risorse utilizzate per le anteprime URL. Questi elementi sono distinti dal database di Synapse, dai log dei container e da qualsiasi repository multimediale esterno. Un filesystem root completo non dimostra di per sé che questa media_storesia la causa.
Sull'host o all'interno del container che ospita i dati montati, confronta l'utilizzo del filesystem con la directory dei dati di Synapse. Sostituisci il percorso di esempio con il valore presente nella tua implementazione:
df -h
du -h --max-depth=1 /path/to/synapse-data
du -sh /path/to/synapse-data/media_store
Synapse media_store_pathimposta di default il percorso su media_store, generalmente nella directory dei dati, ma le installazioni possono sovrascriverlo. I container possono scrivere su un volume montato la cui memoria effettiva si trova sull'host. Controlla homeserver.yaml, le mappature dei volumi dei tuoi container o la configurazione del volume persistente del tuo orchestratore prima di concludere che un percorso host può essere modificato in sicurezza. Se la directory multimediale non è quella che consuma più risorse, esamina il componente che dula visualizza.
Scegli una politica di pulizia adatta ai media
Comportamento verificato: l'impostazione di Synapse media_retentionpuò far scadere i file multimediali locali e quelli remoti memorizzati nella cache dopo periodi di inattività. L'accesso include il caricamento o il download di file multimediali in una stanza. Se un elemento non è mai stato consultato, Synapse utilizza la sua data di creazione. Vengono rimossi sia il file multimediale originale che le relative miniature. La pulizia viene eseguita sul processo di gestione del repository multimediale, che potrebbe coincidere con il processo principale di Synapse.
Dipende dal caso d'uso: i file memorizzati nella cache remota possono generalmente essere recuperati dal server di origine su richiesta dopo la rimozione. I file caricati localmente sono ospitati sul server, quindi la loro eliminazione potrebbe rendere non disponibili vecchi allegati o avatar. Scegli la conservazione locale solo se i tuoi utenti accettano questa conseguenza; una durata di conservazione locale più lunga o nessuna pulizia automatica locale potrebbero essere più appropriate per una community che considera i vecchi allegati come un archivio.
Cosa non significa conservazione: la quarantena dei file multimediali blocca l'accesso ma non elimina il file o le sue miniature. Non libera lo spazio su disco necessario. Se è necessario conservare un elemento in quarantena e contemporaneamente rimuovere altri dati, è importante tenere ben chiara la distinzione: la quarantena è un controllo di moderazione, mentre la conservazione e l'eliminazione sono controlli di archiviazione.
Abilita la conservazione automatica in Synapse
Eseguire un backup della configurazione attiva prima di modificarla. Aggiungere una media_retentionsezione di primo livello o aggiornare quella esistente. Ad esempio, questa policy fa scadere i supporti locali dopo 180 giorni di inattività e le voci della cache remota dopo 30 giorni:
media_retention:
local_media_lifetime: 180d
remote_media_lifetime: 30d
Questi valori sono esempi, non raccomandazioni universali. Imposta il periodo locale in base ai tuoi obblighi di conservazione e alle aspettative relative al contenuto obsoleto della stanza. Se desideri controllare la cache solo per i supporti remoti, configura solo remote_media_lifetime; un periodo di conservazione non impostato o nullo significa che quel tipo non verrà eliminato automaticamente. Synapse documenta inoltre che i supporti in quarantena e i supporti locali protetti dalla quarantena sono esclusi dalla pulizia della conservazione.
Applica la configurazione utilizzando il normale processo di riavvio o ricaricamento della distribuzione e verifica che il worker del repository multimediale sia in esecuzione enable_media_repo: true. Se Synapse utilizza un worker multimediale separato, configura la policy in cui è abilitato il servizio del repository multimediale. Una modifica YAML valida non recupera immediatamente tutto lo spazio: il worker deve eseguire la pulizia e solo i file multimediali più vecchi della soglia di accesso scelta sono idonei.
Recupera spazio più velocemente con l'API di amministrazione.
Se il disco è già critico, Synapse fornisce endpoint amministrativi per la pulizia. Queste azioni rimuovono definitivamente i supporti. Prima di utilizzarle, eseguire un backup del database e dei dati multimediali, verificare che l'URL punti al proprio server domestico e utilizzare un token di accesso di amministratore del server tramite HTTPS. Evitare di inserire il token nella cronologia della shell e nei log condivisi.
Per eliminare i vecchi file multimediali remoti memorizzati nella cache, chiamare l'endpoint documentato con un timestamp di cutoff in millisecondi dall'epoca Unix:
POST /_synapse/admin/v1/purge_media_cache?before_ts=<unix_timestamp_in_ms>
Ad esempio, una shell può calcolare un limite temporale di 30 giorni fa con GNU date:
cutoff=$(date -u -d '30 days ago' +%s000)
curl -X POST "https://matrix.example.com/_synapse/admin/v1/purge_media_cache?before_ts=$cutoff" \
-H "Authorization: Bearer YOUR_SERVER_ADMIN_ACCESS_TOKEN"
La risposta indica quanti elementi memorizzati nella cache sono stati eliminati. Se gli utenti richiedono nuovamente tali file remoti, Synapse li scaricherà di nuovo dal server di origine; questo può ripristinare lo spazio su disco disponibile per i file multimediali più utilizzati.
L'API per la cancellazione dei file multimediali locali consente di eliminare i file in base all'ora dell'ultimo accesso e, facoltativamente, a una dimensione minima. L'endpoint corrente è POST /_synapse/admin/v1/media/delete?before_ts=…; il vecchio endpoint contenente <server_name>è obsoleto dalla versione 1.78.0 di Synapse. Il limite temporale è l'ultimo accesso, non la data di caricamento, e l' keep_profilesopzione è impostata su true per impostazione predefinita. Poiché questa cancellazione può rimuovere file che gli utenti si aspettano rimangano disponibili, è preferibile configurare la conservazione dei file a meno che non si sia definita una data limite appropriata e si accetti l'effetto. Consultare la documentazione ufficiale dell'API per i parametri e la versione di Synapse installata.
Errori comuni da evitare
- "L'eliminazione di una stanza cancellerà anche i relativi file multimediali." Non date per scontato che sia così. La cronologia delle stanze, i file multimediali e le copie memorizzate nella cache vengono gestiti tramite operazioni diverse. Utilizzate l'API di amministrazione dei file multimediali o i criteri di conservazione per gestire i file multimediali in modo specifico.
- "La quarantena libera spazio su disco." Non è vero: i file multimediali e le miniature in quarantena rimangono sul disco. Quando l'obiettivo è recuperare spazio di archiviazione, è consigliabile utilizzare un'operazione di eliminazione o di conservazione.
- "Tutti i file multimediali presenti nel repository sono caricati dai miei utenti." Il repository include anche la cache remota e i dati di anteprima degli URL. Confronta le sottocartelle del repository e la configurazione di archiviazione di Synapse prima di scegliere un'eliminazione definitiva.
- "L'eliminazione manuale dei file equivale alla pulizia effettuata da Synapse." Non si tratta di un'alternativa supportata. Lascia che Synapse aggiorni i metadati tramite il suo processo di conservazione o l'API di amministrazione.
Verificare che l'utilizzo del disco stia diminuendo.
Dopo che il processo di pulizia ha avuto il tempo di essere eseguito, verificare df -hnuovamente le dimensioni della directory multimediale. Per una pulizia tramite API, confermare il numero di elementi eliminati nella risposta e confrontare la directory pertinente prima e dopo. Controllare i log di Synapse per eventuali errori di configurazione o del processo. Se la directory rimane di grandi dimensioni, verificare se la distribuzione scrive i file multimediali su un provider configurato o su un volume separato; l'API di Synapse per l'eliminazione locale dei file multimediali non influisce sui file multimediali archiviati in un repository multimediale esterno. Non dare per scontato che una risposta API positiva riduca le dimensioni del filesystem host se i file si trovano altrove.
Riferimenti ufficiali