Ja, Conduit kann auf einem Raspberry Pi 4 ausgeführt werden, und das Projekt veröffentlicht ARM64-Versionen. Für einen kleinen Heimserver für den privaten Gebrauch oder die Familie sind die wichtigsten Konfigurationseinstellungen ein 64-Bit-Betriebssystem, ein fester Matrix-Servername, persistenter Speicher und funktionierendes HTTPS-Routing. Conduit befindet sich aktuell im Beta-Stadium, daher sollten Sie es regelmäßig aktualisieren und nicht davon ausgehen, dass ein Pi 4 eine bestimmte Benutzerkapazität unterstützt; das Projekt veröffentlicht keine Benchmark-Ergebnisse zur Benutzerkapazität des Raspberry Pi 4.
Ist Conduit das Richtige für diesen Raspberry Pi?
Conduit ist ein schlanker Matrix-Homeserver mit RocksDB als empfohlener Datenbank. Die offizielle Dokumentation listet eine aarch64Binärdatei und ein OCI-Image auf, das mit einer 64-Bit-Raspberry-Pi-OS-Installation kompatibel ist. Im Changelog des Projekts war zum Zeitpunkt der Überprüfung am 10. Oktober 2026 Version 0.10.15 vom 30. September 2026 vermerkt. Die Vorgängerversion 0.10.14 behob eine Sicherheitslücke im Zusammenhang mit dem Kontozugriff und empfahl ein zeitnahes Upgrade. Aufgrund dieser Historie ist die Überwachung von Updates fester Bestandteil der Einrichtung und keine optionale spätere Aufgabe.
Auf der Website von Conduit wird das Projekt weiterhin als Beta-Version gekennzeichnet und darauf hingewiesen, dass einige Funktionen fehlen. Prüfen Sie vor der Auswahl, ob der aktuelle Funktionsumfang Ihren Anforderungen entspricht, insbesondere wenn Sie auf Bridges, erweiterte Administration oder umfassende Client-Kompatibilität angewiesen sind. Ein Raspberry Pi kann für eine kleine Installation ein praktischer Host sein, jedoch beeinträchtigen Datenverkehr, Mediennutzung und Föderationsaktivitäten die Leistung. Beginnen Sie mit einer überschaubaren Benutzergruppe und beobachten Sie Speicher-, Temperatur- und Speicherplatznutzung, anstatt sich auf eine zugesagte Benutzerzahl zu verlassen.
Was sollten Sie vor der Installation entscheiden?
- Wählen Sie den Namen des Matrix-Servers. In diesem Beispiel lautet er
matrix.example.org. Diese Domäne erscheint in den Matrix-IDs der Benutzer, z. B. @alex:matrix.example.org. Wählen Sie eine Domäne, die Sie kontrollieren und behalten möchten; eine spätere Änderung ist nicht einfach durch Bearbeiten des Hostnamens möglich.
- Planen Sie den öffentlichen Zugriff. Vergeben Sie für die Domain einen DNS-Eintrag, der auf Ihre öffentliche IP-Adresse verweist. Konfigurieren Sie die Router-Weiterleitung und einen Reverse-Proxy mit einem gültigen HTTPS-Zertifikat. Die Bereitstellungsrichtlinien von Conduit erfordern HTTPS und besagen, dass der Verbundverkehr je nach Ihrer Discovery- und Proxy-Konfiguration über Port 443 und/oder 8448 erreichbar sein muss.
- Verwenden Sie Raspberry Pi OS 64-Bit. Überprüfen Sie die Architektur mit dem Befehl ` docker
uname -mbuild --architektur`. Die Ausgabe sollte korrekt sein . Die aktuelle Anleitung von Docker für Raspberry Pi weist darauf hin, dass zukünftige Hauptversionen der Docker Engine keine Pakete mehr für Raspberry Pi OS 32-Bit bereitstellen; für 64-Bit-ARM-Systeme werden Benutzer auf die Installationsanleitung aarch64von Debian verwiesen .arm64
- Die Datenbank sollte persistent gespeichert werden. Speichern Sie die Conduit-Daten in einem persistenten Verzeichnis oder auf einem Docker-Volume und integrieren Sie sie in einen getesteten Backup-Plan. Speichern Sie die einzige Kopie nicht im beschreibbaren Bereich eines Containers oder auf einer Wechselkarte, die Sie möglicherweise formatieren.
Wie startet man Conduit mit Docker?
Installieren Sie Docker Engine und das Compose-Plugin gemäß der aktuellen Anleitung für Ihre Raspberry Pi OS-Version. Überprüfen Sie anschließend, ob Docker ausgeführt wird. Die Conduit-Dokumentation listet das stabile Docker Hub-Image registry.gitlab.com/famedly/conduit/matrix-conduit:latestund die ARM64-OCI-Images auf. Laden Sie das stabile Image herunter und prüfen Sie, ob Docker ein ARM64-Image ausgewählt hat.
docker image pull registry.gitlab.com/famedly/conduit/matrix-conduit:latest
docker image inspect registry.gitlab.com/famedly/conduit/matrix-conduit:latest \
--format '{{.Architecture}}'
Fahren Sie nur fort, wenn die gemeldete Architektur mit Ihrem 64-Bit-Betriebssystem übereinstimmt. Erstellen Sie ein Arbeitsverzeichnis und eine Compose-Datei:
mkdir -p ~/matrix-conduit/data
cd ~/matrix-conduit
nano compose.yaml
Diese Konfiguration dient als Ausgangspunkt. Sie setzt voraus, dass der Reverse-Proxy auf dem Raspberry Pi läuft und Matrix-Anfragen an Port 6167 weiterleitet. Ersetzen Sie den Beispielservernamen. Die leere Angabe CONDUIT_CONFIGweist den Container an, Umgebungsvariablen zu verwenden, wie es die aktuellen Conduit-Docker-Anweisungen für diese Konfiguration erfordern.
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"]'
Erstellen Sie eine private Registrierungstoken-Datei und starten Sie den Dienst:
umask 077
printf 'CONDUIT_REGISTRATION_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env
docker compose up -d
docker compose logs --tail=100 conduit
Das Token wird für die Registrierung Ihres ersten Kontos benötigt; Conduit macht den ersten erstellten Benutzer zum Serveradministrator. Halten Sie die .envDatei geheim und laden Sie sie nicht in ein öffentliches Repository hoch. Im Beispiel wird Conduit an die Loopback-Schnittstelle des Raspberry Pi gebunden, sodass es nur über einen Reverse-Proxy auf demselben Host erreichbar ist. Falls Ihr Proxy in einem anderen Container oder auf einem anderen Rechner läuft, verwenden Sie ein privates Docker-Netzwerk oder eine geschützte private Schnittstelle, anstatt Port 6167 öffentlich freizugeben.
Wie stellt man sicher, dass der Server erreichbar und sicher ist?
Konfigurieren Sie Ihren Reverse-Proxy so, dass er die Domain über HTTPS bereitstellt und Anfragen von Matrix-Clients und der Föderation – einschließlich Anfragen an Conduit – weiterleitet /_matrix/. /.well-known/matrix/Die einfachste öffentliche Konfiguration hängt von Ihrem Proxy und davon ab, ob die Föderation Port 8448 oder die delegierte Namensauflösung über Port 443 verwendet. Orientieren Sie sich an dem entsprechenden Beispiel in der Docker-Bereitstellungsdokumentation von Conduit. Kopieren Sie keinen Proxy-Codeausschnitt, ohne die Hostnamen, die Zertifikatsverwaltung und die Netzwerkpfade anzupassen.
Wenn Sie für Conduit und die Homeserver-URL dieselbe Domain verwenden server_name, stellen Sie sicher, dass Clients den beworbenen HTTPS-Endpunkt erreichen können. Falls Conduit auf einer separaten Subdomain der Matrix-ID-Domain gehostet wird, konfigurieren Sie beide /.well-known/matrix/clientwie /.well-known/matrix/serverim Delegierungsleitfaden beschrieben. Das bloße Öffnen eines Ports konfiguriert weder die Erkennung noch TLS.
Registrieren Sie Ihr Administratorkonto umgehend bei einem Matrix-Client, der Registrierungstoken unterstützt. Deaktivieren Sie anschließend die offene Registrierung, es sei denn, Sie möchten, dass andere Benutzer Konten erstellen. Ändern Sie in Compose den Pfad CONDUIT_ALLOW_REGISTRATIONzu "false", entfernen Sie das Registrierungstoken aus der Serviceumgebung und erstellen Sie den Container mit neu docker compose up -d. Ihr eingebundenes Datenverzeichnis bleibt erhalten. Überprüfen Sie, wer auf den Docker-Socket und die Konfigurationsdateien des Raspberry Pi zugreifen kann, da diese Zugriff auf Servergeheimnisse haben oder diese verändern können.
Wie können Sie überprüfen, ob die Einrichtung funktioniert?
Überprüfen Sie die lokale Matrix-Client-API über den öffentlichen HTTPS-Hostnamen:
curl -fsS https://matrix.example.org/_matrix/client/versions
Eine JSON-Antwort bestätigt die Erreichbarkeit der Client-API; sie beweist jedoch nicht, dass die Föderation funktioniert. Führen Sie den offiziellen Matrix Federation Tester für Ihren Servernamen aus und beheben Sie alle .well-knowngemeldeten DNS-, TLS-, Portweiterleitungs- oder sonstigen Fehler. Melden Sie sich anschließend mit Ihrem neuen Konto an, vergewissern Sie sich, dass es über Administratorrechte verfügt, und testen Sie eine Nachricht in einem Chatraum mit einem Benutzer auf einem anderen Homeserver, falls die Föderation Teil Ihres Ziels ist.
Die oben genannten technischen Details wurden am 10. Oktober 2026 anhand der offiziellen Docker-, Konfigurations-, Delegierungs- und Änderungsprotokollseiten von Conduit überprüft. Weitere Details, die je nach Version variieren, finden Sie im Conduit Docker-Bereitstellungsleitfaden , im ARM64-Bereitstellungsleitfaden (binär und generisch) , in der Konfigurationsreferenz , im Delegierungsleitfaden , im Conduit-Änderungsprotokoll und in den Installationshinweisen für Docker auf Raspberry Pi OS .