Esegui Mjölnir come bot di moderazione per le stanze Matrix con Docker
Configura Mjölnir con un account Matrix dedicato, una sala di gestione crittografata, Docker Compose, un elenco di policy e controlli di autorizzazione.
Per il backup del database di Synapse, utilizza il formato di dump personalizzato di PostgreSQL, escludi la tabella delle chiavi monouso e ripristina il database in un database vuoto appena creato. Il solo dump del database non costituisce un backup completo del server domestico: conserva anche la configurazione di Synapse, la chiave di firma e i supporti locali. Le linee guida ufficiali di Synapse per il backup, aggiornate al 10 ottobre 2026, sconsigliano espressamente di sovrascrivere tabelle esistenti e di ripristinare vecchie chiavi monouso per la crittografia end-to-end.
Verificato: pg_dump crea un'istantanea coerente mentre PostgreSQL rimane online; non è necessario arrestare Synapse durante l'esecuzione del dump. Un dump del solo database non include i file dell'archivio multimediale di Synapse, homeserver.yamli file di configurazione a cui si fa riferimento o la chiave di firma del server. Conservare questi elementi in un set di backup protetto separato. Synapse identifica i contenuti caricati localmente e, quando le miniature dinamiche sono disabilitate, le miniature locali come dati da conservare. Le cache dei file multimediali remoti e delle anteprime URL possono generalmente essere recuperate o ricostruite.
Azione: prima di creare un piano di ripristino, identificare il nome del database attivo, il ruolo PostgreSQL, la directory di configurazione di Synapse, il percorso della chiave di firma e il percorso del mediastore. Utilizzare i percorsi configurati sul server; questi variano a seconda del pacchetto, del container e della distribuzione.
Errore comune: un dump SQL riuscito non è la prova che l'intero server domestico possa essere recuperato. Azione: eseguire il backup del database, della configurazione, della chiave di firma e dei supporti locali necessari, e testare periodicamente il ripristino di tutti questi elementi insieme.
I comandi seguenti presuppongono un host Linux con gli strumenti da riga di comando di PostgreSQL installati, un database denominato synapsee l'autorizzazione a eseguire comandi PostgreSQL come postgresaccount di sistema operativo. Sostituire il nome del database e i percorsi con i valori della propria implementazione. Salvare il dump su una memoria protetta con spazio libero sufficiente; potrebbe contenere messaggi privati e dati dell'account.
Crea il dump, escludendo il contenuto della tabella che Synapse indica come non debba essere riprodotta da un backup precedente:
sudo -u postgres pg_dump -Fc --exclude-table-data=e2e_one_time_keys_json synapse > /secure-backups/synapse.dump-FcSeleziona il formato di archivio personalizzato di PostgreSQL, che è adatto pg_restoree spesso più compatto del normale SQL. L'esclusione influisce sui dati della tabella; non rimuove la definizione della tabella.
Verifica che il file esista e non sia vuoto, quindi elenca il contenuto dell'archivio:
ls -lh /secure-backups/synapse.dump
sudo -u postgres pg_restore --list /secure-backups/synapse.dumpUn elenco conferma che PostgreSQL è in grado di leggere la struttura dell'archivio; non dimostra però che ogni riga possa essere ripristinata o che gli altri file di backup siano completi. Per verifiche più approfondite, copiare il dump in un archivio di backup separato e verificarne il checksum dopo il trasferimento.
Errore comune: si pensa che sia necessario arrestare Synapse per ogni snapshot pg_dump. La pagina ufficiale di Synapse afferma che uno snapshot normale pg_dumpè coerente senza arrestare Synapse o PostgreSQL. Azione: mantenere il servizio online per questo backup logico, ma pianificare una finestra di manutenzione per un ripristino completo.
Il ripristino è un'operazione di sostituzione. Innanzitutto, arrestare Synapse e tutti i processi in esecuzione su Synapse in modo che nulla si connetta o scriva sul database di destinazione durante il ripristino. Confermare il nome del database di destinazione e il relativo dump prima di impartire comandi di modifica del database.
Crea un nuovo database con codifica UTF-8 e il proprietario utilizzato dalla tua configurazione Synapse. Di seguito viene utilizzato il ruolo di esempio synapse_user:
sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapseSe il nome del database esiste già, non ripristinarlo indiscriminatamente. Segui la procedura di ripristino per conservare o rimuovere il vecchio database solo dopo averne verificato il contenuto e aver accertato di disporre di un backup separato e recuperabile.
Carica l'archivio nel database vuoto:
sudo -u postgres pg_restore --dbname=synapse /secure-backups/synapse.dumpVerifica lo stato di uscita del comando e l'output di PostgreSQL. Analizza gli errori prima di avviare Synapse. Evita opzioni come --cleanquella di utilizzare come scorciatoia per il ripristino su un database di produzione popolato; Synapse avverte che le tabelle preesistenti possono causare errori o sottili incongruenze.
Se il dump non ha escluso i dati delle chiavi monouso, cancellarli prima dell'avvio. Connettersi al database ripristinato ed eseguire:
sudo -u postgres psql --dbname=synapse -c 'TRUNCATE e2e_one_time_keys_json;'Synapse documenta questa eccezione perché il ripristino di vecchie chiavi monouso può indurre un client a riutilizzare chiavi già utilizzate, causando potenzialmente problemi di decrittazione dei messaggi. La loro cancellazione richiede ai client di caricare nuove chiavi. Se si è seguita l'esclusione consigliata, la tabella non presenta righe ripristinate e questo ulteriore troncamento non è necessario.
Errore comune: si pensa che tutte le tabelle del database possano essere ripristinate in sicurezza insieme. Soluzione: escluderle e2e_one_time_keys_jsondurante il backup o troncarle dopo il ripristino, e farlo prima dell'avvio di qualsiasi processo Synapse.
Se possibile, ripristina la configurazione, la chiave di firma e i file multimediali locali necessari dallo stesso punto di ripristino. Conserva la chiave di firma originale: Synapse la utilizza per firmare eventi e richieste di federazione. Se devi sostituirla, segui le istruzioni di Synapse relative alle chiavi di firma e configura la vecchia chiave pubblica come vecchia chiave di firma. Il database, i file multimediali e la configurazione ripristinati da punti temporali molto diversi potrebbero non corrispondere allo stesso stato, quindi verifica la coerenza del piano di ripristino.
Avvia Synapse e i relativi processi solo dopo aver completato il ripristino e la gestione della chiave monouso. Esamina i log del servizio per individuare eventuali errori di connessione al database, errori di schema o di autorizzazione mancanti e problemi di aggiornamento in background. Quindi accedi con un account di prova, controlla la cronologia recente di una stanza nota e apri un allegato caricato localmente. Verifica i servizi di federazione e applicativi se la tua implementazione ne fa uso. Questi controlli rappresentano un test preliminare, non una garanzia che ogni stanza o oggetto multimediale sia stato ripristinato.
Dipende dalla configurazione dell'implementazione: i percorsi dei comandi, i nomi dei servizi, i ruoli del database, l'orchestrazione dei container e la conservazione dei backup sono specifici dell'installazione. Questa procedura descrive un dump logico e il ripristino di PostgreSQL, non il ripristino a un punto specifico nel tempo, i ruoli a livello di cluster PostgreSQL o una progettazione di failover ad alta disponibilità. Per i sistemi di produzione, consultare la documentazione di backup di Synapse e la documentazione di backup e ripristino di PostgreSQL per individuare i metodi più adatti alla versione di PostgreSQL e agli obiettivi di ripristino in uso. Annotare la data, le versioni del software e il risultato del test di ripristino; non dare per scontato che un archivio non testato sia un backup recuperabile.
Configura Mjölnir con un account Matrix dedicato, una sala di gestione crittografata, Docker Compose, un elenco di policy e controlli di autorizzazione.
Ignora il proxy obsoleto e configura Sliding Sync, la funzione integrata di Synapse. Verifica il rilevamento dei client, quindi misura il caricamento dell'elenco delle stanze e il comportamento di riconnessione su un telefono compatibile.
Distribuisci Element Web come sito statico, puntalo al tuo homeserver Matrix, aggiungi HTTPS e configura Nginx per servire gli aggiornamenti senza file obsoleti.
Configura Conduit su un Raspberry Pi 4 a 64 bit con dati persistenti, federazione HTTPS, registrazione protetta e verifica del corretto funzionamento dell'homeserver.
Assegna a una stanza Matrix un indirizzo facile da condividere sul tuo dominio utilizzando Element o l'API Matrix, con controlli per le autorizzazioni, la denominazione Synapse e la federazione.
Configurare coturn e Synapse con le credenziali TURN corrispondenti, aprire le porte relay necessarie e verificare che i client Matrix possano ottenere i candidati relay.
Configura un server domestico Synapse persistente con Docker Compose, PostgreSQL, una configurazione privata ed effettua i controlli necessari prima di esporlo tramite HTTPS.
Imposta un nome personalizzato, colori e elementi di accesso per la tua implementazione di Element Web, tenendo presente quali parti rimangono a marchio Element.
Diagnostica se Synapse ha raggiunto il limite di file aperti per processo, imposta un comando systemd specifico per il servizio o il worker corretto e verifica il limite effettivo.
Scopri se l'errore è limitato a un singolo browser o a un singolo evento, quindi utilizza la chiave di ripristino di Element o un dispositivo attendibile senza rischiare di perdere la cronologia crittografata rimanente.