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.
Sì, un Raspberry Pi 4 può eseguire Conduit e il progetto pubblica build per architettura ARM64. Per un piccolo server domestico personale o familiare, le scelte di configurazione più importanti sono un sistema operativo a 64 bit, un nome server Matrix permanente, storage persistente e routing HTTPS funzionante. Conduit è attualmente descritto come versione beta, quindi è consigliabile mantenerlo aggiornato e non dare per scontato che un Raspberry Pi 4 abbia una capacità utente specifica supportata; il progetto non pubblica benchmark sulla capacità del Raspberry Pi 4.
Conduit è un server domestico Matrix leggero che consiglia RocksDB come database di backend. La documentazione ufficiale per l'installazione elenca un aarch64binario e un'immagine OCI, compatibili con un'installazione di Raspberry Pi OS a 64 bit. Il registro delle modifiche del progetto riportava la versione v0.10.15, datata 30 settembre 2026, al 10 ottobre 2026. La precedente versione v0.10.14 aveva risolto una vulnerabilità di accesso agli account e raccomandava un aggiornamento immediato. Questa storia rende il monitoraggio degli aggiornamenti parte integrante della configurazione, e non un'attività opzionale da svolgere in un secondo momento.
Il sito web di Conduit etichetta ancora il progetto come beta e segnala la mancanza di alcune funzionalità. Prima di sceglierlo, verifica che le funzionalità attuali soddisfino le tue esigenze, soprattutto se dipendi da bridge, amministrazione avanzata o ampia compatibilità con i client. Un Raspberry Pi può essere un host pratico per implementazioni di piccole dimensioni, ma il traffico, l'utilizzo dei contenuti multimediali e l'attività di federazione influiscono sulle prestazioni. Inizia con un gruppo di utenti limitato e monitora l'utilizzo di memoria, temperatura e spazio di archiviazione, anziché fare affidamento sul numero di utenti promesso.
matrix.example.org. Questo dominio appare negli ID Matrix degli utenti, come @alex:matrix.example.org. Scegli un dominio che controlli e che intendi conservare; modificarlo in seguito non è una semplice modifica del nome host.uname -m. Dovrebbe riportare aarch64. Le attuali linee guida di Docker per Raspberry Pi indicano che le future versioni principali di Docker Engine non forniranno più pacchetti per Raspberry Pi OS a 32 bit; su ARM a 64 bit, indirizzano gli utenti alle arm64istruzioni di installazione di Debian.Installa Docker Engine e il plugin Compose seguendo le istruzioni aggiornate per la versione del sistema operativo del tuo Raspberry Pi. Quindi verifica che Docker sia in esecuzione. La documentazione di Conduit elenca l'immagine stabile di Docker Hub registry.gitlab.com/famedly/conduit/matrix-conduit:lateste le immagini OCI per ARM64. Scarica l'immagine stabile e verifica che Docker abbia selezionato un'immagine per ARM64:
docker image pull registry.gitlab.com/famedly/conduit/matrix-conduit:latest
docker image inspect registry.gitlab.com/famedly/conduit/matrix-conduit:latest \
--format '{{.Architecture}}'
Prosegui solo se l'architettura segnalata corrisponde al tuo sistema operativo a 64 bit. Crea una directory di lavoro e un file Compose:
mkdir -p ~/matrix-conduit/data
cd ~/matrix-conduit
nano compose.yaml
Utilizza questa configurazione come punto di partenza. Presuppone che il reverse proxy sia in esecuzione sull'host Pi e inoltri le richieste Matrix alla porta 6167. Sostituisci il nome del server di esempio. Il valore vuoto CONDUIT_CONFIGindica al container di utilizzare le variabili d'ambiente, come richiesto dalle attuali istruzioni Docker di Conduit per questa configurazione.
services:
conduit:
image: registry.gitlab.com/famedly/conduit/matrix-conduit:latest
container_name: conduit
restart: unless-stopped
ports:
- "127.0.0.1:6167:6167"
volumes:
- ./data:/var/lib/matrix-conduit
environment:
CONDUIT_CONFIG: ""
CONDUIT_SERVER_NAME: "matrix.example.org"
CONDUIT_ADDRESS: "0.0.0.0"
CONDUIT_PORT: "6167"
CONDUIT_DATABASE_BACKEND: "rocksdb"
CONDUIT_ALLOW_REGISTRATION: "true"
CONDUIT_REGISTRATION_TOKEN: "${CONDUIT_REGISTRATION_TOKEN}"
CONDUIT_ALLOW_FEDERATION: "true"
CONDUIT_TRUSTED_SERVERS: '["matrix.org"]'
Crea un file di token di registrazione privato e avvia il servizio:
umask 077
printf 'CONDUIT_REGISTRATION_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env
docker compose up -d
docker compose logs --tail=100 conduit
Il token è necessario per registrare il primo account; Conduit assegna al primo utente creato il ruolo di amministratore del server. Mantieni il .envfile privato e non caricarlo in un repository pubblico. L'esempio collega Conduit all'interfaccia loopback del Raspberry Pi, quindi è raggiungibile solo tramite un proxy inverso in esecuzione sullo stesso host. Se il tuo proxy è in esecuzione in un altro container o su un'altra macchina, utilizza una rete Docker privata o un'interfaccia privata protetta anziché esporre pubblicamente la porta 6167.
Configura il tuo reverse proxy per servire il dominio tramite HTTPS e inoltrare le richieste del client Matrix e della federazione, incluse le richieste HTTPS /_matrix/e /.well-known/matrix/HTTPS, a Conduit. La configurazione pubblica più semplice dipende dal proxy utilizzato e dal fatto che la federazione utilizzi la porta 8448 o la scoperta delegata sulla porta 443. Segui l'esempio corrispondente nella documentazione di Conduit per la distribuzione con Docker; non copiare un frammento di configurazione del proxy senza adattarne i nomi host, la gestione dei certificati e i percorsi di rete.
Se si utilizza lo stesso dominio sia per server_nameil server principale che per l'URL del server principale, assicurarsi che i client possano raggiungere l'endpoint HTTPS pubblicizzato. Se Conduit è ospitato su un sottodominio separato dal dominio Matrix ID, configurare entrambi /.well-known/matrix/clientcome /.well-known/matrix/serverdescritto nella guida alla delega. L'apertura di una porta da sola non configura il rilevamento o il TLS.
Registra subito il tuo account amministratore con un client Matrix che supporti i token di registrazione. Quindi disattiva la registrazione aperta a meno che tu non voglia intenzionalmente che altri creino account. In Compose, cambia CONDUIT_ALLOW_REGISTRATIONin "false", rimuovi il token di registrazione dall'ambiente di servizio e ricrea il container con docker compose up -d. La tua directory dati montata tramite bind rimane al suo posto. Verifica chi può accedere al socket Docker del Raspberry Pi e ai file di configurazione, perché potrebbero rivelare o modificare segreti del server.
Verifica l'API client locale di Matrix tramite il nome host HTTPS pubblico:
curl -fsS https://matrix.example.org/_matrix/client/versions
Una risposta JSON conferma che l'API client è raggiungibile, ma non dimostra che la federazione funzioni correttamente. Esegui il Matrix Federation Tester ufficiale per il nome del tuo server e correggi eventuali problemi relativi a DNS, TLS, port forwarding o altri .well-knownerrori segnalati. Infine, accedi con il tuo nuovo account, verifica che disponga dei privilegi di amministratore e, se la federazione è tra i tuoi obiettivi, prova a inviare un messaggio in una stanza con un utente su un altro server domestico.
I dettagli tecnici sopra riportati sono stati verificati confrontandoli con le pagine ufficiali di Conduit relative a Docker, configurazione, delega e registro delle modifiche, in data 10 ottobre 2026. Per i dettagli, che variano a seconda della versione, consultare la guida alla distribuzione Docker di Conduit , la guida alla distribuzione binaria e generica per ARM64 , il riferimento alla configurazione , la guida alla delega , il registro delle modifiche di Conduit e le note di installazione di Docker per Raspberry Pi OS .
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.