Eseguire un server domestico Matrix leggero su Raspberry Pi 4

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 è la soluzione giusta per questo Raspberry Pi?

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.

Cosa bisogna decidere prima dell'installazione?

  • Scegli il nome del server Matrix. In questo esempio, è 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.
  • Pianifica l'accesso pubblico. Assegna al dominio un record DNS che punti al tuo indirizzo IP pubblico. Configura l'inoltro del router e un proxy inverso con un certificato HTTPS valido. Le linee guida di implementazione di Conduit richiedono HTTPS e specificano che il traffico di federazione deve essere raggiungibile sulla porta 443 e/o 8448, a seconda della configurazione di discovery e proxy.
  • Utilizzare Raspberry Pi OS a 64 bit. Verificare l'architettura con 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.
  • Mantieni il database persistente. Archivia i dati di Conduit in una directory persistente o in un volume Docker e includili in un piano di backup testato. Non archiviare l'unica copia nello strato scrivibile di un container o su una scheda rimovibile che potresti riformattare.

Come si avvia Conduit con Docker?

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.

Come si rende il server raggiungibile e sicuro?

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.

Come si può verificare che la configurazione funzioni correttamente?

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 .

Lascia un commento

Esegui Mjölnir come bot di moderazione per le stanze Matrix con Docker

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.

Attiva la sincronizzazione nativa dello scorrimento della matrice per un caricamento più rapido sui dispositivi mobili.

Attiva la sincronizzazione nativa dello scorrimento della matrice per un caricamento più rapido sui dispositivi mobili.

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.

Ospita Element Web su Nginx con un Homeserver personalizzato

Distribuisci Element Web come sito statico, puntalo al tuo homeserver Matrix, aggiungi HTTPS e configura Nginx per servire gli aggiornamenti senza file obsoleti.

Eseguire un server domestico Matrix leggero su Raspberry Pi 4

Configura Conduit su un Raspberry Pi 4 a 64 bit con dati persistenti, federazione HTTPS, registrazione protetta e verifica del corretto funzionamento dell'homeserver.

Configura un alias personalizzato per una stanza Matrix sul tuo dominio

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.

Configura coturn per chiamate vocali e video Matrix affidabili.

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.

Distribuisci Matrix Synapse con Docker Compose e PostgreSQL

Distribuisci Matrix Synapse con Docker Compose e PostgreSQL

Configura un server domestico Synapse persistente con Docker Compose, PostgreSQL, una configurazione privata ed effettua i controlli necessari prima di esporlo tramite HTTPS.

Personalizza il tema e l'immagine coordinata di Element Web

Imposta un nome personalizzato, colori e elementi di accesso per la tua implementazione di Element Web, tenendo presente quali parti rimangono a marchio Element.

Aumenta il limite di file di Systemd in Synapse senza dover fare supposizioni.

Aumenta il limite di file di Systemd in Synapse senza dover fare supposizioni.

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.

Element mostra "Decrittazione non riuscita"? Ripristina la chiave della stanza mancante

Element mostra "Decrittazione non riuscita"? Ripristina la chiave della stanza mancante

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.