Naprawa przekroczeń limitu czasu rejestracji SIP w BigBlueButton FreeSWITCH: praktyczny przewodnik diagnostyczny

Spotkanie BigBlueButton może się normalnie ładować, podczas gdy uczestnicy utknęli podczas dołączania do audio. Administratorzy mogą zobaczyć komunikaty „Przekroczenie limitu czasu rejestracji SIP”, „FreeSWITCH nie zarejestrował się” lub błąd połączenia audio w dzienniku lub narzędziu monitorującym. Te komunikaty nie zawsze wskazują na ten sam błąd. W standardowym wdrożeniu BigBlueButton, nieudane połączenie audio może wynikać z zatrzymania procesu FreeSWITCH, zablokowanego połączenia SIP lub Event Socket, nieprawidłowego adresu za NAT lub zablokowanego medium WebRTC. Rzeczywisty przekroczenie limitu czasu rejestracji dla operatora lub bramy PBX to osobny przypadek.

Zacznij od zidentyfikowania komponentu, który przekracza limit czasu. Następnie sprawdź stan usługi, lokalne odbiorniki, ścieżki sieciowe i adresy (w tej kolejności). Unikaj zmiany ustawień SIP i otwierania portów, dopóki dowody nie wskażą ścieżki, której dotyczy problem.

Najpierw zidentyfikuj, do czego odnosi się „przekroczenie limitu czasu rejestracji”

Obecny stos audio BigBlueButton wykorzystuje tę bbb-webrtc-sfuusługę do koordynacji multimediów z FreeSWITCH. Dokumentacja BigBlueButton opisuje SFU łączące się z usługą SIP FreeSWITCH i warstwą gniazd zdarzeń (ESL). Różni się to od rejestrowania przez FreeSWITCH bramy wychodzącej u zewnętrznego dostawcy SIP.

  • Problem z połączeniem audio BigBlueButton: użytkownicy nie mogą dołączyć do audio, FreeSWITCH jest niedostępny lub SFU zgłasza przekroczenie limitu czasu. Sprawdź FreeSWITCH, ESL, skonfigurowany adres i port SIP, NAT oraz transport WebRTC.
  • Problem z rejestracją zewnętrznej bramy: FreeSWITCH zgłasza, że ​​skonfigurowana brama jest wyłączona lub niezarejestrowana. Sprawdź nazwę hosta dostawcy, dane uwierzytelniające, transport, ścieżkę zapory sieciowej i status konta po stronie dostawcy.

Jeśli nie masz pewności, który przypadek ma zastosowanie, zapisz pełny tekst błędu i nazwę usługi, która go zarejestrowała. Samo „przekroczenie limitu czasu rejestracji” nie uzasadnia zmiany profilu SIP.

1. Uruchom sprawdzanie konfiguracji BigBlueButton

Na serwerze uruchom diagnostykę zalecaną przez BigBlueButton:

sudo bbb-conf --check

Przejrzyj wszystkie dane wyjściowe, zwłaszcza sekcję zatytułowaną „[…]” Potential problems. Sprawdza ona, czy wymagane procesy są uruchomione i zgłasza typowe problemy z konfiguracją. Ostrzeżenie może oznaczać celowe dostosowanie, dlatego porównaj je ze swoją konfiguracją, zamiast automatycznie stosować każdą sugerowaną poprawkę.

Następnie sprawdź status usługi:

sudo bbb-conf --status
sudo systemctl status freeswitch --no-pager
sudo systemctl status bbb-webrtc-sfu --no-pager

W starszych wersjach BigBlueButton nazwy usług lub architektura komponentów mogą się różnić. Sprawdź zainstalowaną wersję sudo bbb-conf --versioni skorzystaj z dokumentacji dla tej wersji. Poniższe ścieżki i przykłady odnoszą się głównie do dokumentacji BigBlueButton 4.0, która jest oznaczona jako „w fazie rozwoju”.

2. Sprawdź, czy FreeSWITCH działa i akceptuje połączenia lokalne

Jeśli freeswitch.servicejest nieaktywny, uszkodzony lub ciągle się restartuje, przed edycją konfiguracji należy przeczytać jego dziennik:

sudo journalctl -u freeswitch.service -b --no-pager -n 100

Poszukaj błędów powiązań, błędów ładowania modułów, problemów z uprawnieniami lub błędów bazy danych w pobliżu ostatniego uruchomienia. Przewodnik rozwiązywania problemów BigBlueButton opisuje konkretne przypadki, w których FreeSWITCH nie może powiązać się z IPv4 lub portem ESL 8021. Identyfikuje również uszkodzoną bazę danych FreeSWITCH jako możliwą przyczynę po ponownym uruchomieniu, ale zaleca czyszczenie bazy danych tylko wtedy, gdy występują odpowiednie błędy bazy danych.

Sprawdź, które adresy i porty nasłuchują:

sudo ss -luntp | grep -E ':(5060|5066|8021)\b'

Dokładny nasłuchiwacz SIP zależy od wersji i konfiguracji BigBlueButton. Brak nasłuchiwacza sugeruje, że FreeSWITCH nie uruchomił tego profilu lub powiązał go z innym adresem. Port 8021 to lokalny interfejs sterujący ESL w typowej instalacji pakietowej; zazwyczaj powinien być ograniczony do hosta lokalnego lub zaufanej sieci prywatnej. Nie udostępniaj go w publicznym Internecie.

Jeśli FreeSWITCH jest aktywny, możesz sprawdzić stan profilu SIP za pomocą jego interfejsu wiersza poleceń. Standardowe polecenie FreeSWITCH to sofia status: użyj nazw profili wyświetlanych przez serwer, zamiast zakładać, że każde wdrożenie używa tych samych. Oznaczenie profilu RUNNINGpotwierdza jego uruchomienie, ale nie dowodzi, że przeglądarki zdalne mogą dotrzeć do ścieżki audio.

3. Dopasuj błąd do uszkodzonej ścieżki sieciowej

Przewodnik po zaporach sieciowych BigBlueButton rozróżnia awarię sygnalizacji WebSocket od awarii ICE/media. To rozróżnienie zawęża zakres wyszukiwania:

  • Błąd WebRTC 1002: przeglądarka nie mogła nawiązać połączenia WebSocket. Sprawdź, czy FreeSWITCH jest uruchomiony, trasę SIP-over-WebSocket i konfigurację odwrotnego serwera proxy oraz wszelkie reguły zapory sieciowej wpływające na tę ścieżkę sygnałową.
  • Błąd WebRTC 1007: WebSocket nawiązał połączenie, ale przeglądarka nie mogła nawiązać połączenia przy użyciu zwróconych adresów kandydackich. Sprawdź zgłoszony adres IP i dwukierunkową dostępność UDP.

W przypadku domyślnej konfiguracji zapory BigBlueButton, oficjalny przewodnik zawiera listę portów UDP 16384–32768dla multimediów w czasie rzeczywistym. Należy zezwolić na wymagany zakres zarówno w grupie zabezpieczeń chmury lub zaporze obwodowej, jak i zaporze hosta. Reguła powinna być ograniczona do serwera i wymaganego ruchu; szerokie otwieranie niezwiązanych z nią portów SIP nie zastępuje prawidłowej konfiguracji NAT i WebRTC.

Na przykład, jeśli używasz UFW i potwierdziłeś, że ten zakres jest odpowiedni dla Twojej instalacji, sprawdź istniejące reguły i dodaj zakres multimediów:

sudo ufw status numbered
sudo ufw allow 16384:32768/udp

Zapory sieciowe w chmurze i grupy zabezpieczeń dostawców również muszą zezwalać na ruch. Reguła na poziomie hosta nie może zignorować zablokowanej zapory sieciowej nadrzędnej. Jeśli awaria występuje tylko u użytkowników w sieci z ograniczeniami, podczas gdy inni użytkownicy łączą się, należy sprawdzić ich ścieżkę sieciową lub konfigurację TURN zamiast wielokrotnie restartować FreeSWITCH.

4. Sprawdź NAT i reklamowane adresy IP

Serwer za NAT może mieć poprawnego lokalnego nasłuchiwacza i nadal reklamować niedostępny adres prywatny przeglądarkom. Sprawdź, czy zewnętrzny adres IP, przekierowanie portów i konfiguracja FreeSWITCH są zgodne. Przewodnik po zaporach sieciowych BigBlueButton 4.0 używa /opt/freeswitch/conf/vars.xmli /opt/freeswitch/conf/sip_profiles/external.xmlw przykładzie NAT i wskazuje na /etc/bigbluebutton/bbb-webrtc-sfu/production.ymlodpowiednie obejścia SFU.

Nie kopiuj przykładowego adresu IP ani nie zakładaj, że publiczny adres IP należy do każdego pola. W konfiguracji NAT adres, który FreeSWITCH łączy lokalnie, może różnić się od adresu publicznego, który deklaruje. Zastosuj instrukcje specyficzne dla danej wersji topologii sieci, a następnie sprawdź przekierowanie odpowiedniej zapory sieciowej. Jeśli adres zewnętrzny serwera uległ ostatnio zmianie, sprawdź DNS i wszelkie wartości adresów zapisane w konfiguracji BigBlueButton.

Gdy proces serwera musi dotrzeć do własnej publicznej nazwy hosta, może mieć również znaczenie rozwiązanie hairpin NAT lub lokalne rozpoznawanie nazw hostów. Oficjalny podręcznik zapory sieciowej omawia mapowanie publicznej nazwy hosta na adres zapory w /etc/hoststakim scenariuszu. Przetestuj to tylko wtedy, gdy wzorzec błędu wskazuje na pętlę zwrotną przez zewnętrzną nazwę hosta; nie jest to uniwersalne rozwiązanie problemu przekroczenia limitu czasu rejestracji.

5. Jeśli w dzienniku jest wymieniona zewnętrzna brama SIP

Jeśli wadliwym elementem jest nazwana brama operatora, a nie wewnętrzna ścieżka audio BigBlueButton, należy osobno sprawdzić stan bramy. Dokumenty FreeSWITCH sofia status gateway <name>zawierają informacje o stanie bramy oraz sofia statuszaładowanym profilu i stanie bramy. Sprawdź, czy nazwa hosta dostawcy jest rozpoznawana przez serwer, czy skonfigurowana nazwa użytkownika i hasło SIP są zgodne, czy wybrany transport i port są zgodne z wymaganiami dostawcy, a reguły zapory sieciowej zezwalają na ruch sygnalizacyjny.

Nie resetuj pakietowych profili SIP BigBlueButton, aby naprawić konto operatora. Unikaj publicznego udostępniania pełnych śladów SIP: mogą one zawierać numery telefonów, adresy IP, nazwy kont lub dane uwierzytelniające. Usuń poufne wartości przed zwróceniem się do dostawcy lub administratora o sprawdzenie logów.

6. Zastosuj docelową zmianę i ponownie uruchom ponownie

Po usunięciu potwierdzonego problemu z usługą, adresem lub zaporą sieciową należy ponownie uruchomić BigBlueButton przy użyciu obsługiwanego polecenia:

sudo bbb-conf --restart

Używaj sudo bbb-conf --cleantylko wtedy, gdy wymaga tego dokumentacja lub dane diagnostyczne dotyczące konkretnej wersji. Nie jest to uniwersalna odpowiedź na każde przekroczenie limitu czasu SIP. Podobnie, unikaj usuwania plików bazy danych FreeSWITCH, chyba że wystąpią udokumentowane objawy uszkodzenia bazy danych; zachowaj logi i kopie zapasowe konfiguracji przed jakąkolwiek naprawą usuwającą stan.

Zweryfikuj naprawę

Uruchom sudo bbb-conf --checkponownie i sprawdź, czy FreeSWITCH i bbb-webrtc-sfusą sprawne. Dołącz do spotkania testowego z przeglądarki spoza sieci serwera, wybierz mikrofon lub dźwięk tylko do słuchania i sprawdź, czy połączenie zostało nawiązane. W przypadku zmian NAT lub zapory sieciowej, przetestuj z co najmniej jednej sieci, która wcześniej uległa awarii. Sam zielony status usługi nie jest dowodem na to, że media UDP mogą przesyłać dane przez sieć.

Jeśli limit czasu się utrzymuje, zbierz wersję BigBlueButton, pełny tekst błędu, odpowiednie bbb-conf --checkdane wyjściowe, stan usługi, ostatnie wpisy dziennika FreeSWITCH i SFU oraz topologię sieci. Usuń poufne dane i publiczne dane użytkownika. Ten dowód pomaga odróżnić nieaktywnego odbiorcę, limit czasu ESL, błędnie ogłoszony adres, zablokowany zakres mediów i autentyczny błąd rejestracji bramy SIP.

Oficjalne referencje

Dokumentacja sprawdzona 6 października 2026 r. W dokumentacji BigBlueButton 4.0 ta wersja jest oznaczona jako będąca w fazie rozwoju; sprawdź ścieżki i polecenia w odniesieniu do wersji zainstalowanej na serwerze.

Zostaw komentarz

10 najlepszych narzędzi do pingowania w celu znajdowania urządzeń w sieci

10 najlepszych narzędzi do pingowania w celu znajdowania urządzeń w sieci

Porównaj 10 narzędzi do pingowania, które umożliwiają szybkie wykrywanie sieci LAN, skanowanie międzyplatformowe i zarządzanie adresami IP. Dowiedz się, co narzędzie pingujące może Ci powiedzieć, a czego nie.

6 najlepszych narzędzi do zarządzania siecią, umożliwiających śledzenie wydajności

6 najlepszych narzędzi do zarządzania siecią, umożliwiających śledzenie wydajności

Porównaj sześć narzędzi do zarządzania siecią służących do monitorowania wydajności, obejmujących zasięg SNMP, mapowanie, alerty, modele wdrażania i kompromisy kosztów.

Ping Monitor: 7 darmowych i otwartych narzędzi do monitorowania dostępności sieci

Ping Monitor: 7 darmowych i otwartych narzędzi do monitorowania dostępności sieci

Porównaj siedem darmowych i otwartych monitorów pingów — od kompletnych pakietów sieciowych po ukierunkowane sondy opóźnień — i wybierz odpowiedni monitor pod kątem dostępności, utraty pakietów i historii.

QoS w sieciach: czym jest jakość usług i jak działa

QoS w sieciach: czym jest jakość usług i jak działa

Dowiedz się, co oznacza QoS w sieciach, w jaki sposób oznaczenia DSCP i kolejki ruchu nadają priorytet aplikacjom głosowym, wideo i biznesowym oraz czego QoS nie jest w stanie naprawić.

Najlepsze oprogramowanie serwera SFTP do bezpiecznego przesyłania plików

Najlepsze oprogramowanie serwera SFTP do bezpiecznego przesyłania plików

Porównaj niezawodne oprogramowanie serwera SFTP dla systemów Windows i Linux, w tym OpenSSH, Bitvise, SolarWinds i SFTPGo. Znajdź rozwiązanie odpowiednie dla swoich potrzeb w zakresie bezpieczeństwa i transferu plików.

7 najlepszych narzędzi do zarządzania adresami IP dla zespołów sieciowych

7 najlepszych narzędzi do zarządzania adresami IP dla zespołów sieciowych

Porównaj siedem narzędzi do zarządzania adresami IP służących do wykrywania podsieci, koordynacji DNS i DHCP, inwentaryzacji sieci i otwartego oprogramowania IPAM.

6 najlepszych narzędzi do monitorowania serwerów Windows Server zapewniających lepszą dostępność i wydajność

6 najlepszych narzędzi do monitorowania serwerów Windows Server zapewniających lepszą dostępność i wydajność

Porównaj sześć narzędzi do monitorowania systemu Windows Server pod kątem zbierania danych systemu Windows, widoczności aplikacji, modelu wdrażania i licencjonowania, aby znaleźć odpowiednie rozwiązanie.

10 najlepszych narzędzi do skanowania sieci w celu wykrywania urządzeń i adresów IP

10 najlepszych narzędzi do skanowania sieci w celu wykrywania urządzeń i adresów IP

Porównaj narzędzia do skanowania sieciowego umożliwiające szybkie wykrywanie urządzeń, skanowanie adresów IP na wielu platformach oraz zarządzanie IPAM w przedsiębiorstwie. Znajdziesz tu wskazówki dotyczące dopasowania każdej opcji do swojej sieci.

Najlepsze praktyki monitorowania sieci: co śledzić i jakich narzędzi używać

Najlepsze praktyki monitorowania sieci: co śledzić i jakich narzędzi używać

Zbuduj praktyczny monitoring sieci z przejrzystym zakresem urządzeń, przydatnymi wskaźnikami wydajności, przydatnymi alertami oraz porównaniem SolarWinds NPM, PRTG i OpManager.

Jak używać Nmap do śledzenia trasy i odczytywania ścieżki sieciowej

Jak używać Nmap do śledzenia trasy i odczytywania ścieżki sieciowej

Użyj opcji --traceroute programu Nmap, aby mapować przeskoki do autoryzowanego hosta, zrozumieć dane wyjściowe dotyczące przeskoków i czasu RTT oraz rozwiązywać problemy z brakującymi odpowiedziami bez nadmiernego skanowania.