Synapse Matrix 서버를 Cloudflare 뒤에 안전하게 배치하세요

Synapse Matrix 서버를 Cloudflare의 표준 orange-cloud 프록시 뒤에 배치하려면 클라이언트 API 및 수신 페더레이션 트래픽을 모두 443번 포트의 HTTPS를 통해 전송해야 합니다. Cloudflare에서 오리진 서버로의 TLS 연결을 Full(strict)으로 유지하고, Matrix 경로를 Synapse로 변경하지 않고 라우팅하며, 443번 포트의 호스트 이름을 가리키는 페더레이션 검색 레코드를 게시하고, API 경로의 캐시를 무시하도록 설정하십시오. 일반 프록시 레코드를 Matrix의 기본 페더레이션 포트인 8448번으로 연결하지 마십시오. Cloudflare의 표준 프록시는 해당 포트를 지원하지 않습니다.

443 설정이 서버에 적합한지 확인하십시오.

이 예제에서는 Synapse가 Nginx, Caddy 또는 Traefik과 같은 리버스 프록시 뒤에서 실행된다고 가정합니다. Synapse는 HTTP 포트 8008을 사용하는 자체 Docker 네트워크에서 유지될 수 있으며, 프런트 프록시가 공용 TLS를 처리합니다. 페더레이션은 검색에서 원격 홈 서버를 HTTPS 443으로 지정하는 경우 해당 포트를 사용할 수 있습니다. Synapse는 기본 포트 8448의 대안으로 443을 지원하지만, Cloudflare는 표준 프록시 포트 목록에 8448이 아닌 443을 포함하고 있습니다. Synapse 포트 안내 및 Cloudflare의 지원 포트 목록을 참조하십시오 .

클라이언트와 페더레이션이 프록시된 HTTPS 호스트 이름을 공유해야 하는 경우 이 방법을 사용하십시오. 페더레이션을 8448 포트에서 유지해야 하는 경우 DNS 전용 레코드 또는 해당 TCP 포트를 지원하는 Cloudflare 제품을 사용하십시오. 예제에서는 Matrix ID에 와 같은 이름을 사용하고 Synapse example.org에는 를 사용합니다 . 호스트 이름은 실제 환경에 맞게 변경하되, Synapse는 그대로 유지하십시오 . Synapse를 변경하면 사용자의 Matrix ID도 변경됩니다.@alice:example.orgmatrix.example.orgserver_name

DNS, TLS 및 리버스 프록시를 설정하십시오.

1. HTTP(S) 호스트 이름만 프록시합니다.

Cloudflare DNS에서 A/AAAA 레코드를 matrix.example.org리버스 프록시의 공용 주소로 설정하고 '프록시됨'으로 표시하세요. example.org호스트 이름은 검색 파일을 위해 웹 서버에도 연결되어야 합니다. 사용하지 않는 AAAA 레코드는 삭제하세요. MX 레코드, 메일 전용 레코드, HTTP 이외의 레코드는 'DNS 전용'으로 유지하세요. Cloudflare는 자체 네트워크 경계에서 TLS 연결을 종료하고 원본 서버와 별도의 연결을 설정합니다.

개략적인 DNS 레코드 테이블은 example.org 및 matrix.example.org에 대한 프록시된 A 레코드를 주황색 구름 모양 상태 아이콘으로 보여줍니다.
Matrix 웹 호스트와 검색에 사용되는 호스트 이름을 프록시하고, 메일 레코드는 DNS 전용으로 유지합니다.

Cloudflare SSL/TLS 설정에서 '전체(엄격)'를 선택하세요. 오리진 프록시는 443 포트에서 HTTPS 연결을 허용해야 하며, matrix.example.org신뢰할 수 있는 기관 또는 Cloudflare Origin CA에서 발급한 만료되지 않은 인증서를 제시해야 합니다. 이렇게 하면 양방향 연결이 모두 암호화되고 유효성이 검증됩니다. '유연' 모드를 사용하면 오리진 연결이 암호화되지 않거나 리디렉션 루프가 발생할 수 있습니다. Cloudflare의 전체(엄격) 설정 가이드를 참조하세요 .

2. Matrix 요청을 수정하지 않고 Synapse로 전달합니다.

역방향 프록시의 HTTPS 가상 호스트를 구성하여 일반적으로 Compose에서 개인 네트워크의 Synapse로 및 로 matrix.example.org시작하는 경로를 전달하도록 합니다 . 전체 요청 경로를 유지하고 원래 호스트를 전달하며 및 를 설정합니다 . 이러한 경로에는 클라이언트 API 호출 및 페더레이션 엔드포인트가 포함되므로 브라우저 홈페이지만 Synapse로 보내거나 경로 접두사를 잘라내지 마십시오./_matrix/_synapse/clienthttp://synapse:8008X-Forwarded-ForX-Forwarded-Proto

일반적인 리버스 프록시 구성 편집기는 8008번 포트를 통해 Synapse로 전달되는 Matrix API 경로와 X-Forwarded-Proto 헤더를 보여줍니다.
Matrix API 경로 패밀리를 모두 Synapse로 전달하고 요청 경로 및 전달 헤더를 유지합니다.

Synapse의 기존 HTTP 리스너에서 x_forwarded: true클라이언트 주소와 스키마를 프록시에서 읽도록 설정하십시오. 컨테이너화된 리스너를 `<reverse proxy>`에 바인딩하지 마십시오 127.0.0.1. 이렇게 하면 다른 컨테이너가 해당 리스너에 접근할 수 없게 됩니다. 포트 8008은 Compose에서만 사용하도록 비공개로 유지하십시오. 특정 프록시의 구문은 Synapse의 리버스 프록시 지침을 참조하십시오.

검색 결과를 게시하고 API 캐싱을 방지합니다.

3. 다른 홈서버들에게 443번 포트를 사용하도록 알려주세요.

example.orgSynapse에 접속할 때 사용자의 Matrix ID가 사용되므로 matrix.example.org, 페더레이션 검색 파일을 해당 위치에 제공하십시오 https://example.org/.well-known/matrix/server. 상태 코드 200, JSON 콘텐츠 및 다음 값을 반환하십시오.

{"m.server":"matrix.example.org:443"}

명시적으로 :443원격 홈 서버를 지원되는 프록시 포트로 보냅니다. Matrix 연합 사양은 이 m.server위임을 정의합니다. Synapse 서버 이름 자체가 인 경우 matrix.example.org, 해당 포트에서 일치하는 잘 알려진 파일을 제공하거나 serve_server_wellknown해당 호스트 이름이 443 포트의 Synapse로 라우팅될 때 Synapse의 옵션을 사용합니다.

클라이언트 자동 검색을 위해 . https://example.org/.well-known/matrix/client을 사용하여 서비스를 제공하십시오. 브라우저 클라이언트는 Matrix 클라이언트-서버 사양{"m.homeserver":{"base_url":"https://matrix.example.org"}} 에서 요구하는 CORS 헤더도 필요로 합니다 . Synapse의 를 사용자가 입력해야 하는 HTTPS URL로 설정하십시오. Matrix 서버 검색 사양 및 Synapse 구성 참조를 확인하십시오 .public_baseurl

JSON 편집기는 연합 m.server 위임 정보를 matrix.example.org의 443번 포트와 클라이언트 홈서버 기본 URL로 표시합니다.
Matrix ID 도메인에서 페더레이션 위임을 제공하고 클라이언트가 HTTPS 홈서버 URL을 가리키도록 합니다.

4. 캐시를 우회하고 프로토콜 경로에서 브라우저의 검증 절차를 회피합니다.

또는 matrix.example.org로 시작하는 경로에 대한 캐시 규칙을 생성하고 '캐시 우회'를 선택하세요 . 이렇게 하면 로그인, 동기화, 연동 및 미디어 API가 사용자 지정 캐시 규칙으로부터 보호됩니다. WAF, 봇 및 리디렉션 규칙도 확인하세요. Matrix 클라이언트는 브라우저 인터스티셜 문제를 해결할 수 없습니다. 보호 기능을 활성화한 상태로 유지하고 예외는 프로토콜 경로로 제한하세요. Cloudflare 대시 보드 지침 에서 우회 방법을 확인할 수 있습니다 ./_matrix//_synapse/client/

네트워크 외부에서 확인하세요

이러한 검사는 서버의 LAN 외부의 컴퓨터에서 실행하여 요청이 공용 DNS 및 Cloudflare를 따르도록 합니다.

터미널에 curl 명령어가 Matrix 연합의 잘 알려진 파일과 Synapse 클라이언트 버전 엔드포인트를 확인하는 내용이 표시됩니다.
Cloudflare 호스트 이름을 통해 공개 페더레이션 검색 및 클라이언트 API를 확인하세요.
curl -i https://example.org/.well-known/matrix/server
curl -i https://example.org/.well-known/matrix/client
curl -i https://matrix.example.org/_matrix/client/versions
curl -i https://matrix.example.org/_matrix/federation/v1/version

첫 번째 요청이 `<hostname>`으로 m.server설정된 JSON을 반환하는지 matrix.example.org:443, 클라이언트 파일에 HTTPS 기본 URL이 지정되어 있는지, 그리고 마지막 두 요청이 Cloudflare 챌린지 페이지, 404 또는 502 오류가 아닌 유효한 JSON을 반환하는지 확인하십시오. 그런 다음 클라이언트에서 로그인하여 룸 동기화, 파일 업로드, 다른 홈서버의 룸과의 페더레이션을 테스트하십시오. Matrix 서버는 페더레이션 검색 응답을 캐시하므로 원격 서버는 값을 변경한 후에도 한동안 이전 값을 유지할 수 있습니다. 응답의 캐시 헤더를 사용하고 캐시된 레코드가 만료될 때까지 기다리십시오.

파일 업로드가 HTTP 413 오류로 실패하는 경우, 파일 크기를 Cloudflare 영역의 현재 업로드 제한 및 Synapse의 제한과 비교하십시오 max_upload_size. 리버스 프록시에도 자체 요청 본문 제한이 있습니다. Synapse의 기본 제한은 50MB이며, Nginx의 기본 본문 제한은 이보다 낮을 수 있습니다. Cloudflare의 제한은 요금제에 따라 다르며 요금제 규칙 내에서 조정할 수 있으므로 Synapse의 제한을 높이기 전에 Cloudflare의 현재 업로드 제한 관련 문서를 확인하십시오 . API는 작동하지만 페더레이션이 실패하는 경우, 먼저 서버의 잘 알려진 URL이 공개되어 있는지, 호스트 이름 인증서가 유효한지, 위임된 포트가 명시적으로 443인지 확인하십시오. 의도적으로 8448 포트를 유지하는 경우, 표준 Cloudflare DNS 프록시를 통한 해당 레코드의 프록싱을 중지하고 DNS 전용 페더레이션 호스트 이름을 직접 사용하십시오.

댓글 남기기

Element Key 백업 및 교차 서명을 안전하게 설정하는 방법

Element Key 백업 및 교차 서명을 안전하게 설정하는 방법

복구 키를 저장하고, Element 세션을 확인하고, 암호화된 메시지 키를 백업과 계정 암호를 혼동하지 않고 복원할 수 있는지 확인하십시오.

클라이언트 동기화 중 Matrix Synapse 메모리 충돌 방지

Synapse 동기화 중 메모리 부족 오류를 진단하고, 캐싱을 안전하게 조정하고, 요청 백로그를 식별하고, 안정적인 메모리 사용을 확인합니다.

Synapse Federation TLS 인증서 오류 해결

보안 검사를 비활성화하지 않고 매트릭스 페더레이션 인증서 오류를 올바른 서버로 추적하고, TLS 체인 또는 CA 신뢰를 복구하고, 수정 사항을 확인합니다.

Synapse Matrix 서버를 Cloudflare 뒤에 안전하게 배치하세요

Synapse Matrix 서버를 Cloudflare 뒤에 안전하게 배치하세요

Cloudflare의 HTTPS 443 포트를 통해 Matrix 클라이언트와 페더레이션을 라우팅하여 Synapse 검색 기능을 유지하고 API 트래픽 캐싱이나 미디어 업로드 오류를 방지합니다.

PostgreSQL 덤프를 사용하여 Matrix Synapse를 안전하게 복원하세요

pg_dump를 사용하여 Synapse를 백업하고, 서명 키와 미디어를 보호하고, 오래된 일회용 키를 재사용하지 않고 깨끗한 PostgreSQL 데이터베이스에 복원하세요.

Docker를 사용하여 Mjölnir를 Matrix Room 관리 봇으로 실행하세요

Docker를 사용하여 Mjölnir를 Matrix Room 관리 봇으로 실행하세요

Mjölnir를 전용 Matrix 계정, 암호화된 관리실, Docker Compose, 정책 목록 및 권한 검사와 함께 설정하십시오.

모바일 로딩 속도 향상을 위해 네이티브 매트릭스 슬라이딩 동기화를 활성화하세요.

모바일 로딩 속도 향상을 위해 네이티브 매트릭스 슬라이딩 동기화를 활성화하세요.

기존 프록시를 건너뛰고 Synapse에 내장된 슬라이딩 동기화 기능을 구성하십시오. 클라이언트 검색을 확인한 다음 호환되는 전화기에서 회의실 목록 로딩 및 재연결 동작을 측정하십시오.

사용자 지정 홈서버를 사용하여 Nginx에서 Host Element Web을 운영합니다.

Element Web을 정적 사이트로 배포하고, Matrix 홈서버를 가리키도록 설정하고, HTTPS를 추가하고, Nginx를 구성하여 오래된 파일 없이 업데이트를 제공하도록 하십시오.

Raspberry Pi 4에서 경량 Matrix 홈서버 실행하기

64비트 라즈베리 파이 4에 Conduit를 설치하여 영구 데이터 저장, HTTPS 연동, 보호된 회원가입, 그리고 홈서버 작동 여부 확인 기능을 구성합니다.

사용자 지정 Matrix Room 별칭을 도메인에 설정하세요

Element 또는 Matrix API를 사용하여 권한, Synapse 명명 및 연동을 확인하고 Matrix 회의실에 도메인에서 쉽게 공유할 수 있는 주소를 부여하세요.