모바일 로딩 속도 향상을 위한 매트릭스 슬라이딩 동기화 설정 방법 (기존 프록시 사용 안 함)

2026년 10월 6일 업데이트: 독립형 Matrix Sliding Sync 프록시는 더 이상 설치해야 할 올바른 구성 요소가 아닙니다. Matrix.org는 matrix-org/sliding-sync이전 버전인 MSC3575 API를 구현했기 때문에 2025년 11월에 해당 저장소를 보관 처리했습니다. MSC3575 API는 간소화된 슬라이딩 동기화(MSC4186)로 대체되었습니다. Synapse는 버전 1.114부터 네이티브 구현을 지원하며 기본적으로 지원이 활성화되어 있습니다. 2026년 7월, Matrix Spec Core Team은 핵심 MSC4186 제안을 승인했으며, 관련 확장 제안은 별도의 작업으로 진행됩니다.

최신 Synapse 모바일 배포를 위한 실질적인 설정은 최신 Synapse 릴리스를 실행하고, 네이티브 슬라이딩 동기화 기능을 지원하는지 확인하고, 리버스 프록시가 Matrix 클라이언트 API 경로를 변경 없이 그대로 전달하는지 확인하고, 호환되는 모바일 클라이언트를 사용하는 것입니다. 별도의 프록시 컨테이너, 프록시 데이터베이스 및 기존 프록시 검색 URL은 필요하지 않습니다.

슬라이딩 싱크 프록시를 독립형으로 설치해야 할까요?

아니요, 현재 Matrix 모바일 클라이언트를 위한 새로운 배포에는 사용할 수 없습니다. 아카이브된 프록시는 최신 네이티브 MSC4186 플로우가 아닌 MSC3575를 구현합니다. 해당 프로젝트의 저장소에서도 더 이상 유지 관리되지 않으며 최신 Matrix 클라이언트에서 더 이상 작동하지 않을 것으로 예상된다고 명시하고 있습니다. Matrix.org는 또한 2025년 1월에 Element X에서 MSC3575 프록시 지원을 제거하고 네이티브 지원으로 전환할 것이라고 발표했습니다.

이전 프록시 가이드는 오래된 설치를 식별하는 데 여전히 유용할 수 있습니다. 해당 가이드에서는 PostgreSQL, 영구 비밀 키 및 SYNCV3_*환경 설정을 사용했습니다. 이러한 지침은 더 이상 사용되지 않는 아키텍처를 설명합니다. 오래된 튜토리얼에서 더 빠르다고 하더라도 해당 가이드를 새 서버에 복사하거나 레거시 프록시를 공개적으로 노출하지 마십시오.

무엇이 바뀌었고, 모바일 사용자에게는 어떤 의미가 있을까요?

이전의 프록시는 클라이언트와 홈서버 사이에 위치하는 별도의 서비스였습니다. 간소화된 슬라이딩 동기화는 Synapse 자체에 구현되어 있습니다. 이를 통해 호환되는 클라이언트는 사용자의 채팅방 목록에서 관련 창을 요청하고 점진적으로 업데이트할 수 있으므로, 모바일 앱이 대규모 계정을 열거나 다시 접속할 때 수행해야 하는 동기화 작업량을 줄일 수 있습니다.

이는 동기화 개선일 뿐, 모든 화면이 즉시 로드된다는 보장은 아닙니다. 느린 미디어 서버, 원격 회의실 참가 지연, 약한 모바일 신호, 과부하된 데이터베이스 등의 문제를 해결해주지는 않습니다. 모바일 앱은 MSC4186을 지원해야 하며, 홈 서버는 이를 알리고 있어야 합니다. Matrix.org의 발표에 따르면, 네이티브 Synapse 구현은 기존 프록시의 별도 데이터 저장소와 초기 전체 동기화 제한 문제를 해결합니다.

활성화하기 전에 무엇이 필요합니까?

Synapse가 실행되는 Matrix 홈서버입니다. 이 가이드는 Dendrite, Conduit 또는 다른 홈서버가 동일한 네이티브 구현을 제공한다고 가정하지 않습니다.
유지 관리되는 Synapse 릴리스입니다. 버전 1.114에서 MSC4186에 대한 네이티브 지원이 도입되었지만, 1.114를 보안 또는 유지 관리 권장 사항으로 간주하기보다는 현재 지원되는 릴리스를 사용하십시오.
간소화된 슬라이딩 동기화를 지원하는 모바일 클라이언트입니다. 성능이 뛰어난 홈서버는 구형 클라이언트가 자신이 구현하지 않은 API를 사용하도록 강요할 수 없습니다.
홈서버용 HTTPS 클라이언트 엔드포인트 및 리버스 프록시 구성이 정상적으로 작동합니다.
서버 업그레이드 또는 라우팅 변경 전에 최근 데이터베이스 및 구성 백업을 수행하세요.

Synapse에서 이미 네이티브 슬라이딩 동기화 기능을 지원하는지 어떻게 확인할 수 있나요?

터미널에서 공개 클라이언트-서버 API 버전 엔드포인트를 조회합니다. 예시 호스트를 Matrix 클라이언트에서 사용하는 공개 기본 URL로 바꾸세요.

curl -fsS https://matrix.example.org/_matrix/client/versions   | jq -r '.unstable_features["org.matrix.simplified_msc3575"]'

응답이 이면 true서버에서 기본 제공되는 간소화된 슬라이딩 동기화 기능 플래그를 알리는 것입니다. 응답이 false, null, 또는 키가 누락된 경우 클라이언트를 테스트하기 전에 Synapse 버전과 구성을 확인해야 합니다. Synapse가 jq설치되어 있지 않으면 브라우저에서 동일한 URL에 접속하거나 Synapse를 실행하여 curl -fsS https://matrix.example.org/_matrix/client/versionsJSON 응답을 검사하십시오.

이 플래그는 서버의 기능 신호이며, 특정 앱 릴리스의 호환성이나 모든 리버스 프록시 경로의 정확성을 보장하는 것은 아닙니다. 슬라이딩 동기화(Sliding Sync)를 기본적으로 지원하는 클라이언트를 사용하고, 해당 클라이언트의 로그 또는 브라우저/네트워크 진단 도구에서 요청 경로를 확인하십시오.

Synapse에서 네이티브 지원을 활성화하는 방법은 무엇입니까?

Synapse 1.114 이상 버전에서는 기본적으로 네이티브 슬라이딩 동기화가 활성화되어 있습니다. 버전 확인 응답이 이미 활성화되어 있는 경우 true, 일반적으로 별도의 서비스를 설치하거나 새로운 동기화 데이터베이스를 생성할 필요가 없습니다. 이전 버전 가이드에 프록시에 대한 설명이 있다는 이유만으로 불필요한 구성을 추가하지 마십시오.

Synapse 구성에서 해당 기능이 명시적으로 비활성화된 경우, 설정 항목을 검토하십시오 experimental_features. 문서화된 플래그를 사용하는 릴리스의 경우 관련 YAML은 다음과 같습니다.

experimental_features:
  msc3575_enabled: true

설치된 Synapse 버전의 구성 문서를 확인한 후에만 이 설정을 추가하거나 변경하십시오. homeserver.yaml기존 experimental_features블록의 나머지 부분을 백업하고 YAML 들여쓰기를 일관되게 유지하십시오. Synapse의 구성 유효성 검사 명령을 사용하여 파일의 유효성을 검사한 다음, 기존에 사용 중인 서비스 관리자 또는 컨테이너 오케스트레이션 방법을 통해 Synapse를 다시 시작하십시오. /_matrix/client/versions그 후 다시 확인하십시오.

1.114 이전 버전을 사용 중인 경우 공식 업그레이드 지침에 따라 Synapse 업그레이드를 계획하십시오. 중간 릴리스 노트를 읽고 데이터베이스 및 미디어/구성 파일을 백업한 다음 배포 환경에 맞는 지원되는 업그레이드 경로를 따르십시오. 홈 서버 업그레이드, 리버스 프록시 재작성 및 기존 프록시 제거를 검증되지 않은 하나의 변경 사항으로 결합하지 마십시오.

리버스 프록시에 특별한 슬라이딩 동기화 경로가 필요합니까?

일반적으로는 그렇지 않습니다. 네이티브 슬라이딩 동기화는 Matrix 클라이언트-서버 API 경로를 사용하므로 /_matrix/client기존 리버스 프록시는 Matrix 클라이언트 API 네임스페이스를 Synapse로 전달해야 합니다. Synapse 공식 리버스 프록시 가이드에서는 요청 URI를 정규화하거나 표준화하지 않고 그대로 유지하면서 전달하도록 권장 /_matrix합니다 /_synapse/client.

/_matrix/client/versionsSynapse는 정상적으로 작동하지만 호환되는 앱이 동기화되지 않는 경우 프록시 규칙을 확인하십시오 . 요청이 /_matrix/client/unstable/org.matrix.simplified_msc3575/Synapse에 도달하는지, 아니면 MSC3575 프록시를 거치거나 웹 애플리케이션 방화벽에 의해 차단되거나 경로 규칙에 의해 재작성되지 않았는지 확인하십시오. Synapse가 프록시 뒤에서 실행되는 경우 Synapse 설명서에 나와 있는 올바른 forwarded-protocol 및 client-IP 헤더를 유지하십시오.

org.matrix.msc3575.proxy네이티브 지원을 위해 새 항목을 생성하지 마십시오 /.well-known/matrix/client. 해당 키는 더 이상 사용되지 않는 프록시 API를 나타냅니다. 이전에 정적 JSON 파일이나 Synapse에 해당 키를 추가한 경우 extra_well_known_client_content, 필요한 이전 클라이언트가 해당 키에 의존하지 않는지 확인한 후 레거시 프록시 속성만 제거하십시오. 일반 홈서버 검색 정보는 그대로 유지하십시오.

기존 프록시 설치를 어떻게 마이그레이션해야 할까요?

현재 Synapse 버전, 클라이언트 버전, 프록시 URL, 리버스 프록시 경로, 그리고 이전 프록시의 데이터베이스 및 비밀 위치를 기록해 두십시오.
홈서버 데이터베이스, 설정 파일, 프록시 데이터베이스를 백업하십시오. 네이티브 클라이언트 로그인 및 동기화가 확인될 때까지 해당 백업 파일을 보관하십시오.
Synapse 버전이 1.114보다 이전 버전인 경우, 문서화된 릴리스 경로를 통해 Synapse를 업그레이드한 다음 네이티브 기능 플래그가 반환되는지 확인하십시오 true.
모바일 클라이언트를 간소화된 슬라이딩 동기화를 기본적으로 지원하는 버전으로 업데이트하세요. 앱 내에서 마이그레이션 또는 재로그인 안내 메시지가 나타나면 따르세요. 기존 세션의 경우 이전 프로토콜에서 새 프로토콜로 전환하기 위해 다시 로그인해야 할 수 있습니다.
사용 중지된 프록시 광고를 제거하고 Matrix 클라이언트 API 경로를 Synapse로 라우팅하십시오. 리버스 프록시를 다시 로드하고 적용하기 전에 구성을 확인하십시오.
먼저 계정 하나와 모바일 기기 하나로 테스트해 보세요. 로그인, 방 목록 로딩, 암호화된 방 열기, 메시지 송수신, 네트워크 전환 후 재접속 등이 정상적으로 작동하는지 확인하십시오.
지원하는 클라이언트에 대한 테스트가 성공적으로 완료되면 기존 프록시를 중지하십시오. 합의된 롤백 기간 동안 데이터베이스 백업을 보관하고, 더 이상 필요하지 않음을 확인한 후에만 오래된 데이터를 삭제하십시오.

프록시 데이터베이스는 Synapse의 회의실 기록을 대체하는 대신 프록시 측 동기화 상태를 저장합니다. 하지만 초기 마이그레이션 과정에서 해당 데이터베이스를 삭제하지 않는 것이 좋습니다. 기존 설정 문제를 해결하는 데 참고 자료를 제공하고 사용자가 네이티브 세션으로 전환하는 동안 더 안전한 롤백 경계를 제공하기 때문입니다.

모바일 로딩 속도가 개선되었는지 어떻게 알 수 있나요?

신뢰할 수 있는 기준 측정값이 있다면 변경 전후의 동일한 클라이언트, 계정, 기기 및 네트워크를 비교하세요. 앱을 실행한 후 사용 가능한 회의실 목록이 나타날 때까지 걸리는 시간, 최근 메시지가 로딩 시간 없이 표시되는지 여부, 그리고 짧은 오프라인 상태 후 앱이 정상적으로 작동하는지 여부를 기록하세요. 비교는 여러 번 반복해야 합니다. 한 번의 실행으로는 캐시 상태, 네트워크 환경 또는 대용량 미디어 다운로드 등의 요인으로 결과가 왜곡될 수 있습니다.

클라이언트가 여전히 일반 /sync요청을 수행하고 네이티브 지원을 알리거나 시도하지 않는 경우 클라이언트 버전과 자체 동기화 설정을 확인하십시오. 간소화된 엔드포인트를 요청했지만 오류가 발생하는 경우 해당 요청에 대한 Synapse 및 리버스 프록시 로그를 검사하십시오. 많은 사용자가 로딩 속도가 느리다고 보고하는 경우 데이터베이스 상태와 서버 부하를 확인하십시오. 슬라이딩 동기화는 동기화 작업을 줄일 수 있지만 데이터베이스 과부하 또는 잘못된 API 요청 라우팅 문제를 해결할 수는 없습니다.

주요 설정 옵션은 무엇인가요?

접근하다	가장 적합한	비용 또는 제한
Synapse에서 기본적으로 간소화된 슬라이딩 동기화 기능	신규 또는 유지 관리되는 Synapse 배포 및 호환 클라이언트	호환되는 클라이언트가 필요하며, 성능은 서버 및 데이터베이스 상태에 따라 달라집니다.
레거시 MSC3575 프록시	기존 테스트 설정을 이해하거나 일시적으로 유지하기 위한 용도로만 사용하십시오.	보관되어 있고, 유지 관리되지 않으며, 더 이상 최신 클라이언트와 호환되지 않습니다.
레거시 매트릭스 동기화	슬라이딩 싱크를 기본적으로 지원하지 않는 클라이언트 또는 홈 서버	호환되는 클라이언트에서는 계속 작동하지만, 기존의 슬라이딩 룸 목록 기능은 제공하지 않습니다.

출처 및 버전 정보

독립 실행형 프록시 저장소는 보관 처리되었습니다. Synapse의 기본 구현은 Synapse 1.114 버전부터 제공됩니다. Matrix 사양 핵심 팀은 2026년 7월에 핵심 MSC4186 제안을 승인했으며, 관련 확장 기능은 별도로 유지됩니다. Synapse, 모바일 클라이언트 및 Matrix 사양은 계속 발전하고 있으므로 사용 중인 정확한 버전에 대한 문서 및 릴리스 노트를 확인하십시오.