Jitsi Meet에서 "브리지에 연결하지 못했습니다" 오류를 해결하는 방법

Jitsi Meet 회의실을 열면 페이지는 정상적으로 로드되고 신호 전송도 제대로 작동하는 것처럼 보일 수 있지만, 미디어 연결이 이루어지지 않습니다. 대신 Jitsi는 "브리지에 연결하지 못했습니다"라는 오류 메시지를 표시하거나 회의 참여 중 연결이 끊기는 현상이 반복적으로 발생합니다. 자체 호스팅 환경에서 이러한 오류 메시지는 일반적으로 브라우저와 Jitsi Videobridge(JVB) 간 또는 Jicofo와 브리지 자체 간의 문제임을 나타냅니다 .

문제를 해결하는 가장 빠른 방법은 서버부터 순차적으로 확인하는 것입니다. 먼저 JVB가 실행 중이고 등록되어 있는지 확인하고, 미디어 포트에 접근 가능한지 확인하고, NAT/공용 IP 주소 처리 문제를 확인한 후, 클라이언트 측 네트워크 제한 사항을 조사하십시오. Jitsi 공식 자체 호스팅 가이드에서는 UDP 포트 10000을 기본 미디어 경로로 명시하고 있으며, Jicofo는 각 회의에 적합한 비디오 브리지를 선택하는 역할을 합니다.

오류가 일반적으로 의미하는 바는 다음과 같습니다.

Jitsi Meet는 여러 구성 요소로 이루어져 있습니다. 웹 인터페이스와 Prosody는 신호 처리를 담당하고, Jicofo는 회의를 조정하며, Jitsi Videobridge는 오디오 및 비디오 스트림을 전달합니다. 브라우저가 웹 페이지에 접속할 수는 있지만 JVB와의 미디어 연결에 실패하거나 Jicofo에 정상적인 브리지가 없는 경우, 회의는 브리지 단계에서 실패할 수 있습니다.

현재 Debian/Ubuntu 설치 환경에서 Jitsi는 다음과 같은 네트워크 요구 사항을 명시하고 있습니다. 인증서 유효성 검사 및 갱신을 위한 TCP 80, 웹 접속을 위한 TCP 443, 일반 오디오/비디오 전송을 위한 UDP 10000, 선택적 STUN 쿼리를 위한 UDP 3478, 그리고 UDP가 차단될 경우 coturn 기반 대체 미디어를 위한 TCP 5349입니다. 자세한 내용은 Jitsi 공식 Debian/Ubuntu 자체 호스팅 가이드를 참조하십시오. JVB의 최신 참조 구성에서도 Jitsi Videobridge 참조 구성 에 UDP 10000이 기본 ICE/UDP 포트로 표시되어 있습니다 .

1. Jitsi Videobridge가 실행 중인지 확인하십시오.

오류 메시지에 언급된 구성 요소부터 시작하세요. 일반적인 패키지 기반 설치 환경에서는 다음 명령을 실행하세요.

sudo systemctl status jitsi-videobridge2

확인해 보시려면 active (running), 장치에 오류가 발생한 경우 재시작하면 일시적으로 서비스가 복구될 수 있지만, 거기서 멈추지 말고 로그를 확인하여 오류 발생 원인을 파악하십시오.

sudo systemctl restart jitsi-videobridge2
sudo journalctl -u jitsi-videobridge2 -n 200 --no-pager

바인딩 실패, 인증 오류, XMPP 연결 실패, 반복적인 ICE 문제 또는 유효한 주소를 사용할 수 없다는 메시지가 발생하는지 확인하십시오. systemd 상태가 활성화되어 있다고 해서 JVB를 사용할 수 있다고 단정하지 마십시오. 미디어 네트워킹이나 XMPP 등록이 실패한 상태에서도 Java 프로세스가 실행 중일 수 있습니다.

2. UDP 10000 포트가 호스트 방화벽에서 수신 대기 중이고 허용되어 있는지 확인하십시오.

Jitsi의 기본 JVB 미디어 포트는 UDP 10000입니다. 먼저 서버가 수신 대기 중인지 확인하십시오.

sudo ss -lunp | grep ':10000'

수신 대기 중인 포트가 없다면 /etc/jitsi/videobridge/jvb.conf방화벽 규칙을 변경하기 전에 JVB 로그를 확인하십시오. 포트가 수신 대기 중인 경우 호스트 방화벽을 확인하십시오.

sudo ufw status verbose

UFW를 사용하는 Ubuntu 서버에서 Jitsi의 자체 가이드에서는 다음을 사용합니다.

sudo ufw allow 10000/udp
sudo ufw status verbose

UFW 대신 firewalld, nftables, iptables 또는 클라우드 방화벽을 사용하는 경우, 해당 방화벽에 상응하는 인바운드 UDP 규칙을 추가하십시오. 흔히 발생하는 실수는 Ubuntu에서 UDP 10000 포트를 열어두었지만 AWS 보안 그룹, Azure 네트워크 보안 그룹, Google Cloud VPC 방화벽, VPS 제공업체 방화벽 또는 상위 하드웨어 방화벽에서 차단된 상태로 두는 것입니다.

3. 서버가 NAT 뒤에 있는 경우 라우터 포트 포워딩을 확인하십시오.

Jitsi가 와 같은 사설 IP 주소에서 실행되는 경우 192.168.x.x, UFW를 개방하는 것만으로는 충분하지 않습니다. 엣지 라우터에서 외부 UDP 미디어 포트를 Jitsi 서버가 실행되는 머신으로 포워딩해야 합니다. 간단한 단일 서버 설치의 경우, 일반적으로 UDP 10000 포트를 Jitsi 서버의 UDP 10000 포트로 포워딩하면 됩니다.

JVB의 포트를 변경했다면, 10000번 포트를 무턱대고 열지 말고 설정된 값을 사용하십시오. 또한 다른 시스템이나 컨테이너가 해당 포트를 사용하고 있지 않은지 확인하십시오. 포트 포워딩 화면은 라우터마다 다르므로, 아래 그림은 장치의 정확한 UI 맵이 아니라 설정 예시로 간주하십시오.

4. 공용/사설 주소 매핑을 수정합니다.

NAT는 더 미묘한 오류를 일으킬 수 있습니다. 라우터가 올바른 포트를 포워딩하더라도 JVB는 인터넷 클라이언트에게 사설 IP 주소를 광고할 수 있습니다. Jitsi의 최신 빠른 시작 설명서에는 /etc/jitsi/videobridge/jvb.conf로컬 IP 주소를 공용 IP 주소로 명시적으로 변환해야 하는 시스템을 위한 정적 매핑이 나와 있습니다.

ice4j {
  harvest {
    mapping {
      static-mappings = [
        {
          local-address = "<Local.IP.Address>"
          public-address = "<Public.IP.Address>"
        }
      ]
    }
  }
}

자리 표시자를 JVB 호스트의 실제 개인 IP 주소와 원격 클라이언트가 접근할 수 있는 공용 IP 주소로 바꾸십시오. 그런 다음 JVB를 다시 시작하십시오.

sudo systemctl restart jitsi-videobridge2

이 설정은 네트워크 토폴로지와 일치하는 경우에만 사용하십시오. 공용 IP 주소를 직접 사용하는 서버, Docker 배포 환경, 여러 개의 NIC, IPv6 또는 더 복잡한 NAT 환경에서는 다른 설정이 필요할 수 있습니다. 자세한 예시는 Jitsi 빠른 시작 NAT 섹션을 참조하십시오 .

5. Docker의 경우 JVB UDP 포트가 실제로 공개되었는지 확인하십시오.

Docker 환경에서 호스트의 방화벽 규칙이 올바르게 설정되어 있더라도 JVB 컨테이너가 미디어 포트를 공개하지 않으면 문제가 해결되지 않습니다. Jitsi의 Docker 문서에서는 JVB_PORT기본값을 10000으로 명시하고 있으며, 관리자에게 호스트에서 UDP 10000 포트를 열도록 안내하고 있습니다. 실행 중인 배포 환경을 확인해 보세요.

docker compose ps
docker compose logs --tail=200 jvb

그런 다음 Compose 파일과 환경 변수를 검사하여 JVB 서비스가 의도한 UDP 포트를 노출하는지 확인하십시오. 변경 사항이 있는 경우 호스트 매핑, 방화벽 규칙 및 NAT 포워딩이 모두 일치해야 합니다. 타사 튜토리얼에서 가져온 오래된 Compose 코드 조각을 복사하는 대신 Jitsi Docker 자체 호스팅 가이드를JVB_PORT 참조하십시오 .

6. Jicofo가 비디오브리지를 인식하는지 확인하십시오.

JVB가 XMPP 제어 평면에 등록되지 않으면 완벽하게 접근 가능한 UDP 포트만으로는 충분하지 않습니다. Jicofo는 화상 회의를 위해 비디오 브리지를 선택하며, Jitsi의 확장 가능한 배포 가이드에서는 서비스를 재시작한 후 Prosody와 Jicofo 로그를 모두 확인하여 브리지가 연결되고 선택되었는지 확인하도록 권장합니다.

sudo journalctl -u jicofo -n 200 --no-pager
sudo journalctl -u prosody -n 200 --no-pager
sudo journalctl -u jitsi-videobridge2 -n 200 --no-pager

XMPP 도메인을 사용자 지정했거나 여러 노드를 실행하는 경우 Jicofo와 JVB가 동일한 브리지 "brewery" MUC를 사용하는지 확인하십시오. Jitsi Videobridge MUC 공식 문서에 따르면 Jicofo는 jicofo.bridge.brewery-jidVideobridge 인스턴스에서 사용하는 것과 동일한 MUC를 가리켜야 합니다.

이는 호스트 이름 변경, 마이그레이션, 분할 호스트 배포 또는 수동 구성 편집 후에 특히 중요합니다. 공식 설치 프로그램을 사용하여 생성된 표준 패키지 설치의 경우, 로그에 등록 또는 인증 문제가 실제로 나타나지 않는 한 XMPP 구성을 다시 작성하지 마십시오.

7. 클라이언트 네트워크, VPN 또는 프록시의 제한적인 설정을 배제하십시오.

서버가 일부 사용자에게는 정상적으로 작동하지만 다른 사용자에게는 작동하지 않는 경우, 서버 구성을 변경하기 전에 다른 네트워크에서 테스트해 보세요. 회사 네트워크, 게스트 Wi-Fi, VPN 및 엄격한 프록시는 UDP를 차단할 수 있습니다. VPN 또는 프록시 연결을 일시적으로 해제하는 것은 유용한 진단 테스트이며, 조직에서 요구하는 경우 테스트 후 다시 연결하세요.

Jitsi의 Debian/Ubuntu 가이드에서는 UDP가 차단되었을 때 오디오/비디오 전송을 위한 coturn 대체 경로로 TCP 5349 포트를 사용한다고 명시하고 있습니다. 네트워크 접근이 제한된 사용자가 안정적으로 연결할 수 있도록 하려면, 웹사이트에 TCP 443 포트를 열어주는 것만으로 미디어 대체 경로가 자동으로 제공된다고 가정하기보다는 TURN/coturn 설정을 확인해야 합니다.

8. 서버 검사가 통과된 후에만 깨끗한 브라우저 세션으로 다시 시도하십시오.

모든 참가자가 동일한 브리지 오류를 보는 경우, 브라우저 세션이 만료되었을 가능성은 JVB 경로 오류일 가능성보다 낮지만, 이 문제는 빠르게 해결할 수 있습니다. 회의실을 새로고침하거나, 개인 정보 보호 모드 창을 사용하거나, 인증이 활성화된 경우 Jitsi 도메인의 사이트 데이터를 삭제한 후 다시 로그인해 보세요.

오류가 여러 브라우저와 네트워크에서 재현되는 경우, 브라우저 데이터를 반복적으로 삭제하는 대신 서버 측 검사로 돌아가십시오.

해결책이 실제로 효과가 있었는지 확인하는 방법

오류 팝업이 사라졌다고 해서 문제가 해결되었다고 생각하지 마십시오. 전체 미디어 경로를 테스트하십시오.

• 새 방을 만들고 두 대의 기기에서 접속하세요.
• 가능하다면 기기들을 서로 다른 네트워크에 연결하세요. 예를 들어 하나는 가정용 광대역 네트워크에, 다른 하나는 모바일 데이터에 연결하는 식입니다.
• 오디오와 비디오가 양방향으로 몇 분 동안 정상적으로 흐르는지 확인하십시오.
• 회의에 참여하는 동안 JVB 및 Jicofo 로그를 모니터링하고 ICE 또는 브리지 상태 오류가 반복적으로 발생하지 않고 회의가 브리지에 할당되었는지 확인하십시오.
• sudo ss -lunp | grep ':10000'재부팅 또는 방화벽 설정 변경 후에는 방화벽 상태 점검을 다시 실행하십시오 .

멀티 브리지 설치의 경우, 여러 개의 회의를 테스트해 보세요. Jitsi의 확장 가능한 설정 가이드에 따르면 Jicofo는 새로운 회의에 대해 비디오 브리지를 선택하므로, 하나의 브리지에 문제가 발생하면 다른 브리지가 정상적으로 작동하더라도 간헐적인 오류가 발생할 수 있습니다.

빠른 진단표

결론적으로

자체 호스팅 Jitsi Meet 서버에서 "브리지에 연결하지 못했습니다" 오류가 발생하는 경우, 미디어 경로 또는 브리지 등록 문제일 가능성이 높으므로 먼저 Jitsi Videobridge가 정상인지, UDP 10000 포트가 모든 방화벽/NAT 계층을 통과하여 수신 대기 중인지, NAT 환경에서 Jitsi Videobridge가 사용 가능한 공용 IP 주소를 광고하는지, 그리고 Jicofo가 브리지를 인식하는지 확인하십시오. 이러한 사항들을 모두 확인한 후에야 브라우저 캐시 또는 개별 클라이언트 설정을 점검하십시오.

정확한 해결 방법은 네트워크 토폴로지에 따라 다르므로, 과거 포럼 게시물에 있다고 해서 오래된 Jitsi 구성 키를 적용하지 마십시오. 위의 명령 및 설정은 2026년 10월 기준으로 최신 Jitsi 공식 핸드북 및 Jitsi Videobridge 구성 소스를 기준으로 작성되었습니다.