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

Jak ograniczyć daty wygaśnięcia łączy publicznych na serwerze ownCloud

Jak ograniczyć daty wygaśnięcia łączy publicznych na serwerze ownCloud

Ustaw maksymalną datę wygaśnięcia łączy publicznych na serwerze ownCloud, sprawdź, których udostępnień ona dotyczy i zweryfikuj zasady, nie pomijając starszych łączy.

Jak skonfigurować automatyczną synchronizację Zimbra GAL i sprawdzić, czy działa

Jak skonfigurować automatyczną synchronizację Zimbra GAL i sprawdzić, czy działa

Skonfiguruj automatyczną synchronizację Zimbra GAL, ustaw interwał sondowania, wymuś synchronizację testową, zweryfikuj znaczniki czasu i rozwiąż problemy ze starymi wewnętrznymi lub zewnętrznymi kontaktami LDAP.

Jak skonfigurować uwierzytelnianie LDAP w usłudze ownCloud Infinite Scale

Jak skonfigurować uwierzytelnianie LDAP w usłudze ownCloud Infinite Scale

Skonfiguruj logowanie oparte na protokole LDAP dla ownCloud Infinite Scale, mapuj użytkowników i grupy, wybierz wbudowany lub zewnętrzny OIDC, chroń dane uwierzytelniające i bezpiecznie weryfikuj uwierzytelnianie.

Jak przeprowadzić migrację z ownCloud 10 Classic do ownCloud Infinite Scale

Jak przeprowadzić migrację z ownCloud 10 Classic do ownCloud Infinite Scale

Zaplanuj migrację z ownCloud Classic 10 do Infinite Scale z obsługiwaną aplikacją migrate-to-ocis. Dowiedz się, co podlega transferowi, a co nie, jakie są wymagania wstępne LDAP, polecenia i kontrole przełączenia.

Jak skonfigurować niestandardowe reguły SpamAssassin w Zimbra (bezpiecznie)

Jak skonfigurować niestandardowe reguły SpamAssassin w Zimbra (bezpiecznie)

Dowiedz się, gdzie Zimbra ładuje niestandardowe reguły SpamAssassin, jak pisać i weryfikować reguły .cf, ponownie uruchamiać Amavis, testować nagłówki wiadomości i bezpiecznie przywracać poprzednią wersję.

Jak tworzyć kopie zapasowe i przywracać poszczególne skrzynki pocztowe w Zimbra CE

Jak tworzyć kopie zapasowe i przywracać poszczególne skrzynki pocztowe w Zimbra CE

Twórz kopie zapasowe i przywracaj pojedyncze skrzynki pocztowe Zimbra CE za pomocą zmmailbox. Wyeksportuj archiwum ZIP z metadanymi, zweryfikuj je i przetestuj odzyskiwanie bezpiecznie na koncie testowym.

Jak skonfigurować limity pamięci masowej dla użytkowników w oCIS ownCloud

Jak skonfigurować limity pamięci masowej dla użytkowników w oCIS ownCloud

Dowiedz się, jak ustawić limit przestrzeni osobistej dla użytkownika ownCloud Infinite Scale, odróżnić go od limitów przestrzeni projektu i limitów globalnych oraz przypisać wartości domyślne nowym użytkownikom według roli.

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

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

Diagnozuj przekroczenia limitu czasu rejestracji SIP w urządzeniu BigBlueButton FreeSWITCH, sprawdzając stan usługi, odbiorniki SIP i ESL, adresy NAT, reguły zapory sieciowej i dzienniki.

Jak naprawić błąd „Odmowa połączenia” w aplikacji mobilnej ownCloud

Jak naprawić błąd „Odmowa połączenia” w aplikacji mobilnej ownCloud

Napraw błędy odrzucenia połączenia z aplikacją mobilną ownCloud, sprawdzając adres URL serwera, port HTTPS, serwer WWW, zaporę sieciową, serwer proxy, protokół TLS i zaufane domeny.

Jak ograniczyć rejestrację użytkowników na serwerze Matrix hostowanym samodzielnie

Jak ograniczyć rejestrację użytkowników na serwerze Matrix hostowanym samodzielnie

Porównaj sposoby kontrolowania nowych kont Matrix w Synapse, od wyłączania rejestracji publicznej po wydawanie tokenów o ograniczonym zastosowaniu, z przykładami konfiguracji i sprawdzeniami.