Gdy nie można nawiązać połączenia audio w pokoju spotkań BigBlueButton, pierwszym przydatnym pytaniem nie jest „którą usługę mam zrestartować?”, ale „czy dźwięk zanika tylko po wejściu do pokoju spotkań, czy również podczas głównego spotkania?”. To rozróżnienie pozwala szybko odróżnić problem z przejściem do pokoju od szerszego problemu z przeglądarką, siecią lub serwerem multimediów.
Niniejszy przewodnik został napisany dla BigBlueButton 3.0, który pozostaje aktualną, stabilną wersją dokumentacji od października 2026 roku; BigBlueButton 4.0 jest nadal udokumentowany jako wersja rozwojowa. BigBlueButton 3.0 może korzystać z różnych mostków audio, w tym bbb-webrtc-sfu, livekiti freeswitchpoprzez interfejs API spotkań, więc nie zakładaj, że każde wdrożenie ma tę samą ścieżkę multimediów. Oficjalny dokument referencyjny interfejsu API BigBlueButton dokumentuje te opcje mostków, a przewodnik rozwiązywania problemów z BigBlueButton pozostaje najlepszym punktem wyjścia do kontroli po stronie serwera.
Pomyślny wynik to coś więcej niż tylko zielona ikona mikrofonu. Po wprowadzeniu poprawki uczestnik powinien móc wejść do pokoju grupowego, dołączyć do audio w ciągu kilku sekund, słyszeć innego uczestnika, mówić i być słyszanym, normalnie wyciszać i włączać dźwięk oraz wrócić do pokoju głównego bez wpadania w pętlę ponownego połączenia. Jeśli tylko jedna przeglądarka lub jedna sieć nadal nie działa, mimo że wszyscy inni odnieśli sukces, należy zaprzestać zmiany serwera i skupić się na tym środowisku klienta.
| Obserwacja | Najbardziej prawdopodobny obszar | Następny ruch |
|---|---|---|
| Zarówno dźwięk w pomieszczeniu głównym, jak i w oddzielnym pomieszczeniu nie działa | Uprawnienia przeglądarki, urządzenie, zapora sieciowa, TURN lub most multimedialny | Zacznij od kroków 1–4 |
| Główne pomieszczenie działa, pomieszczenie wyjściowe wisi na „łączącym” | Przejście do innego pokoju, nieaktualny stan klienta, problem specyficzny dla mostu | Zacznij od kroków 1, 2 i 5 |
| Awaria występuje tylko u użytkowników w jednym biurze, szkole lub sieci VPN | Filtrowanie sieciowe lub ścieżka ICE/TURN | Nadaj priorytet krokowi 4 |
| Wielu użytkowników jednocześnie ponosi porażkę | Konfiguracja serwera lub sieci | Nadaj priorytet krokom 3–5 |
Przed zmianą konfiguracji odtwórz problem z jednym moderatorem i jednym uczestnikiem. Upewnij się, że uczestnik może dołączyć do audio w pokoju głównym, a następnie przenieś go do pokoju podłączeniowego i dokładnie zanotuj, co się stanie. Komunikat „Podłączanie audio…”, który nigdy się nie kończy, różni się od odmowy uprawnień przeglądarki, brakującego mikrofonu lub audio, które łączy się, ale nie przenosi dźwięku.
Jeśli pokój główny działa, ale pokój grupowy nie, spróbuj opuścić pokój grupowy, wrócić do pokoju głównego i ponownie wejść do pokoju grupowego. Jednorazowy, nieaktualny stan klienta może zostać usunięty po ponownym, czystym dołączeniu. Jeśli problem powtarza się regularnie, kontynuuj poniższe czynności, zamiast wielokrotnie odświeżać stronę.
Weryfikacja powodzenia: uczestnik dołącza do audio breakoutu raz, opuszcza go, dołącza ponownie i ponownie odbiera dźwięk. Jeśli to się powiedzie, problem prawdopodobnie był przejściowy. Jeśli to samo przejście za każdym razem się nie powiedzie, kontynuuj.
Dźwięk w BigBlueButton opiera się na technologii WebRTC opartej na przeglądarce, więc odmowa dostępu do mikrofonu może wyglądać na problem typowy dla breakoutu, jeśli użytkownik zauważy ją po wejściu do mniejszego pomieszczenia. Otwórz uprawnienia witryny w przeglądarce dla nazwy hosta BigBlueButton i upewnij się, że dostęp do mikrofonu jest dozwolony. Następnie sprawdź, czy wybrany jest właściwy mikrofon i czy inna aplikacja nie blokuje dostępu do urządzenia.
Przetestuj z aktualną wersją przeglądarki Firefox lub przeglądarki opartej na Chromium. Jeśli uczestnik może odtworzyć ten sam błąd w dwóch aktualnych przeglądarkach, zmniejsza to prawdopodobieństwo wystąpienia problemu z samym profilem przeglądarki. Jeśli jedna przeglądarka działa, a inna przestaje działać na tym samym komputerze i w tej samej sieci, zresetuj uprawnienia lub przetestuj z czystym profilem przeglądarki przed zmianą konfiguracji BigBlueButton.
Sprawdzenie poprawności: wskaźnik aktywności mikrofonu reaguje, dźwięk włącza się w sali głównej, a ta sama przeglądarka może dołączyć do dźwięku w sali rozdzielonej. Jeśli sala główna nadal nie działa, przyczyną problemu nie jest sala rozdzielona.
Na serwerze uruchom sudo bbb-conf --check. Własna dokumentacja BigBlueButton zaleca to jako pierwszą diagnostykę po stronie serwera, ponieważ sprawdza, czy główne komponenty zostały poprawnie uruchomione i ujawnia typowe problemy z konfiguracją. Przejrzyj wszystkie pozycje wymienione w sekcji „Potencjalne problemy” zamiast od razu restartować każdą usługę.
Uruchom sudo bbb-conf --statusi sprawdź również odpowiednie usługi systemd dla swojego mostu audio. Wdrożenia BigBlueButton 3.0 zazwyczaj bbb-webrtc-sfudomyślnie obsługują dźwięk, natomiast LiveKit można włączyć dla każdego spotkania lub dla całego serwera. Jeśli integracja się powiedzie audioBridge=livekit, rozwiąż problemy z LiveKit, zamiast zakładać, że ścieżka FreeSWITCH przesyła dźwięk z przeglądarki.
Oficjalna dokumentacja plików konfiguracyjnych zaleca umieszczenie lokalnych nadpisów w folderze „ /etc/bigbluebuttonsub”, aby uaktualnienia pakietów ich nie nadpisywały.
Kontrola sukcesu: bbb-conf --check brak niewyjaśnionych błędów, aktywne usługi mostu audio działają, a nowe spotkania testowe przebiegają spójnie. Jeśli stan usługi jest dobry, ale jedna sieć nadal ulega awarii, należy skupić się na ICE, NAT i TURN.
WebRTC musi ustanowić użyteczną ścieżkę multimedialną między przeglądarką a infrastrukturą multimedialną BigBlueButton. Jeśli sygnalizacja powiedzie się, ale media nie znajdą odpowiedniej ścieżki sieciowej, użytkownicy mogą napotkać błędy negocjacji ICE lub zablokować się podczas dołączania do audio. Dokumentacja zapory sieciowej BigBlueButton wskazuje na nieprawidłowe zewnętrzne komunikaty IP i zablokowany protokół UDP jako częste przyczyny.
W przeglądarce Firefox about:webrtcjest to przydatne, ponieważ pokazuje kandydatów ICE i stan połączenia. Jeśli widzisz, że serwer reklamuje adres wewnętrzny, podczas gdy oczekiwany jest adres zewnętrzny, sprawdź konfigurację NAT i zapowiedzianych adresów IP. Przewodnik konfiguracji zapory BigBlueButton wyjaśnia, jak MediaSoup powinien ogłaszać adres publiczny, gdy serwer znajduje się za NAT.
Jeśli awarie gromadzą się w restrykcyjnych sieciach korporacyjnych, szkolnych, hotelowych lub VPN, należy skonfigurować serwer TURN. Dokumentacja instalacyjna BigBlueButton zaleca korzystanie z TURN użytkownikom znajdującym się za restrykcyjnymi zaporami sieciowymi. Przydatnym sposobem weryfikacji jest przetestowanie tego samego użytkownika w innej sieci, na przykład w hotspocie telefonicznym. Jeśli hotspot działa, a zarządzana sieć ulega awarii, jest to mocny dowód na to, że czynnikiem ograniczającym jest ścieżka sieciowa, a nie logika pomieszczenia rozdzielczego.
Nie otwieraj bezmyślnie szerokich zakresów portów skopiowanych ze starych postów na forum. Użyj wymagań dotyczących portów i mostów dla zainstalowanej wersji BigBlueButton i topologii wdrożenia. Starsze zalecenia dotyczące FreeSWITCH lub SIP.js mogą nie mieć zastosowania do obecnej instalacji 3.0.
Sprawdzenie powodzenia: ICE osiąga stan połączenia, pojawia się oczekiwany kandydat publiczny lub przekaźnikowy, a ten sam użytkownik, którego dotyczy problem, może dołączyć do breakout audio z sieci, która wcześniej uległa awarii. Jeśli użytkownik nadal nie może połączyć się z siecią, podczas gdy inni użytkownicy w tej samej sieci łączą się pomyślnie, należy wrócić do sprawdzania urządzenia/przeglądarki.
Jeśli dźwięk w sali głównej działa, ale dźwięk w trybie „breakout” stale nie działa u wielu użytkowników, należy sprawdzić, z którego mostu audio faktycznie korzysta spotkanie. BigBlueButton 3.0 udostępnia audioBridgeparametr „create” z prawidłowymi wartościami, takimi jak bbb-webrtc-sfu, livekiti freeswitch. Integracja może zastąpić domyślne ustawienia serwera dla każdego spotkania, więc sprawdzana konfiguracja może nie być zgodna z mostem używanym przez sesję, w której wystąpił błąd.
Utwórz nowe spotkanie testowe bez niestandardowych nadpisów dla każdego spotkania, a następnie powtórz tę samą sekwencję: sala główna → sala podwójna → sala główna. Jeśli czyste spotkanie działa, ale spotkania utworzone przez system LMS lub aplikację niestandardową kończą się niepowodzeniem, sprawdź parametry API wysyłane przez tę integrację. Jeśli oba zawiodą, problem najprawdopodobniej leży w konfiguracji multimediów serwera lub jest defektem specyficznym dla danej wersji.
Po zmianie konfiguracji uruchom ponownie BigBlueButton tylko wtedy, gdy jest to konieczne, za pomocą sudo bbb-conf --restart, a następnie uruchom sudo bbb-conf --checkponownie. Unikaj nakładania kilku zmian na siebie przed testowaniem; wprowadzanie jednej zmiany na raz pozwala zidentyfikować, która zmiana faktycznie rozwiązała problem.
Weryfikacja powodzenia: dwóch uczestników może ze sobą rozmawiać w pokoju grupowym, wrócić do pokoju głównego i ponownie dołączyć do sesji grupowej bez zerwania połączenia. Powtórz to z co najmniej jedną siecią zewnętrzną, zanim uznasz incydent za zamknięty.
Jeśli problem nadal występuje po sprawdzeniu uprawnień przeglądarki, stanu serwera, ICE/TURN i wyboru mostu, zbierz dowody, zamiast dalej zgadywać. Zapisz wersję BigBlueButton, wersję przeglądarki i systemu operacyjnego, informację, czy problem występuje w publicznej wersji demonstracyjnej BigBlueButton, dane wyjściowe sudo bbb-conf --check, ustawienia mostu audio spotkania oraz wszelkie istotne dane diagnostyczne WebRTC przeglądarki. Przewodnik BigBlueButton „Uzyskiwanie pomocy” wyraźnie zaleca tego rodzaju informacje o sieci i środowisku podczas rozwiązywania problemów z dźwiękiem lub obrazem.
Od października 2026 roku BigBlueButton 3.0 nadal jest stabilną wersją dokumentacji, a wydania 3.0 są nadal dostępne na GitHubie, a dokumentacja 4.0 jest oznaczona jako „w fazie rozwoju”. Ma to znaczenie, ponieważ BigBlueButton 4.0 zmienia domyślny framework multimediów na LiveKit, więc porady dotyczące wersji 4.0 nie powinny być automatycznie stosowane na serwerze 3.0. Przed wykonaniem instrukcji dotyczących wersji zapoznaj się z oficjalną stroną wydania BigBlueButton .
bbb-conf --checknie ma żadnych niewyjaśnionych błędów usługi multimedialnej.Jeśli wszystkie sześć kontroli zakończy się sukcesem, naprawa przyniesie oczekiwany rezultat: stabilny dźwięk w różnych pomieszczeniach, a nie tylko tymczasową zieloną ikonę mikrofonu.
Napraw udostępnianie ekranu w Jitsi Meet na macOS Sonoma: włącz odpowiednie uprawnienia przeglądarki, uruchom ją ponownie i zdiagnozuj problemy z selektorem lub spotkaniem.
Porównaj praktyczne alternatywy typu open source dla Kopano Core w zakresie poczty e-mail dla przedsiębiorstw i oprogramowania do pracy grupowej, w tym grommunio, SOGo, Zimbra, Nextcloud i Open-Xchange.
Napraw problem z dźwiękiem w pokoju przejściowym BigBlueButton, który się zawiesza lub nie łączy. Zdiagnozuj problemy z uprawnieniami przeglądarki, WebRTC, TURN, NAT, zaporą sieciową i mostem audio.
Rozwiąż błąd Zimbra „Konto jest zablokowane”: sprawdź status konta, odblokuj potwierdzoną blokadę, znajdź nieaktualne dane uwierzytelniające i zweryfikuj poprawkę.
Rozwiąż problem dużego wykorzystania pamięci przez PostgreSQL za pomocą Matrix Synapse, sprawdzając połączenia, dostrajając ustawienia puli i pamięci, odkurzając tabele i weryfikując wyniki.
Skonfiguruj zewnętrzny serwer Collabora CODE Docker dla Nextcloud w około 10 minut, korzystając z serwera proxy HTTPS, sprawdzania WOPI, wskazówek dotyczących bezpieczeństwa i rozwiązywania problemów.
Napraw ostrzeżenie ownCloud Apache AllowOverride All poprzez skonfigurowanie prawidłowego katalogu, przetestowanie Apache, bezpieczne ponowne załadowanie i sprawdzenie ochrony .htaccess.
Zamontuj udział Samba lub CIFS na serwerze ownCloud z obsługą pamięci zewnętrznej. Skonfiguruj poświadczenia SMB, ogranicz dostęp i zweryfikuj montaż.
Fix the Android app installation error by checking connectivity, Play Store cache, storage, device compatibility, and emulator DNS or proxy settings.
Back up and restore a Matrix Synapse PostgreSQL database with pg_dump and pg_restore. Protect one-time keys, create a clean target, and verify recovery.
