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 un client mobile Matrix attuale, non aggiungere il vecchio proxy Sliding Sync standalone a Docker Compose. Il proxy è stato archiviato a novembre 2025; Synapse offre direttamente la funzionalità nativa Simplified Sliding Sync, abilitata di default a partire dalla versione 1.114 di Synapse. Aggiorna Synapse a una versione supportata, verifica che la funzionalità nativa raggiunga i client tramite il tuo URL pubblico e misura il carico su un client che la supporta.
In origine, "Sliding Sync" si riferiva all'implementazione proxy di MSC3575, che si trovava davanti a Synapse e richiedeva un servizio e un'impostazione di rilevamento separati. La specifica Matrix si è evoluta: MSC4186, Simplified Sliding Sync, ha sostituito tale architettura. Il repository proxy ufficiale è stato archiviato e indica che i client moderni non sono più compatibili con esso. Synapse ha aggiunto il supporto nativo per MSC3575 e MSC4186 e lo ha abilitato di default a partire dalla versione 1.114.0, come riportato nel changelog di Synapse .
Questa guida presuppone che Synapse sia già in esecuzione con Docker Compose dietro un URL HTTPS pubblico come https://matrix.example.org. È necessario avere accesso alla shell del progetto Compose, un modo per modificare il tag dell'immagine e la configurazione dell'homeserver, e un'app mobile la cui versione corrente supporti Sliding Sync nativo. Se si desidera solo un caricamento iniziale più veloce in un client che non lo supporta, l'aggiunta di un proxy non farà sì che tale client utilizzi la funzionalità.
Utilizzate una versione di Synapse attualmente supportata anziché basare una nuova installazione sul requisito minimo di funzionalità storico. Consultate le release ufficiali di Synapse e le note di aggiornamento per la versione da cui state effettuando la migrazione. Eseguite un backup del database e dei volumi di dati/configurazione di Synapse prima dell'aggiornamento e verificate se le note prevedono passaggi intermedi di aggiornamento. Questo è particolarmente importante per le installazioni obsolete: l'avviso di sicurezza di Synapse relativo a una vulnerabilità di divulgazione dello stato della stanza di Sliding Sync elenca le release interessate fino alla v1.120.0 e risolve il problema nella v1.120.1. Scegliete una release attualmente supportata con le correzioni più recenti, non semplicemente la prima versione patchata.
Nel file Compose, individua la chiave di servizio per Synapse e il tag immagine che utilizza. Se il tag è bloccato a una versione precedente, modificalo con la versione supportata che hai selezionato. Quindi scarica e ricrea solo quel servizio; sostituisci synapsequanto segue se il tuo servizio ha un nome diverso:

docker compose pull synapse

docker compose up -d synapse
docker compose logs --tail=100 synapse
Prima di procedere, esamina i log per individuare eventuali errori di avvio e verificare il completamento dell'aggiornamento del database. In caso di errore all'avvio, non eseguire un downgrade alla cieca; consulta le istruzioni di aggiornamento specifiche per la versione in uso e ripristina un backup utilizzando esclusivamente la procedura di ripristino appropriata per il tuo database.
Synapse normalmente abilita Sliding Sync nativo per impostazione predefinita, quindi una nuova installazione spesso non richiede YAML aggiuntivo. L'impostazione mantiene il vecchio nome MSC, che può essere fonte di confusione: controlla l'implementazione nativa di Synapse e non è una richiesta di eseguire il proxy dismesso. Verifica homeserver.yamlse nel tuo file di configurazione è presente un valore "false" esplicito. Se lo trovi, modificalo nel blocco di funzionalità esistente:

experimental_features:
msc3575_enabled: true
Se experimental_featuresesiste già, modifica quel blocco invece di aggiungere una chiave YAML duplicata. Se l'impostazione non è presente o è già impostata su true, lasciala invariata. Ricrea il servizio Synapse dopo una modifica della configurazione e controlla i relativi log. Un errore di indentazione YAML può impedire l'avvio di Synapse.
Esamina il JSON servito all'indirizzo https://matrix.example.org/.well-known/matrix/client. Se contiene la vecchia org.matrix.msc3575.proxyproprietà, rimuovila mantenendo le voci di rilevamento client non correlate. Rimuovi anche qualsiasi regola di reverse proxy che invii le richieste client Matrix al proxy dismesso; il /_matrix/client/percorso API standard deve raggiungere Synapse. Non aggiungere una nuova porta proxy né pubblicizzare un URL proxy per MSC4186 nativo. Mantieni tutti gli altri valori noti, incluso l'URL del tuo homeserver, come richiesto dalla tua configurazione.
Da una macchina in grado di raggiungere l'homeserver pubblico, interroga l'endpoint delle versioni client-server. In questo modo si verifica il servizio effettivamente rilevato dai client, anziché controllare solo un container sulla rete Docker privata:

curl -fsS https://matrix.example.org/_matrix/client/versions | jq '.unstable_features["org.matrix.simplified_msc3575"]'
Per una release di Synapse con supporto nativo abilitato e un endpoint correttamente instradato, dovrebbe essere stampato true. Se jqnon è disponibile, eseguire la curlrichiesta senza la pipe e ispezionare il campo JSON. Un valore mancante o falso è un utile segnale di errore: verificare che DNS e HTTPS raggiungano il server previsto, che il proxy inverso passi il percorso API client a Synapse, che l'immagine in esecuzione sia la versione selezionata e che nessuna configurazione esplicita disabiliti la funzionalità. Non esporre i token di accesso quando si condivide l'output diagnostico; questa richiesta di versioni pubbliche non ne richiede uno.
Accedi o riconnettiti con una versione client che supporti il protocollo nativo, utilizzando lo stesso account e lo stesso telefono che userai per il confronto. Se possibile, registra una configurazione di base prima di cambiare server. Confronta un avvio a freddo dell'app dopo aver cancellato o ricostruito i dati locali dell'app solo se comprendi che ciò rimuove il contenuto memorizzato nella cache; in tal caso, confronta un normale avvio a caldo e una riconnessione dopo che il telefono è stato offline. Mantieni costanti la rete, l'account, il set di stanze e il metodo di test.
Un elenco delle stanze iniziale più veloce e un recupero senza problemi dopo la riconnessione sono segnali concreti che il client sta utilizzando il percorso previsto. Non esiste un guadagno di velocità universale: l'implementazione del client e la cache locale, la latenza di rete, le prestazioni del database, il numero di stanze dell'account e il carico del server influiscono tutti sul risultato. La sincronizzazione a scorrimento non accelera i download multimediali né ripara un database sovraccarico. Se il controllo di compatibilità ha esito positivo ma l'app rimane lenta, confrontala con un altro client supportato e analizza i colli di bottiglia prima di modificare le impostazioni del proxy o della cache. Se utilizzi ancora client meno recenti che dipendono dal proxy MSC3575 (ormai obsoleto), testane la compatibilità separatamente prima di rimuovere il vecchio percorso di rilevamento; non dare per scontato che un singolo endpoint sia compatibile con tutte le generazioni di client.
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.