Recupera spazio su disco in Synapse Media senza compromettere i file condivisi.

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

Lascia un commento

Elimina i vecchi messaggi e file multimediali di Synapse senza perdere dati.

Utilizza le API di Synapse per la cancellazione della cronologia e dei supporti di memorizzazione o le impostazioni di conservazione per rimuovere in modo sicuro i dati obsoleti, quindi verifica il completamento dell'operazione e il recupero dello spazio su disco.

Crea un bot di tipo Matrix Echo in Python con Simple-Matrix-Bot-Lib

Crea un bot di tipo Matrix Echo in Python con Simple-Matrix-Bot-Lib

Installa la libreria corrente, collega un account Matrix dedicato ed esegui un piccolo bot !echo con una gestione più sicura delle credenziali e un test chiaro.

Collega Matrix a WhatsApp, Telegram e Discord con bridge separati.

Collega Matrix a WhatsApp, Telegram e Discord con bridge separati.

Configura tre bridge Mautrix con registrazioni, accessi e test separati, ed evita sorprese legate alla rete Docker, alle policy degli account e alla sincronizzazione.

Recupera spazio su disco in Synapse Media senza compromettere i file condivisi.

Scopri cosa occupa spazio di archiviazione in Synapse, imposta la conservazione sicura dei file multimediali e svuota la cache remota senza eliminare i file direttamente dal disco.

Disattivare gli utenti Matrix inattivi senza eliminare la cronologia delle stanze

Disattivare gli utenti Matrix inattivi senza eliminare la cronologia delle stanze

Esamina l'attività del dispositivo, disattiva gli account Synapse inattivi confermati tramite l'API di amministrazione e scopri cosa rimuove effettivamente il flag di cancellazione opzionale.

Ridurre la pressione sulla memoria di PostgreSQL in Matrix Synapse

Scopri se l'utilizzo della memoria PostgreSQL deriva da query, buffer condivisi, connessioni o operazioni di manutenzione, quindi apporta modifiche mirate e compatibili con Synapse.

Perché le connessioni tra le stanze di sinapsi di Matrix sono lente e cosa controllare

Perché le connessioni tra le stanze di sinapsi di Matrix sono lente e cosa controllare

Traccia le connessioni lente alle stanze Matrix verso un homeserver remoto, il backoff della federazione, il caricamento del database locale o una coda di invio in uscita prima di modificare le impostazioni di Synapse.

Chiudere le iscrizioni a Matrix o richiedere token di invito su Synapse

Impedisci la creazione di account aperti su un server Synapse self-hosted oppure mantieni le registrazioni accessibili solo su invito con token di registrazione a utilizzo limitato.

Avviso di identità della sessione Element: verifica le tue credenziali di accesso in modo sicuro

Clear Element offre un sistema di avviso per sessioni non verificate utilizzando un dispositivo attendibile o una chiave di ripristino, con controlli che proteggono la cronologia delle chat crittografate.

Evita i timeout di blocco dei file di ownCloud con il backend giusto

Distingui i conflitti di blocco del database dai blocchi WebDAV scaduti, quindi scegli e configura la soluzione ownCloud 10 più adatta.