Välj servernamnet
Det användarsynliga servernamnet kan vara svårt att ändra senare. Förstå delegering och de välkända poster som din driftsättning använder. Testa klientupptäckt och federation i stället för att anta att en lyckad webbinloggning bevisar båda.
Använd en stack som stöds
Synapse använder vanligtvis PostgreSQL för produktionsdata, med stödtjänster beroende på skala och konfiguration. Följ aktuella rekommendationer från uppströmskällan. Håll timeouts för workers, databas och omvänd proxy kompatibla med belastningen.
Håll krypteringspåståenden korrekta
Änd-till-änd-kryptering skyddar innehåll i krypterade rum som stöds mellan deltagande klienter. Hemservern kan fortfarande behandla metadata och icke-krypterat innehåll. Säkerhetskopiering av klientnycklar, verifiering och kontorekonstruktion kräver egna förklaringar.
Underhåll instansen
Begränsa registreringen när det är lämpligt, skydda administrativa gränssnitt och gränssnitt för delade hemligheter och ange medveten lagring av media och händelser. Säkerhetskopiera databasen, konfigurationen och signeringsnycklarna konsekvent och testa sedan återställningen.
Testa klient- och federationsvägarna separat
En klient som Element når hemserverns klient-API, medan andra hemservrar använder federationsupptäckt och slutpunkter. En ändring i omvänd proxy kan bryta den ena medan den andra fortsätter fungera. Testa ett nytt konto, ett lokalt rum och ett auktoriserat federerat rum, och verifiera sedan krypterings- och återställningsbeteendet från klienten.
Officiell dokumentation: Aktuell installationsguide för Synapse
Behåll beständigt identitetsmaterial
Databasen är inte hela hemserverns identitet. Bevara signeringsnyckeln och relevant konfiguration och hemligheter med en konsekvent säkerhetskopia. Kontrollera vilka externa medier och vilken historik som behålls och ange en policy som passar din community. Övervaka lagring och arbetarköer innan tillväxten blir ett avbrott.
Separera kontonamnet från hosting-slutpunkten
Bestäm Matrix server_name innan kontoskapandet: det blir en del av användar- och rumsidentifierare. Värdnamnet för webben som betjänar Synapse kan skilja sig när upptäckt/delegering är korrekt konfigurerad. Planera både klientupptäckt och server-till-server-upptäckt, ett giltigt certifikat och den adressfamilj som faktiskt är nåbar. Element är en klient, inte en ersättning för hemservern. Behåll en oberoende administratörsväg och en återställningskontakt utanför hemservern.
- Välj en stödd Synapse-version och en PostgreSQL-distribution lämplig för produktion.
- Håll databasen och de administrativa lyssnarna privata.
- Definiera registrerings- och federationspolicy uttryckligen.
Officiell dokumentation: Synapse-installation · Matrix-delegering
Bygg upptäckt och proxyn som en del av tjänsten
Generera konfiguration för den valda versionen, bevara signeringsnyckeln och databasen och konfigurera proxyn enligt officiell Synapse-vägledning. Det externt synliga ursprunget, vidarebefordrade headers och begärandesökvägar måste stämma överens. Om delegering används, servera de nödvändiga well-known-dokumenten från identitetsdomänen. Exponera inte den råa interna API-porten för att lösa ett proxyfel. Håll registreringshemligheter utanför webbläsarklientens konfiguration.
Officiell dokumentation: Synapse omvänd proxy
Testa en klientsession och en federationssession
Skapa ett testkonto, anslut en klient som stöds, skicka ett lokalt meddelande och ladda upp en liten fil. Verifiera klientupptäckt oberoende av federationsupptäckt och testa sedan ett rum med en annan tillåten server om federation är avsett. I ett krypterat rum, prova verifiering och klientens nyckelåterställningsflöde. En säkerhetskopia av hemservern återställer inte automatiskt varje dekrypteringsnyckel som klienten har. Förklara vilken metadata servern behåller och vilka rum som är krypterade.
# 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/serverAnvänd felplatsen för att avgränsa reparationen
Om Element inte kan upptäcka servern, granska klientens well-known-svar och TLS-ursprung. Om lokal meddelandehantering fungerar men federation misslyckas, granska federationsdelegering, nåbara adresser, certifikat och policy. Upprepade mediefel kan bero på uppladdningsgränser eller lagring. Bevara databas, media, konfiguration och signeringsnycklar konsekvent; testa återställning utan federation aktiverad först, så att en övning inte skapar en konkurrerande kopia av produktionsidentiteten.