Kies de servernaam
De servernaam die gebruikers zien, kan later moeilijk te wijzigen zijn. Begrijp delegatie en de bekende records die je implementatie gebruikt. Test clientdetectie en federatie in plaats van aan te nemen dat een geslaagde weblogin beide bewijst.
Gebruik een ondersteunde stack
Synapse gebruikt doorgaans PostgreSQL voor productiegegevens, met ondersteunende diensten afhankelijk van schaal en configuratie. Volg de actuele aanbevelingen van upstream. Houd time-outs van workers, database en reverse proxy compatibel met de belasting.
Houd encryptieclaims accuraat
End-to-endversleuteling beschermt inhoud in ondersteunde versleutelde ruimtes tussen deelnemende clients. De homeserver kan nog steeds metadata en niet-versleutelde inhoud verwerken. Client-sleutelback-up, verificatie en accountherstel vereisen een eigen uitleg.
Onderhoud de instantie
Beperk registratie waar passend, bescherm administratieve en gedeelde-geheiminterfaces en stel bewust bewaartermijnen voor media en gebeurtenissen in. Maak consistent back-ups van de database, configuratie en ondertekeningssleutels en test vervolgens het herstel.
Test het client- en federatiepad afzonderlijk
Een client zoals Element bereikt de client-API van de homeserver, terwijl andere homeservers federation discovery en endpoints gebruiken. Een wijziging in de reverse proxy kan het ene breken terwijl het andere blijft werken. Test een nieuw account, een lokale room en een geautoriseerde gefedereerde room en verifieer daarna het encryptie- en herstelgedrag vanuit de client.
Officiële documentatie: Huidige Synapse-installatiegids
Bewaar duurzaam identiteitsmateriaal
De database is niet de volledige identiteit van de homeserver. Bewaar de ondertekeningssleutel en relevante configuratie en secrets met een consistente back-up. Controleer welke externe media en geschiedenis worden bewaard en stel een beleid in dat passend is voor uw community. Monitor opslag en worker-queues voordat groei een storing wordt.
Scheid de accountnaam van het hosting-eindpunt
Bepaal de Matrix server_name vóór het aanmaken van accounts: deze wordt onderdeel van gebruikers- en ruimte-identificaties. De webhostnaam die Synapse bedient kan verschillen wanneer discovery/delegation correct is geconfigureerd. Plan zowel clientdiscovery als server-to-server-discovery, een geldig certificaat en de adresfamilie die daadwerkelijk bereikbaar is. Element is een client, geen vervanging voor de homeserver. Houd een onafhankelijke beheerdersroute en een herstelcontact buiten de homeserver aan.
- Kies een ondersteunde Synapse-release en een voor productie geschikte PostgreSQL-deployment.
- Houd de database- en beheerderslisteners privé.
- Definieer registratie- en federatiebeleid expliciet.
Officiële documentatie: Synapse-installatie · Matrix-delegatie
Bouw discovery en de proxy als onderdeel van de service
Genereer configuratie voor de geselecteerde release, bewaar de ondertekeningssleutel en database, en configureer de proxy volgens de officiële Synapse-richtlijnen. De extern zichtbare origin, doorgestuurde headers en requestpaden moeten overeenkomen. Als delegatie wordt gebruikt, serveer dan de vereiste well-known-documenten vanaf het identiteitsdomein. Stel de ruwe interne API-poort niet bloot om een proxyfout op te lossen. Houd registratiegeheimen buiten de configuratie van de browserclient.
Officiële documentatie: Synapse reverse proxy
Test een clientsessie en een federatiesessie
Maak een testaccount aan, verbind een ondersteunde client, stuur een lokaal bericht en upload een klein bestand. Verifieer clientdetectie onafhankelijk van federatiedetectie en test vervolgens een kamer met een andere toegestane server als federatie de bedoeling is. Test in een versleutelde kamer de verificatie en de sleutelherstelprocedure van de client. Een homeserverback-up herstelt niet automatisch elke versleutelingssleutel die bij de client berust. Leg uit welke metadata de server bewaart en welke kamers versleuteld zijn.
# Discovery checks use your identity domain and HTTPS:
curl --fail https://example.com/.well-known/matrix/client
curl --fail https://example.com/.well-known/matrix/serverGebruik de foutlocatie om de reparatie te beperken
Als Element de server niet kan ontdekken, inspecteer dan de well-known-respons van de client en de TLS-oorsprong. Als lokale berichtenuitwisseling werkt maar federatie faalt, inspecteer dan federatiedelegatie, bereikbare adressen, certificaten en beleid. Herhaalde mediafouten kunnen te maken hebben met uploadlimieten of opslag. Bewaar de database, media, configuratie en ondertekeningssleutels consistent; test herstel eerst zonder federatie ingeschakeld, zodat een oefening geen concurrerende kopie van de productie-identiteit creëert.