서버 이름 선택
사용자에게 표시되는 서버 이름은 나중에 변경하기 어려울 수 있습니다. 위임 및 배포에서 사용되는 잘 알려진 레코드를 이해하세요. 웹 로그인 성공이 두 가지 모두를 증명한다고 가정하지 말고 클라이언트 검색과 연합을 테스트하세요.
지원되는 스택을 사용하세요
Synapse는 일반적으로 프로덕션 데이터에 PostgreSQL을 사용하며, 지원 서비스는 규모와 구성에 따라 달라집니다. 최신 업스트림 권장 사항을 따르세요. 워커, 데이터베이스, 리버스 프록시의 타임아웃을 부하에 맞게 유지하세요.
암호화 관련 주장을 정확하게 유지하세요
종단 간 암호화는 참여 클라이언트 간에 지원되는 암호화된 방의 콘텐츠를 보호합니다. 홈서버는 여전히 메타데이터와 암호화되지 않은 콘텐츠를 처리할 수 있습니다. 클라이언트 키 백업, 확인 및 계정 복구에는 별도의 설명이 필요합니다.
인스턴스 유지 관리
적절한 경우 등록을 제한하고, 관리 및 공유 비밀 인터페이스를 보호하며, 미디어 및 이벤트 보존 기간을 의도적으로 설정하세요. 데이터베이스, 구성 및 서명 키를 일관되게 백업한 후 복구를 테스트하세요.
클라이언트와 페더레이션 경로를 별도로 테스트
Element와 같은 클라이언트는 홈서버의 클라이언트 API에 접속하는 반면, 다른 홈서버는 연합 검색 및 엔드포인트를 사용합니다. 역방향 프록시 변경은 한쪽을 중단시키면서 다른 쪽은 계속 작동하게 할 수 있습니다. 새 계정, 로컬 룸 및 승인된 연합 룸을 테스트한 다음, 클라이언트에서 암호화 및 복구 동작을 확인하세요.
공식 문서: 현재 Synapse 설치 가이드
영구적인 신원 자료 유지
데이터베이스가 홈서버 신원의 전부는 아닙니다. 서명 키와 관련 구성 및 비밀을 일관된 백업으로 보존하세요. 어떤 외부 미디어와 기록이 보관되는지 확인하고 커뮤니티에 적합한 정책을 설정하세요. 증가가 장애가 되기 전에 저장 공간과 워커 큐를 모니터링하세요.
계정 이름과 호스팅 엔드포인트를 분리하세요
계정 생성 전에 Matrix server_name을 결정하세요. 이는 사용자 및 룸 식별자의 일부가 됩니다. 디스커버리/위임이 올바르게 구성된 경우 Synapse를 제공하는 웹 호스트 이름은 달라질 수 있습니다. 클라이언트 디스커버리와 서버 간 디스커버리, 유효한 인증서, 실제로 도달 가능한 주소 체계를 모두 계획하세요. Element는 클라이언트이며 홈서버를 대체하지 않습니다. 홈서버 외부에 독립적인 관리자 경로와 복구 연락처를 유지하세요.
- 지원되는 Synapse 릴리스와 프로덕션에 적합한 PostgreSQL 배포를 선택하세요.
- 데이터베이스와 관리 리스너를 비공개로 유지하세요.
- 등록 및 연합 정책을 명시적으로 정의하세요.
공식 문서: Synapse 설치 · Matrix 위임
검색 및 프록시를 서비스의 일부로 구축
선택한 릴리스에 맞는 구성을 생성하고, 서명 키와 데이터베이스를 영구 저장하며, 공식 Synapse 지침에 따라 프록시를 구성하세요. 외부에 노출되는 오리진, 전달 헤더, 요청 경로가 일치해야 합니다. 위임을 사용하는 경우 아이덴티티 도메인에서 필요한 well-known 문서를 제공하세요. 프록시 오류를 해결하려고 내부 API 포트를 그대로 노출하지 마세요. 등록 시크릿을 브라우저 클라이언트 구성에 두지 마세요.
공식 문서: Synapse 리버스 프록시
클라이언트 세션과 페더레이션 세션을 테스트하세요
테스트 계정을 만들고 지원되는 클라이언트를 연결한 뒤 로컬 메시지를 보내고 작은 파일을 업로드합니다. 페더레이션 검색과 별개로 클라이언트 검색을 확인한 다음, 페더레이션이 의도된 경우 다른 허용된 서버와 함께 방을 테스트합니다. 암호화된 방에서는 검증과 클라이언트의 키 복구 흐름을 실행합니다. 홈서버 백업이 모든 클라이언트 보유 복호화 키를 자동으로 복원하지는 않습니다. 서버가 보존하는 메타데이터와 암호화된 방을 설명하세요.
# 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오류 위치를 활용해 복구 범위를 좁히세요
Element가 서버를 검색할 수 없는 경우 클라이언트 well-known 응답과 TLS 오리진을 확인하세요. 로컬 메시징은 작동하지만 연합이 실패하는 경우 연합 위임, 연결 가능한 주소, 인증서 및 정책을 확인하세요. 반복적인 미디어 실패는 업로드 제한 또는 스토리지와 관련될 수 있습니다. 데이터베이스, 미디어, 구성 및 서명 키를 일관되게 보존하세요. 연합을 비활성화한 상태에서 먼저 복원을 테스트하여 연습이 프로덕션 ID의 경쟁 사본을 생성하지 않도록 하세요.