Dit Matrix-hjem, med føderation forstået.

Vælg servernavnet

Det brugervendte servernavn kan være svært at ændre senere. Forstå delegation og de velkendte poster, som din udrulning bruger. Test klientopdagelse og føderation i stedet for at antage, at et vellykket weblogin beviser begge.

Brug en understøttet stak

Synapse bruger typisk PostgreSQL til produktionsdata, med understøttende tjenester afhængigt af skala og konfiguration. Følg de aktuelle anbefalinger fra upstream. Hold timeouts for workers, database og reverse proxy kompatible med belastningen.

Hold krypteringspåstande præcise

End-to-end-kryptering beskytter indhold i understøttede krypterede rum mellem deltagende klienter. Homeserveren kan stadig behandle metadata og ikke-krypteret indhold. Klientnøglebackup, verifikation og kontogendannelse kræver deres egen forklaring.

Vedligehold instansen

Begræns registrering, når det er relevant, beskyt administrative og delte-hemmelighedsgrænseflader, og indstil bevidst opbevaring af medier og hændelser. Tag backup af databasen, konfigurationen og signeringsnøglerne konsekvent, og test derefter gendannelse.

Test klient- og fæderationsstierne separat

En klient som Element når homeserverens klient-API, mens andre homeservere bruger føderationsopdagelse og endpoints. En ændring i omvendt proxy kan ødelægge den ene, mens den anden fortsat virker. Test en ny konto, et lokalt rum og et autoriseret fødereret rum, og verificér derefter krypterings- og gendannelsesadfærd fra klienten.

Officiel dokumentation: Aktuel Synapse-installationsguide

Bevar holdbart identitetsmateriale

Databasen er ikke hele homeserver-identiteten. Bevar signeringsnøglen og relevante konfigurationer og hemmeligheder med en konsistent sikkerhedskopi. Kontrollér, hvilke eksterne medier og hvilken historik der bevares, og fastlæg en politik, der passer til dit fællesskab. Overvåg lager og worker-køer, før vækst bliver til et nedbrud.

Adskil kontonavnet fra hosting-endpointet

Beslut Matrix server_name før kontoopprettelse: det bliver en del af bruger- og rumidentifikatorer. Webværtsnavnet, der betjener Synapse, kan være forskelligt, når discovery/delegation er konfigureret korrekt. Planlæg både klient-discovery og server-til-server-discovery, et gyldigt certifikat og den adressefamilie, der faktisk kan nås. Element er en klient, ikke en erstatning for homeserveren. Behold en uafhængig administratorrute og en gendannelseskontakt uden for homeserveren.

• Vælg en understøttet Synapse-udgivelse og en produktionsmæssigt passende PostgreSQL-deployment.
• Hold databasen og de administrative lyttere private.
• Definer registrerings- og føderationspolitikken eksplicit.

Officiel dokumentation: Synapse-installation · Matrix-delegering

Byg opdagelse og proxyen som en del af tjenesten

Generer konfiguration til den valgte udgivelse, bevar signeringsnøglen og databasen, og konfigurer proxyen i henhold til den officielle Synapse-vejledning. Den eksternt synlige oprindelse, videresendte headers og anmodningsstier skal stemme overens. Hvis der bruges delegation, skal de krævede well-known-dokumenter leveres fra identitetsdomænet. Eksponer ikke den rå interne API-port for at løse en proxyfejl. Hold registreringshemmeligheder ude af browserklientens konfiguration.

Officiel dokumentation: Synapse reverse proxy

Test en klientsession og en federationssession

Opret en testkonto, tilslut en understøttet klient, send en lokal besked og upload en lille fil. Verificér klientopdagelse uafhængigt af federation-opdagelse, og test derefter et rum med en anden tilladt server, hvis federation er tilsigtet. I et krypteret rum skal du afprøve verifikation og klientens nøglegenopretningsflow. En homeserver-backup gendanner ikke automatisk alle dekrypteringsnøgler, som klienterne har. Forklar, hvilke metadata serveren opbevarer, og hvilke rum der er krypterede.

# 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/server

Brug fejlplaceringen til at indsnævre reparationen

Hvis Element ikke kan finde serveren, skal du undersøge klientens well-known-svar og TLS origin. Hvis lokal messaging virker, men federation fejler, skal du undersøge federation-delegering, tilgængelige adresser, certifikater og politik. Gentagne mediefejl kan involvere uploadgrænser eller lager. Bevar database, medier, konfiguration og signeringsnøgler konsistent; test gendannelse uden federation aktiveret først, så en øvelse ikke skaber en konkurrerende kopi af produktionsidentiteten.