BigBlueButton 웹캠 로딩 오류 해결: ICE 소켓 연결 실패

BigBlueButton 웹캠 화면이 나오지 않고 브라우저나 회의에서 "ICE 소켓 연결 실패"라는 메시지가 표시되면 미디어 연결 실패를 나타내는 것이지만, 모든 경우에 공통적으로 발생하는 원인은 아닙니다. 카메라 권한, 사용자 네트워크 환경, 서버 방화벽, NAT 주소 지정, TURN 릴레이 설정 등 여러 요인이 문제의 원인이 될 수 있습니다. 서버 설정을 변경하기 전에 먼저 문제의 원인을 파악하는 점검부터 시작하십시오.

BigBlueButton의 최신 문제 해결 가이드에서는 관련 오류인 1007: ICE 협상 실패를 브라우저와 미디어 서버 간의 경로 협상 실패로 설명합니다. NAT, 차단된 UDP 포트, 그리고 제한적인 네트워크 환경에서 TURN 설정을 활성화해야 할 필요성 등이 언급됩니다. 브라우저에 표시되는 정확한 문구는 BigBlueButton 버전, 호스팅 플랫폼 또는 클라이언트에 따라 다를 수 있습니다. 이는 진단이 아닌 단서로 간주하십시오. BigBlueButton 4.0 문제 해결 가이드를 참조하십시오 .

먼저 카메라에 문제가 있는지 아니면 연결에 문제가 있는지 확인하십시오.

브라우저가 웹캠에 접근하려면 카메라 권한이 필요하며, 회의 페이지는 HTTPS와 같은 보안 컨텍스트를 사용해야 합니다. 이러한 검사를 통해 브라우저가 로컬 비디오를 캡처할 수 있는지 여부가 결정됩니다. ICE는 브라우저와 BigBlueButton 간에 미디어를 전송하기 위한 네트워크 경로를 찾는 WebRTC 프로세스입니다. 카메라 권한 거부와 ICE 경로 실패는 서로 다른 문제이지만, 둘 다 웹캠을 사용할 수 없게 만들 수 있습니다. MDN 문서에서 브라우저 권한 및 보안 컨텍스트 요구 사항을 확인할 수 있습니다 .

주소 표시줄 옆의 카메라 아이콘과 브라우저의 사이트 설정을 확인하세요. BigBlueButton 사이트에 카메라 접근 권한을 허용하고, 원하는 카메라가 선택되었는지 확인한 후, 카메라를 사용 중인 다른 앱이 있으면 모두 종료하세요. 브라우저에 로컬 미리보기가 표시되지만 회의에서 영상 게시가 여전히 되지 않는다면, 로컬 기기 접근 권한은 정상적으로 작동하는 것일 수 있으므로 네트워크 점검을 진행하세요. 미리보기가 전혀 표시되지 않으면 기기 선택, 운영체제 개인정보 보호 설정 또는 브라우저 권한 문제를 먼저 해결하세요.

다음 참가자 확인 절차를 순서대로 진행해 보세요.

페이지를 새로고침한 후 다시 참여하세요. 회의에서 나갔다가 페이지를 새로고침하고 다시 참여한 후 웹캠 연결을 다시 시도해 보세요. 이렇게 하면 일시적인 브라우저 또는 미디어 세션 문제를 해결할 수 있지만, ICE 오류가 반복적으로 발생하는 경우에는 네트워크 또는 서버 측 문제 해결이 필요합니다.
지원되는 브라우저로 업데이트하거나 전환하십시오. 다른 지원되는 데스크톱 브라우저의 최신 버전을 사용해 보십시오. 웹캠이 해당 브라우저에서 작동하면 회의 주최자에게 원래 사용했던 브라우저와 버전을 알려주십시오. 브라우저별로 동작이 다를 수 있으므로 특정 브라우저에서 웹캠이 정상적으로 작동한다고 해서 모든 사용자에게 서버가 올바르게 구성되었다고 단정할 수는 없습니다.
다른 네트워크와 비교해 보세요. 허용된다면 휴대폰 핫스팟이나 다른 신뢰할 수 있는 네트워크를 통해 접속해 보세요. 두 번째 연결에서 웹캠이 정상적으로 작동한다면 원래 Wi-Fi, VPN, 프록시 또는 회사 방화벽이 미디어 트래픽을 제한하고 있을 가능성이 높습니다. 하지만 어떤 특정 규칙이 원인인지 증명하는 것은 아닙니다.
다른 참가자와 함께 동일한 회의실에서 테스트해 보세요. 서로 다른 네트워크에 있는 여러 사람이 웹캠을 켜지 못하는 경우, 서버 또는 호스팅 문제일 가능성이 높으므로 회의 관리자에게 보고하세요. 한 사람만 문제가 발생하는 경우, 해당 참가자의 기기, 브라우저 및 네트워크 문제를 먼저 확인하세요.
다른 BigBlueButton 회의실이나 데모 환경에서 테스트해 보세요. 소속 기관에서 허용하는 경우, 별도의 회의실이나 공식 BigBlueButton 테스트 서비스를 이용하십시오. 카메라가 해당 환경에서는 작동하지만 기관 서버에서는 작동하지 않는 경우, 해당 비교 정보를 관리자에게 공유해 주세요.

관리자가 확인해야 할 사항

여러 사용자가 영향을 받는 경우 각 네트워크 경계(호스트 방화벽, 클라우드 보안 그룹, 라우터 또는 NAT 장치, 상위 네트워크 방화벽)에서 미디어 경로를 확인하십시오. BigBlueButton 방화벽 설명서에는 웹 트래픽에 TCP 80 및 443 포트가, 기본 구성에서는 미디어 트래픽에 UDP 16384~32768 포트가 사용된다고 명시되어 있습니다. 설치 환경에 따라 사용자 지정 범위 또는 버전별 미디어 스택이 사용될 수 있으므로 규칙을 변경하기 전에 실제 구성을 확인하십시오. 설치에 필요한 범위보다 넓은 범위를 열지 마십시오. 최신 BigBlueButton 방화벽 구성 가이드를 참조하십시오 .

NAT 뒤에 있는 서버의 경우, 미디어 서비스가 접근 가능한 외부 IP 주소를 알리는지 확인하십시오. BigBlueButton 2.5 이상 버전은 HTML5 WebRTC 미디어에 mediasoup을 사용합니다. 공식 방화벽 가이드에서 알리는 외부 주소를 구성하는 방법을 설명합니다 /etc/bigbluebutton/bbb-webrtc-sfu/production.yml. 사설 IP 주소, 오래된 공용 IP 주소, 잘못된 포트 포워딩 또는 IPv6 구성 누락으로 인해 클라이언트가 미디어 서비스에 연결할 수 없을 수 있습니다. 사용 중인 BigBlueButton 버전 및 네트워크 구성에 맞는 지침만 적용하고, 가이드의 지시에 따라서만 서비스를 다시 시작하십시오.

또한 영향을 받는 사용자가 아웃바운드 UDP를 차단하는 네트워크를 사용하고 있는지 확인하십시오. TURN 서버는 직접 경로를 사용할 수 없는 경우 WebRTC 트래픽을 중계할 수 있지만, 해당 BigBlueButton 버전에 맞게 설치, 연결 및 구성되어 있어야 합니다. TURN 설명서 및 패키지 기본 설정은 릴리스마다 다르므로 사용 중인 정확한 버전의 가이드를 따르십시오. 다른 릴리스의 자격 증명이나 포트 설정을 복사하지 마십시오. BigBlueButton 4.0 TURN 서버 가이드를 검토하십시오 .

흔히 하는 오해 중 피해야 할 것들

"웹캠 오류는 카메라가 고장났다는 뜻입니다."

반드시 그런 것은 아닙니다. 로컬 미리보기가 표시되고 브라우저에 권한이 있는 경우, 미디어 경로 연결에 문제가 있더라도 기기는 작동할 수 있습니다. 조치: 다른 네트워크를 사용해 보고 카메라를 교체하기 전에 다른 참가자에게 문제가 발생하는지 확인하십시오.

"카메라를 허용하면 웹캠 오류가 모두 해결됩니다."

이 권한은 브라우저가 비디오를 캡처할 수 있도록만 허용합니다. 차단된 UDP 트래픽을 열거나 서버의 NAT 주소를 수정하지는 않습니다. 조치: 권한을 확인한 후 다른 네트워크에서 연결을 테스트하십시오.

"회의가 정상적으로 로드된다는 것은 해당 미디어 네트워크가 열려 있음을 의미합니다."

페이지 및 회의 컨트롤은 HTTPS를 통해 로드될 수 있지만 실시간 오디오 또는 비디오는 별도의 미디어 경로를 설정할 수 없습니다. BigBlueButton은 ICE 오류와 함께 UDP 및 NAT 차단을 가능한 원인으로 보고합니다. 조치: 웹캠 테스트를 실행하고 네트워크 간 결과를 비교하십시오.

"모든 서버는 동일한 포트와 TURN 설정을 사용해야 합니다."

문서화된 기본 설정은 유용한 시작점일 뿐, 실제 구성에 대한 증거는 아닙니다. 포트는 사용자 지정할 수 있으며, TURN 설정은 릴리스 버전에 따라 다릅니다. 조치: 방화벽 또는 릴레이 규칙을 수정하기 전에 배포된 버전과 구성을 검사하십시오.

수정 사항을 확인하는 방법

변경 후 새 회의에 참여하여 웹캠을 최소 1분 동안 켜 두십시오. 로컬 미리보기가 표시되고 다른 참가자가 스트림을 볼 수 있으며, 재연결 시 ICE 오류가 발생하지 않는지 확인하십시오. 이전에 문제가 발생했던 네트워크의 사용자에게 동일한 테스트를 반복하도록 요청하십시오. 핫스팟 테스트만 성공하면 네트워크 관리자에게 해당 결과를 알리고 WebRTC 트래픽 검토를 요청하십시오. 여러 사용자가 모든 네트워크에서 실패하는 경우 BigBlueButton 호스트에게 서버 버전, 대략적인 시간, 영향을 받은 브라우저, 오류 코드 또는 정확한 메시지, 오디오 작동 여부, 각 네트워크 테스트 결과를 보내십시오. 회의 링크, 액세스 토큰 또는 수정되지 않은 브라우저 로그는 공개적으로 게시하지 마십시오.

유용한 진단은 문제의 원인을 좁혀줍니다. 로컬 카메라 접근 권한, 특정 사용자의 네트워크, 또는 서버의 미디어 경로 문제일 수 있습니다. 오류 메시지만으로는 원인을 구분할 수 없지만, 이러한 점검을 통해 관리자는 다음 변경 사항을 적용할 근거를 확보할 수 있습니다.