Исправление подмены URL на IP адрес в BigBlueButton

Дата: 2026-01-10
Проблема: При переходе по ссылке https://school.cdto.life/rooms/... происходит подмена URL на IP адрес https://89.179.242.240/html5client/?sessionToken=...
Домен: school.cdto.life

Выявленная проблема

В конфигурационных файлах BigBlueButton был установлен IP адрес (89.179.242.240) вместо доменного имени (school.cdto.life), что приводило к тому, что BigBlueButton генерировал ссылки с IP адресом вместо домена.

Выполненные исправления

1. Использование команды bbb-conf --setip

Команда: bbb-conf --setip school.cdto.life

Эта команда автоматически обновляет основные конфигурационные файлы:
- /etc/bigbluebutton/bbb-web.properties - bigbluebutton.web.serverURL
- /etc/bigbluebutton/bbb-apps-akka.conf - bbbWebAPI
- /usr/local/bigbluebutton/core/scripts/bigbluebutton.yml - конфигурация записей

Результат:

bigbluebutton.web.serverURL=https://school.cdto.life
bbbWebAPI="https://school.cdto.life/bigbluebutton/api"

2. Исправление файла bbb-html5.yml

Файл: /etc/bigbluebutton/bbb-html5.yml

Этот файл не обновляется автоматически через bbb-conf --setip, поэтому было выполнено ручное исправление:

Исправленные параметры:

public:
  kurento:
    wsUrl: wss://school.cdto.life/bbb-webrtc-sfu  # было: wss://89.179.242.240/bbb-webrtc-sfu
  pads:
    url: https://school.cdto.life/pad  # было: https://89.179.242.240/pad

3. Перезапуск BigBlueButton

После изменения конфигурации был выполнен перезапуск BigBlueButton:

bbb-conf --restart

Текущая конфигурация

Обновленные файлы

  1. /etc/bigbluebutton/bbb-web.properties:
    bigbluebutton.web.serverURL=https://school.cdto.life

  2. /etc/bigbluebutton/bbb-apps-akka.conf:
    bbbWebAPI="https://school.cdto.life/bigbluebutton/api"

  3. /etc/bigbluebutton/bbb-html5.yml:
    yaml public: kurento: wsUrl: wss://school.cdto.life/bbb-webrtc-sfu pads: url: https://school.cdto.life/pad

Файлы, которые не нужно изменять

  1. /etc/bigbluebutton/bbb-webrtc-sfu/production.yml:
  2. announcedIp: 89.179.242.240 - должен оставаться IP адресом для WebRTC

  3. Это технический параметр для медиа-сервера, не влияет на URL

  4. /etc/turnserver.conf:

  5. external-ip=89.179.242.240 - должен оставаться IP адресом для TURN сервера
  6. Это технический параметр для NAT traversal

Проверка

Проверка конфигурации

# Проверка bbb-web.properties
lxc exec BBB-CONT22-1 -- cat /etc/bigbluebutton/bbb-web.properties | grep serverURL

# Проверка bbb-apps-akka.conf
lxc exec BBB-CONT22-1 -- cat /etc/bigbluebutton/bbb-apps-akka.conf | grep bbbWebAPI

# Проверка bbb-html5.yml
lxc exec BBB-CONT22-1 -- cat /etc/bigbluebutton/bbb-html5.yml

Ожидаемый результат: Все URL должны содержать school.cdto.life, а не 89.179.242.240

Тестирование

  1. Перейдите на https://school.cdto.life/rooms/pgk-gvu-bkg-ole
  2. Нажмите "Присоединиться к встрече"
  3. Проверьте, что URL в браузере остался https://school.cdto.life/html5client/?sessionToken=...
  4. URL не должен подменяться на IP адрес 89.179.242.240

Важные замечания

Разница между URL и IP адресами

  1. URL (доменные имена) - используются для:
  2. Генерации ссылок в приложении
  3. API endpoints
  4. WebSocket соединений

  5. HTML5 клиента

  6. IP адреса - используются для:

  7. WebRTC медиа-серверов (announcedIp)
  8. TURN серверов (external-ip)
  9. Технических параметров сетевого уровня

При использовании bbb-conf --setip

Команда bbb-conf --setip принимает:
- Доменное имя (например: school.cdto.life) - рекомендуется
- IP адрес (например: 89.179.242.240) - не рекомендуется, так как вызывает подмену URL

Важно: Всегда используйте доменное имя при настройке BigBlueButton.

Связанные документы

  • /home/cdto/DENKART/docs/operations/bbb-ice-1107-1020-fix.md - Исправление ошибок ICE 1107 и 1020
  • /home/cdto/DENKART/docs/operations/school-cdto-life-502-fix.md - Исправление проблемы доступа к school.cdto.life

Следующие шаги

  1. ✅ Исправлена конфигурация BigBlueButton
  2. ✅ Сервисы перезапущены
  3. ⏳ Тестирование - проверьте, что URL больше не подменяется на IP адрес
  4. ⏳ Проверка других ссылок - убедитесь, что все ссылки используют доменное имя

Статус: ✅ Проблема исправлена
Дата последнего обновления: 2026-01-10