안정적인 Matrix 음성 및 영상 통화를 위해 coturn을 설정하세요.

참가자들이 서로 다른 네트워크에 있을 때 Matrix 통화가 실패하는 경우, 공용 IP 주소를 가진 호스트에 coturn을 배포하고, 시간 제한이 있는 TURN REST 자격 증명을 활성화한 다음, Synapse를 동일한 공유 비밀 키와 TURN URI로 구성하십시오. 그런 다음 모든 방화벽에서 TURN 리스너와 UDP 릴레이 범위를 허용하십시오. STUN은 클라이언트가 네트워크 경로를 검색하는 데 도움을 줄 수 있지만, 직접 경로를 설정할 수 없을 때 미디어를 전송하는 것은 TURN입니다.

이 설정은 자체 호스팅 Synapse 홈서버와 고정 공용 IPv4 주소를 가진 별도의 Debian 또는 Ubuntu TURN 호스트에 적합합니다. 예제에서는 coturn의 기본 수신 포트인 3478과 기본 UDP 릴레이 범위인 49152~65535를 사용합니다. 예제의 도메인, 비밀 키 및 경로는 사용자 환경에 맞게 변경하십시오. coturn이 NAT 뒤에 있는 경우 아래의 NAT 관련 참고 사항을 참조하십시오. 직접 연결 가능한 공용 호스트를 사용하는 것이 더 간단하고 안정적입니다.

1. TURN 호스트 이름을 서버로 지정합니다.

coturn 호스트의 공용 IPv4 주소를 가리키는 DNS A 레코드를 생성하십시오 turn.example.com. 네트워크 및 인증서 설정을 Matrix 웹 서비스와 별도로 관리할 수 있도록 전용 호스트 이름을 사용하십시오. coturn에 IPv6 연결이 제대로 작동하고 해당 방화벽 규칙이 설정되어 있지 않으면 AAAA 레코드를 게시하지 마십시오. 연결할 수 없는 IPv6 주소로 인해 일부 클라이언트가 실패하는 경로를 선택할 수 있습니다.

Synapse의 최신 TURN 문서에 따르면 TURN 서비스에는 공용 IP 엔드포인트가 필요합니다. NAT는 게이트웨이가 공용 주소를 가지고 있고 필요한 포트를 올바르게 포워딩하는 경우에만 작동할 수 있으며, 문서에서는 NAT 설정이 여전히 불안정할 수 있다고 경고합니다. Synapse TURN 설정 문서를 참조하십시오 .

2. coturn을 설치하고 인증된 릴레이를 구성합니다.

데비안 또는 우분투에서 배포 패키지를 설치하세요.

sudo apt update
sudo apt install coturn

/etc/turnserver.conf편집기로 파일을 열고 아래의 필수 설정을 구성하십시오. 암호 관리자 또는 암호학적으로 안전한 생성기를 사용하여 길고 무작위적인 비밀 키를 생성하십시오. 나중에 Synapse에 해당 비밀 키를 정확히 입력하십시오. Matrix 사용자 암호를 재사용하거나 공개 저장소에 비밀 키를 노출하지 마십시오.

listening-port=3478
fingerprint
use-auth-secret
static-auth-secret=REPLACE_WITH_A_LONG_RANDOM_SECRET
realm=turn.example.com
server-name=turn.example.com
min-port=49152
max-port=65535

use-auth-secretstatic-auth-secretSynapse에서 임시 자격 증명을 발급하는 데 사용하는 TURN REST 자격 증명 메커니즘을 활성화하십시오. ` < realmdomain name>`은 TURN 서비스의 도메인 이름이어야 합니다. 릴레이 포트 범위는 리스너와 별개입니다. 클라이언트는 포트 3478에 접속하여 할당을 요청하고, 미디어는 할당된 릴레이 포트를 사용합니다. coturn 예제 구성 문서에는 리스너, 릴레이, TLS 및 외부 IP 옵션이 나와 있으며, 배포 패키지의 기본값과 경로는 다를 수 있습니다.

서비스를 활성화하고 시작한 다음 상태를 확인하십시오.

sudo systemctl enable --now coturn
sudo systemctl status coturn

패키지에 별도의 활성화 플래그가 있는 경우 /etc/default/coturn, 서비스를 시작하기 전에 해당 파일의 지침을 따르십시오. sudo journalctl -u coturn -e서비스가 시작되지 않으면 로그를 확인하십시오.

3. 리스너 및 릴레이 트래픽 허용

호스트 방화벽 및 공급자 수준 방화벽에서 3478번 포트의 인바운드 UDP 및 TCP 트래픽과 49152~65535번 UDP 포트의 인바운드 트래픽을 허용하십시오. 예를 들어 UFW를 사용하는 경우 다음과 같습니다.

sudo ufw allow 3478/udp
sudo ufw allow 3478/tcp
sudo ufw allow 49152:65535/udp
sudo ufw status

릴레이 범위는 배포 환경에서 지원하는 범위 내에서 최대한 좁게 유지하고, coturn의 범위 min-port와 max-port방화벽 범위를 일치시키십시오. TLS 리스너를 활성화하는 경우, 구성된 포트도 열고 일치하는 turns:URI 및 인증서 설정을 사용하십시오. 이 기본 예제에서는 TURN 연결에 TLS를 사용하는 것은 선택 사항입니다. Synapse 설명서에 따르면 TURN이 일반 UDP/TCP 리스너를 사용하는 경우에도 WebRTC 음성 및 비디오 미디어는 암호화된 상태로 유지되며, 신호 보안은 Matrix HTTPS 설정에 따라 달라집니다.

NAT 뒤에 있는 호스트의 경우, coturn의 external-ip=PUBLIC_IP/PRIVATE_IP매핑을 구성하고 외부 릴레이 포트 번호를 변경하지 않고 포트 3478과 전체 릴레이 범위를 coturn 호스트로 포워딩해야 합니다. 예를 들어, 공용 릴레이 포트 52000은 내부 포트 52000에 도달해야 합니다. Synapse의 안내에 따르면 NAT로 인해 여전히 문제가 발생할 수 있으며, 광범위한 UDP 범위를 포워딩할 수 없는 경우 공용 IP VPS에 coturn을 설치하는 것이 일반적으로 더 실용적인 선택입니다.

4. Synapse를 coturn에 연결합니다.

일반적으로 `.`인 활성 Synapse 구성 파일에 다음 설정을 추가하십시오 homeserver.yaml. 호스트 이름, 포트 및 비밀 키는 coturn 구성과 일치해야 합니다.

turn_uris:
  - "turn:turn.example.com:3478?transport=udp"
  - "turn:turn.example.com:3478?transport=tcp"
turn_shared_secret: "REPLACE_WITH_A_LONG_RANDOM_SECRET"
turn_user_lifetime: 86400000
turn_allow_guests: false

유효 기간은 밀리초 단위입니다. 이 예시에서는 Synapse에 24시간 동안 유효한 자격 증명을 발급하도록 요청합니다. 게스트 액세스는 등록 정책에 따라 설정하십시오. 등록된 사용자의 통화를 활성화하는 데에는 게스트 액세스 설정이 필수는 아닙니다. turn_shared_secret설정은 coturn의 설정과 동일하게 유지하고 비공개로 유지 static-auth-secret하십시오. TURN 프로토콜을 대체하는 URI를 추가하지 마십시오 stun:. 두 프로토콜은 관련은 있지만 서로 다른 역할을 수행합니다.

YAML 구문 유효성 검사를 완료한 후 Synapse를 다시 시작하십시오.

sudo systemctl restart matrix-synapse.service
sudo systemctl status matrix-synapse.service

컨테이너 배포 시에는 마운트된 Synapse 구성을 업데이트하고 Synapse 컨테이너를 재시작해야 합니다. 클라이언트는 서버 구성을 다시 로드하거나 새로 고쳐야 할 수 있으며, Synapse는 클라이언트가 TURN 설정을 새로 고치는 데 최대 약 1시간이 소요될 수 있음을 알려드립니다.

릴레이 후보를 검증합니다

TURN 서버와 다른 네트워크에 있는 브라우저 또는 장치(예: 셀룰러 데이터를 사용하는 휴대폰)에서 테스트하십시오. 브라우저 기반 Matrix 클라이언트에서 인증된 홈서버 요청을 검사하십시오 /_matrix/client/v3/voip/turnServer(이전 클라이언트는 레거시 /r0/경로를 사용할 수 있습니다). 응답에는 TURN URI와 임시 사용자 이름/암호 필드가 포함되어야 합니다. Matrix 사양은 이 엔드포인트의 자격 증명 응답을 정의합니다.

해당 자격 증명을 사용하여 공식 WebRTC Trickle ICE 테스트를 실행하고, 와 같은 서버를 입력한 다음 turn:turn.example.com:3478?transport=udp, 페이지에서 후보 유형 필터링 기능을 제공하는 경우 릴레이 테스트를 선택하십시오. 성공적인 결과에는 유형이 인 후보가 포함됩니다 relay. 마지막으로, 서로 다른 네트워크에 있는 장치 간에 Matrix 통화를 시도하십시오. 통화는 연결되지만 "연결 중" 상태로 유지되는 경우, 릴레이 포트 차단, 잘못된 NAT 매핑 또는 자격 증명 불일치가 원인일 수 있습니다. 관련 없는 통화 설정을 변경하기 전에 coturn 로그와 Synapse의 TURN 문제 해결 참고 사항을 확인하십시오.

브라우저 진단을 위해 Synapse는 chrome://webrtc-internals/Chrome과 Firefox에서 실행을 권장합니다. 릴레이 후보가 나타나지 않으면 먼저 비밀 키가 정확히 일치하는지 확인한 다음 호스트 및 공급자 방화벽 모두에서 UDP 3478 포트와 전체 릴레이 범위를 확인하십시오. coturn 프로젝트는 turnserver 참조about:webrtc 문서에서 포트 및 외부 IP 옵션에 대한 정보를 제공합니다 .

댓글 남기기

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

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

안정적인 Matrix 음성 및 영상 통화를 위해 coturn을 설정하세요.

coturn과 Synapse를 일치하는 TURN 자격 증명으로 구성하고, 필요한 릴레이 포트를 열고, Matrix 클라이언트가 릴레이 후보를 가져올 수 있는지 확인합니다.

Docker Compose 및 PostgreSQL을 사용하여 Matrix Synapse를 배포하세요.

Docker Compose 및 PostgreSQL을 사용하여 Matrix Synapse를 배포하세요.

Docker Compose, PostgreSQL, 비공개 설정 파일, 그리고 HTTPS를 통해 노출하기 전에 필요한 검사 기능을 사용하여 Synapse 홈 서버를 영구적으로 설정합니다.

Element Web의 테마와 브랜딩을 맞춤 설정하세요

Element 웹 배포에 브랜드 이름, 사용자 지정 색상 및 로그인 자산을 설정하는 동시에 Element 브랜드로 유지되는 부분을 파악하세요.

추측 없이 Synapse의 Systemd 파일 제한을 늘리는 방법

추측 없이 Synapse의 Systemd 파일 제한을 늘리는 방법

Synapse가 프로세스별 파일 열기 제한에 도달했는지 진단하고, 해당 서비스 또는 워커에 대한 systemd 드롭인을 설정하고, 실제 제한을 확인합니다.

요소에 "복호화 실패" 오류가 표시되나요? 누락된 룸 키를 복구하세요.

요소에 "복호화 실패" 오류가 표시되나요? 누락된 룸 키를 복구하세요.

오류가 특정 브라우저 또는 특정 이벤트에만 국한되는지 확인한 다음, Element의 복구 키 또는 신뢰할 수 있는 장치를 사용하여 암호화된 나머지 기록을 손상시키지 않고 복구할 수 있습니다.

데이터 손실 없이 오래된 Synapse 메시지와 미디어를 정리하세요

Synapse의 기록 및 미디어 삭제 API 또는 보존 설정을 사용하여 오래된 데이터를 안전하게 제거한 다음 완료 여부와 디스크 공간 복구를 확인하십시오.

Simple-Matrix-Bot-Lib을 사용하여 Python으로 Matrix Echo Bot을 구축하세요.

Simple-Matrix-Bot-Lib을 사용하여 Python으로 Matrix Echo Bot을 구축하세요.

최신 라이브러리를 설치하고, 전용 Matrix 계정을 연결한 다음, 더욱 안전한 자격 증명 처리와 명확한 테스트를 포함하는 간단한 !echo 봇을 실행하세요.

Matrix를 WhatsApp, Telegram, Discord에 각각 별도의 브리지로 연결하세요.

Matrix를 WhatsApp, Telegram, Discord에 각각 별도의 브리지로 연결하세요.

등록, 로그인 및 테스트가 각각 다른 세 개의 Mautrix 브리지를 설정하여 Docker 네트워킹, 계정 정책 및 동기화 관련 예상치 못한 문제를 방지하세요.

공유 파일을 손상시키지 않고 Synapse 미디어 디스크 공간을 확보하세요

Synapse 저장소를 채우는 항목을 찾고, 안전한 미디어 보존 설정을 지정하고, 디스크에서 파일을 직접 삭제하지 않고 원격 캐시를 정리하세요.