BigBlueButton Breakout Rooms 오디오 연결 오류 해결 방법: 믿을 수 있는 문제 해결 경로

BigBlueButton의 소그룹 회의실 오디오 연결이 안 될 때 가장 먼저 해야 할 질문은 "어떤 서비스를 재시작해야 하나요?"가 아니라 "소그룹 회의실에 들어간 후에만 오디오가 끊기는 건가요, 아니면 메인 회의에서도 오디오가 끊기는 건가요?"입니다. 이 차이를 통해 회의실 전환 문제와 브라우저, 네트워크 또는 미디어 서버 문제 등 더 광범위한 원인을 빠르게 구분할 수 있습니다.

이 가이드는 BigBlueButton 3.0 버전을 기준으로 작성되었으며, 2026년 10월 현재 BigBlueButton 3.0은 안정적인 최신 버전입니다. BigBlueButton 4.0은 아직 개발 중인 것으로 문서화되어 있습니다. BigBlueButton 3.0은 미팅 API를 통해 , , 등 다양한 오디오 브리지를 사용할 수 있으므로 bbb-webrtc-sfu모든 livekit배포 freeswitch환경에서 미디어 경로가 동일하다고 가정하지 마십시오. 공식 BigBlueButton API 참조 문서에서 이러한 브리지 선택 사항을 확인할 수 있으며, 서버 측 점검 은 BigBlueButton 문제 해결 가이드를 참고하는 것이 가장 좋습니다.

좋은 해결책이란 이런 것이다

성공적인 결과는 마이크 아이콘이 녹색으로 바뀌는 것 이상입니다. 수정 후 참가자는 소그룹 회의실에 입장하여 몇 초 내에 오디오에 연결되고, 다른 참가자의 목소리를 듣고, 말하고 자신의 목소리가 들리고, 음소거 및 음소거 해제를 정상적으로 수행하고, 재연결 루프에 갇히지 않고 메인 회의실로 돌아갈 수 있어야 합니다. 다른 모든 참가자가 정상적으로 작동하는 후에도 특정 브라우저나 네트워크에서만 문제가 발생하는 경우, 서버 변경을 중단하고 해당 클라이언트 환경에 집중해야 합니다.

1단계: 문제를 깔끔하게 재현합니다.

설정을 변경하기 전에 진행자 한 명과 참가자 한 명을 사용하여 문제를 재현해 보세요. 참가자가 메인 회의실에서 오디오에 참여할 수 있는지 확인한 다음, 해당 참가자를 소그룹 회의실로 이동시키고 정확히 어떤 일이 발생하는지 기록하세요. "오디오 연결 중..." 메시지가 표시되고 완료되지 않는 경우는 브라우저 권한 거부, 마이크 장치 누락 또는 오디오는 연결되었지만 소리가 나지 않는 경우와는 다릅니다.

메인 회의실은 정상적으로 작동하지만 소그룹 회의실이 작동하지 않는 경우, 소그룹 회의실에서 나갔다가 메인 회의실로 돌아온 후 소그룹 회의실에 다시 한 번 입장해 보세요. 일시적으로 발생한 클라이언트 상태 오류가 정상적으로 재접속되면 해결될 수 있습니다. 문제가 계속 반복되는 경우, 페이지를 반복적으로 새로고침하는 대신 아래의 확인 절차를 진행하세요.

성공 여부 확인: 참가자가 소그룹 토론 오디오에 한 번 참여했다가 나갔다가 다시 참여했을 때 오디오가 다시 연결되는지 확인합니다. 이 과정이 안정적으로 작동한다면 문제는 일시적인 것이었을 가능성이 높습니다. 만약 동일한 전환 과정이 매번 실패한다면 다음 단계로 넘어갑니다.

2단계: 브라우저 마이크 권한 및 선택한 장치를 확인합니다.

BigBlueButton 오디오는 브라우저 기반 WebRTC를 사용하므로, 마이크 권한이 거부되면 사용자가 소규모 회의실에 들어간 후에야 문제를 발견할 경우 마치 특정 소규모 회의실에서만 발생하는 문제처럼 보일 수 있습니다. 브라우저에서 BigBlueButton 호스트 이름의 사이트 권한을 열고 마이크 접근이 허용되어 있는지 확인하십시오. 그런 다음 의도한 마이크가 선택되어 있는지, 그리고 다른 애플리케이션이 마이크를 독점적으로 사용하고 있지 않은지 확인하십시오.

최신 버전의 Firefox 또는 Chromium 기반 브라우저로 테스트하십시오. 참가자가 두 개의 최신 브라우저에서 동일한 오류를 재현할 수 있다면, 순수한 브라우저 프로필 문제일 가능성은 낮습니다. 동일한 컴퓨터 및 네트워크 환경에서 한 브라우저는 작동하고 다른 브라우저는 작동하지 않는 경우, BigBlueButton 설정을 변경하기 전에 권한을 재설정하거나 깨끗한 브라우저 프로필로 테스트하십시오.

성공 여부 확인: 마이크 활동 표시기가 반응하고, 메인 회의실에 오디오가 연결되며, 동일한 브라우저로 소그룹 회의실에도 오디오가 연결되는지 확인합니다. 메인 회의실 연결이 여전히 실패하는 경우, 소그룹 회의실이 근본적인 원인이 아닐 수 있습니다.

3단계: 재시작하기 전에 BigBlueButton을 확인하세요.

서버에서 `.` 명령어를 실행하세요 sudo bbb-conf --check. BigBlueButton 공식 문서에서도 이 명령어를 서버 측 진단의 첫 번째 단계로 권장합니다. 핵심 구성 요소가 제대로 시작되었는지 확인하고 일반적인 구성 문제를 파악하는 데 도움이 되기 때문입니다. 모든 서비스를 즉시 재시작하기보다는 "잠재적 문제" 항목에 나열된 내용을 검토하세요.

또한 sudo bbb-conf --status오디오 브리지에 필요한 systemd 서비스를 실행하고 검사하십시오. BigBlueButton 3.0 배포에서는 일반적 bbb-webrtc-sfu으로 기본적으로 오디오에 FreeSWITCH를 사용하지만, LiveKit은 회의별 또는 서버 전체에서 활성화할 수 있습니다. 통합이 성공적으로 완료되면 audioBridge=livekit기존 FreeSWITCH 경로를 통해 브라우저 오디오가 전송된다고 가정하기보다는 LiveKit 문제를 해결하십시오.

공식 설정 파일 문서에서는/etc/bigbluebutton 패키지 업그레이드 시 덮어쓰기가 발생하지 않도록 로컬 재정의 파일을 해당 위치에 배치할 것을 권장합니다 .

성공 확인: bbb-conf --check 설명할 수 없는 오류가 없고, 활성 오디오 브리지 서비스가 실행 중이며, 새 테스트 회의가 일관되게 작동하는지 확인합니다. 서비스 상태는 양호하지만 하나의 네트워크에서 여전히 문제가 발생하는 경우 ICE, NAT 및 TURN 문제를 점검해야 합니다.

4단계: ICE, NAT, 방화벽 및 TURN 문제 진단

WebRTC는 브라우저와 BigBlueButton 미디어 인프라 간에 사용 가능한 미디어 경로를 설정해야 합니다. 신호 전송은 성공했지만 미디어가 유효한 네트워크 경로를 찾지 못하면 사용자는 ICE 협상 실패를 경험하거나 오디오 연결 중에 멈춰버릴 수 있습니다. BigBlueButton의 방화벽 문서에서는 잘못된 외부 IP 주소 알림과 UDP 차단이 일반적인 원인이라고 명시하고 있습니다.

Firefox에서는 about:webrtcICE 후보와 연결 상태를 보여주기 때문에 유용합니다. 서버가 외부 주소를 예상하는 위치에 내부 주소를 광고하는 경우 NAT 및 공지 IP 구성을 확인하십시오. BigBlueButton의 방화벽 구성 가이드에서는 서버가 NAT 뒤에 있을 때 mediasoup이 공용 주소를 어떻게 공지해야 하는지 설명합니다.

기업, 학교, 호텔 또는 VPN 네트워크와 같이 보안이 강화된 네트워크에서 오류가 집중적으로 발생하는 경우 TURN 서버를 구성하십시오. BigBlueButton의 설치 설명서에서는 방화벽으로 보호되는 사용자를 위해 TURN 사용을 권장합니다. 유용한 검증 방법은 동일한 사용자를 휴대폰 핫스팟과 같은 다른 네트워크에서 테스트하는 것입니다. 핫스팟에서는 정상적으로 작동하는데 관리되는 네트워크에서만 오류가 발생한다면, 이는 네트워크 경로 자체가 문제의 원인이며, 회의실 분리 로직에는 문제가 없다는 강력한 증거입니다.

오래된 포럼 게시글에서 복사한 광범위한 포트 범위를 맹목적으로 열지 마십시오. 설치된 BigBlueButton 버전과 배포 토폴로지에 맞는 포트 및 브리지 요구 사항을 사용하십시오. 이전 FreeSWITCH 또는 SIP.js 관련 조언은 최신 3.0 설치에 적용되지 않을 수 있습니다.

성공 여부 확인: ICE가 연결 상태에 도달하고, 예상되는 공용 또는 릴레이 후보가 나타나며, 이전에 연결이 끊겼던 네트워크에서 해당 사용자가 브레이크아웃 오디오에 참여할 수 있는지 확인합니다. 동일 네트워크의 다른 사용자는 연결에 성공했지만 해당 사용자만 여전히 연결에 실패하는 경우, 장치/브라우저 점검 단계로 돌아갑니다.

5단계: 구성된 오디오 브리지를 비교하고 룸 전환을 재테스트합니다.

메인룸 오디오는 정상 작동하지만 여러 사용자의 브레이크아웃 오디오가 지속적으로 실패하는 경우, 해당 회의에서 실제로 사용하는 오디오 브리지를 확인하십시오. BigBlueButton 3.0은 ` create` 매개변수에 `<a>` , `<a>`, `<a>`를 audioBridge포함한 유효값을 제공합니다 . 통합 설정에 따라 회의별로 서버 기본값이 재정의될 수 있으므로, 확인한 구성이 실패하는 세션에서 사용되는 브리지와 일치하지 않을 수 있습니다.bbb-webrtc-sfulivekitfreeswitch

사용자 지정 회의 설정 없이 새 테스트 회의를 생성한 다음, 메인 회의실 → 소그룹 회의실 → 메인 회의실 순서를 반복합니다. 사용자 지정 설정 없이 생성된 회의는 정상적으로 작동하지만, LMS 또는 사용자 지정 애플리케이션으로 생성된 회의가 실패하는 경우 해당 통합에서 전송하는 API 매개변수를 검사하십시오. 두 경우 모두 실패하는 경우, 서버 미디어 구성 또는 특정 버전 관련 결함이 원인일 가능성이 높습니다.

설정을 변경한 후에는 필요할 때만 BigBlueButton을 다시 시작하고 다시 sudo bbb-conf --restart실행하십시오 sudo bbb-conf --check. 테스트하기 전에 여러 변경 사항을 한꺼번에 적용하지 마십시오. 한 번에 하나씩 변경해야 어떤 조정이 실제로 문제를 해결했는지 확인할 수 있습니다.

성공 여부 확인: 두 참가자가 소그룹 회의실에서 서로 대화한 후 메인 회의실로 돌아와 연결이 끊기지 않고 다시 소그룹 회의실에 입장할 수 있어야 합니다. 최소 한 개의 외부 네트워크에서 이 과정을 반복한 후에야 문제가 해결된 것으로 간주합니다.

접근 방식을 언제 바꿔야 할까요?

브라우저 권한, 서버 상태, ICE/TURN 및 브리지 선택을 모두 확인한 후에도 문제가 지속되면 추측만 하지 말고 증거를 수집하십시오. BigBlueButton 버전, 브라우저 및 운영 체제 버전, 공개 BigBlueButton 데모에서 문제가 재현되는지 여부, 명령 출력, sudo bbb-conf --check회의의 오디오 브리지 설정, 관련 브라우저 WebRTC 진단 정보를 기록하십시오. BigBlueButton 도움말 가이드 에서는 오디오 또는 비디오 오류 문제 해결 시 이러한 네트워크 및 환경 정보를 명시적으로 요청합니다.

2026년 10월 현재, BigBlueButton 3.0은 여전히 ​​안정적인 문서 버전이며, GitHub에서 3.0 릴리스가 계속 진행되고 있습니다. 반면 4.0 문서는 개발 중으로 표시되어 있습니다. 이는 BigBlueButton 4.0에서 기본 미디어 프레임워크가 LiveKit으로 변경되었기 때문에 4.0 관련 권장 사항을 3.0 서버에 자동으로 적용해서는 안 된다는 점을 의미합니다. 버전별 지침을 따르기 전에 BigBlueButton 공식 릴리스 페이지를 확인하십시오 .

최종 확인 체크리스트

• 해당 참가자를 위해 메인룸 오디오가 연결됩니다.
• 마이크 권한이 허용되었고 해당 기기에서 입력 활동이 표시됩니다.
• bbb-conf --check원인을 알 수 없는 미디어 서비스 오류가 없습니다.
• ICE는 연결 상태에 도달하며, 제한적인 네트워크에서도 필요할 때 사용 가능한 TURN 경로를 제공합니다.
• 이 회의는 여러분이 생각하는 오디오 브리지를 사용합니다.
• 두 사용자는 소규모 회의실에서 서로의 목소리를 들을 수 있으며, 이후 메인 회의실로 돌아와 성공적으로 다시 참여할 수 있습니다.

6가지 검사 모두를 반복적으로 통과하면, 수리가 제대로 진행되고 있다는 뜻입니다. 즉, 일시적인 녹색 마이크 아이콘 표시가 아니라, 방을 이동할 때에도 안정적인 오디오를 제공하는 것입니다.