dendrite

Dendrite

Dendrite wird jetzt bei Element-HQ/Dendrite aufrechterhalten

Dendrite ist ein Open-Source-Matrix-HomeServer, der von 2019 bis 2023 als Teil der Matrix.org Foundation entwickelt wurde. Die matrix.org Foundation ist nicht in der Lage, Dendrite aufrechtzuerhalten, und es wird weiterhin von Elementen entwickelt. Außerdem haben Sie die Wahl anderer Matrix -Homeservers

Weitere Informationen finden Sie in der Zukunft von Synapse und Dendrite Blog -Beitrag.

Dendrite ist ein Matrix der zweiten Generation, der in Go geschrieben wurde. Es beabsichtigt, eine effiziente , zuverlässige und skalierbare Alternative zur Synapse bereitzustellen:

• Effizient: Ein kleiner Speicher Fußabdruck mit einer besseren Basisleistung als eine außergewöhnliche Synapse.
• Zuverlässig: Implementiert die Matrixspezifikation wie geschrieben mit derselben Testsuite wie Synapse sowie einer brandneuen GO -Testsuite.
• Skalierbar: Kann auf mehreren Maschinen ausgeführt werden und schließlich auf massive HomeServer -Bereitstellungen skalieren.

Dendrite ist Beta -Software, was bedeutet:

• Dendrite ist bereit für frühe Anwender. Wir empfehlen, Dendrite mit einer PostgreSQL -Datenbank auszuführen.
• Dendrite hat regelmäßige Veröffentlichungen. Wir beabsichtigen, neue Versionen zu veröffentlichen, während wir Fehler beheben und bedeutende Funktionen landen.
• Dendrite unterstützt das Datenbankschema -Upgrades zwischen Releases. Dies bedeutet, dass Sie beim Upgrade von Dendrite niemals Ihre Nachrichten verlieren sollten.

Dies bedeutet nicht:

• Dendrite ist fehlerfrei. Es wurde in der realen Welt noch nicht in Kampf getestet und wird daher anfangs fehleranfällig sein.
• Dendrite ist eine Funktion. Es kann APIs von Kunden oder Föderation geben, die nicht implementiert werden.
• Dendrite ist bereit für massive Einsätze für den HomeServer. Es gibt keine Unterstützung für Hochverfügbarkeit/Clustering.

Derzeit erwarten wir, dass Dendrite für kleine (10S/100S-Benutzer) Homeserver-Bereitstellungen sowie P2P-Matrixknoten im Browser oder auf mobilen Geräten gut funktioniert.

Wenn Sie weitere Fragen haben, schauen Sie sich bitte unsere FAQ an oder besuchen Sie uns mit:

• #dendrite: matrix.org - Allgemeiner Chat über das Dendrite -Projekt für Benutzer und Server -Administratoren gleichermaßen
• #Dendrite -dev: matrix.org - Der Ort für Entwickler, an dem alle Diskussionen der Dendritentwicklung stattfinden
• #Dendrite -Alerts: matrix.org - Release -Benachrichtigungen und wichtige Informationen, die für alle Dendrite -Server -Administratoren sehr empfohlen werden

Anforderungen

Weitere Informationen zu den Anforderungen finden Sie in der Seite "Planung Ihrer Installation".

Um Dendrite zu bauen, müssen Sie 1.21 oder höher gehen.

Für eine nutzbare Föderation Dendrite -Bereitstellung benötigen Sie auch:

• Ein Domain -Name (oder Subdomain)
• Ein gültiges TLS -Zertifikat, das von einer vertrauenswürdigen Behörde für diese Domain ausgestellt wurde
• SRV-Datensätze oder eine bekannte Datei, die auf Ihre Bereitstellung zeigt

Ebenfalls empfohlen sind:

• Eine PostgreSQL -Datenbank -Engine, die mit vielen Benutzern und/oder größeren Räumen besser abschneidet als SQLite
• Ein Reverse -Proxy -Server wie Nginx, der wie dieses Beispiel konfiguriert ist

Der Föderationstester kann verwendet werden, um Ihre Bereitstellung zu überprüfen.

Fangen an

Wenn Sie eine vollwertige Dendrite-Instanz erstellen möchten, finden Sie in der Installationsdokumentation. Weitere Informationen zum Laufen in Docker finden Sie in Build/Docker.

Die folgenden Anweisungen reichen aus, um Dendrite als Nicht-Federing-Testbereitstellung mit selbstsignierten Zertifikaten und SQLite-Datenbanken zu gestalten:

$ git clone https://github.com/matrix-org/dendrite
$ cd dendrite
$ go build -o bin/ ./cmd/...

# Generate a Matrix signing key for federation (required)
$ ./bin/generate-keys --private-key matrix_key.pem

# Generate a self-signed certificate (optional, but a valid TLS certificate is normally
# needed for Matrix federation/clients to work properly!)
$ ./bin/generate-keys --tls-cert server.crt --tls-key server.key

# Copy and modify the config file - you'll need to set a server name and paths to the keys
# at the very least, along with setting up the database connection strings.
$ cp dendrite-sample.yaml dendrite.yaml

# Build and run the server:
$ ./bin/dendrite --tls-cert server.crt --tls-key server.key --config dendrite.yaml

# Create an user account (add -admin for an admin user).
# Specify the localpart only, e.g. 'alice' for '@alice:domain.com'
$ ./bin/create-account --config dendrite.yaml --username alice

Zeigen Sie dann Ihren bevorzugten Matrix -Client unter http://localhost:8008 oder https://localhost:8448 .

Fortschritt

Wir verwenden ein Skript mit dem Titel "Sind wir Synapse noch", das Sytest Compliance -Raten überprüft. Sytest ist ein Black-Box-HomeServer-Test-Rig mit rund 900 Tests. Das Skript ergibt, wie viele dieser Tests Dendrite weitergeben und es mit CI aktualisiert. Ab Januar 2023 haben wir eine 100% ige Server-Server-Parität mit Synapse, und die Parität der Client-Server liegt bei 93%, obwohl CI auf die neuesten Zahlen prüft. In der Praxis bedeutet dies, dass Sie lokal und über die Föderation mit Synapsenservern wie matrix.org einigermaßen gut kommunizieren können, obwohl es immer noch einige fehlende Funktionen gibt (wie SSO und ID-APIs von Drittanbietern).

Wir priorisieren Funktionen, die zuerst Einzelbenutzer-Häuser zugute kommen (z. B. Quittungen, E2E) und nicht zu Merkmalen, an denen massive Bereitstellungen interessiert sein können (OpenID, Gäste, Admin-APIs, API). Dies bedeutet, dass Dendrite unter anderem unterstützt wird:

• Kernraumfunktionalität (Erstellen von Räumen, Einladungen, Auth -Regeln)
• Zimmerversionen 1 bis 10 unterstützt
• Vor Ort und über die Föderation verfüllen
• Konten, Profile und Geräte
• Veröffentlichte Raumlisten
• Typisierung
• Medienapis
• Redaktion
• Tagging
• Kontext
• E2E -Schlüssel und Gerätelisten
• Quittungen
• Drücken
• Gäste
• Benutzerverzeichnis
• Gegenwart
• FullText -Suche

Beitragen

Wir wären dankbar für jede Hilfe in Fragen, die markiert sind, wie wir es noch synapsen haben. Diese Probleme haben alle verwandte Sytests, die bestehen müssen, damit das Problem geschlossen wird. Sobald Sie Ihren Code geschrieben haben, können Sie Sytest schnell ausführen, um sicherzustellen, dass die Testnamen jetzt bestehen.

Wenn Sie neu im Projekt sind, sehen Sie unsere beitragende Seite, um den Aufstieg zu verbessern, und suchen Sie nach guten ersten Problemen. Wenn Sie mit dem Projekt vertraut sind, suchen Sie nach Hilfe, die Sie mit Hilfe suchen.