Mumble¶

В этой статье

• Mumble. Основные возможности
• Особенности сборки
• Начало работы после развертывания Mumble
• Настройка клиента
• Подключение к серверу
• Управление сервером
• Безопасность и обслуживание
• Заказ Mumble с помощью API

Mumble. Основные возможности¶

• Кроссплатформенная поддержка - клиентские приложения доступны для Windows, Linux, macOS, iOS и Android.
• Низкая задержка и высокое качество звука за счет использования аудио-кодека Opus.
• Шифрование голосового трафика по протоколу TLS для обеспечения конфиденциальности разговоров.
• Возможность масштабирования до тысяч одновременных пользователей на одном сервере.
• Поддержка пространственного звука и направленной речи для имитации реалистичного звука в играх и виртуальной реальности.
• Архитектура плагинов, позволяющая расширять функциональность как клиентских, так и серверных компонентов.

Особенности сборки¶

• Установленное ПО:
  • Mumble server в Docker-контейнере.
• Расположение ключевых файлов (внутри Docker-контейнера):
  • Конфигурационный файл: /etc/mumble-server.ini;
  • База данных: /mumble/mumble-server.sqlite;
  • Лог-файл: /mumble/mumble-server.log;
  • PID файл: /run/mumble-server/mumble-server.pid.

Начало работы после развертывания Mumble¶

После оплаты заказа на указанную при регистрации электронную почту придет уведомление о готовности сервера к работе. В нем будет указан IP-адрес VPS, а также логин и пароль для подключения. Управление оборудованием клиенты нашей компании осуществляют в панели управления серверами и API — Invapi.

• Логин и Пароль для подключения к серверу: приходят в письме на вашу электронную почту при готовности сервера к работе после развертывания ПО.

Получение пароля администратора¶

Шаг 1: Подключитесь к серверу по SSH:

ssh root@ВАШ_IP_АДРЕС

Шаг 2: Найдите ID Docker-контейнера с Mumble:

docker ps

В выводе будет строка примерно такая:

CONTAINER ID   IMAGE                  COMMAND        PORTS
a1f296c17976   ajmandourah/mumble    /start.sh    0.0.0.0:64738->64738/tcp,
                                                  0.0.0.0:64738->64738/udp

Запомните CONTAINER ID (первый столбец): a1f296c17976

Шаг 3: Войдите в контейнер и просмотрите лог:

docker exec -it <ID_контейнера> /bin/bash

tail -100 /mumble/mumble-server.log | grep Password for 'SuperUser'

Вывод покажет что-то вроде:

<W>2025-12-19 10:15:23.456 Password for 'SuperUser' set to 'aB3dE7gH9kL2'

Сохраните этот пароль!

docker exec -it <ID_контейнера> murmurd -ini /etc/mumble-server.ini -supw НовыйПароль123

murmurd -ini /etc/mumble-server.ini -supw НовыйПароль123

Шаг 4: Выйдите из контейнера и проверьте работу сервера:

exit

docker ps

Настройка клиента¶

Для начала работы с сервисом необходимо скачать клиент Mumble на локальное устройство и установить его.

При первом запуске будет необходимо выполнить первоначальную настройку оборудования через мастер настройки:

1. Устройство ввода и вывода - можно оставить варианты по умолчанию, а также выбрать дополнительные настройки (опционально):

   • Использовать подавление эха;
   • Включить позиционирование звука;
   • Приглушать звук в других приложениях, когда другие пользователи говорят.

2. Исходящая задержка оборудования - установить в минимальное значение с помощью ползунка;

3. Громкость микрофона - настроить уровень;

4. Голосовая активность - определить порог (на этом шаге также можно назначить кнопку для активации голосовой связи);

5. Качество и уведомления - установить настройки;

6. Затухание позиционного звука - выполнить регулировку;

7. Аутентификация по сертификату - рекомендуется выбрать вариант Автоматическое создание сертификата;

8. Нажать кнопку Завершить.

Смена языка интерфейса¶

Интерфейс Mumble по умолчанию на английском языке. Для изменения настроек языка:

1. Закройте список серверов;
2. Перейдите по пути: Configure → Settings → User Interface → Language;
3. Выберите русский (или любой иной из выпадающего списка);
4. Нажмите кнопки Apply и OK:

Приложение перезапустится с русским интерфейсом.

Настройка исходящего звука¶

После подключения к серверу рекомендуется настроить клиент Mumble. Все параметры доступны в меню Configure → Settings (или Настройка → Параметры в русской версии) в десктопных версиях или в настройках приложения на мобильных клиентах.

Качество звука¶

Mumble использует кодек Opus с настраиваемым целевым качеством передачи звука.

Раздел: Исходящий звук → Сжатие → Качество

• 40 кбит/с - стандартное значение, достаточно для комфортной голосовой связи
• 64-96 кбит/с - высокое качество для музыки или профессионального аудио
• 32 кбит/с - экономия трафика (мобильный интернет), возможно снижение качества

Режимы передачи звука¶

Раздел: Исходящий звук → Передача звука

По умолчанию используется режим Активация по голосу (Voice Activity). В этом режиме микрофон автоматически включается при обнаружении речи.

Настройка чувствительности:

• Ползунки позволяют настроить порог срабатывания;
• Избегайте передачи фоновых шумов;
• Обеспечьте корректное распознавание голоса.

Альтернативные режимы:

• Push-to-Talk - микрофон активируется только при нажатии кнопки (рекомендуется для шумных сред);
• Continuous - микрофон работает постоянно (не рекомендуется).

Обработка звука¶

Раздел: Исходящий звук → Обработка звука

Клиент поддерживает алгоритмы шумоподавления:

• Speex - классический алгоритм;
• RNNoise - более эффективен при подавлении постоянных фоновых шумов (работа вентилятора, кондиционера, клавиатуры).

Можно использовать оба алгоритма совместно для максимального эффекта.

Шумоподавление:

• Регулируйте ползунок силы шумоподавления Speex;
• Включите RNNoise для дополнительной фильтрации;
• Комбинируйте оба метода для лучшего результата.

Эхоподавление¶

Параметры эхоподавления следует подбирать в зависимости от используемого оборудования:

• При работе с колонками - более агрессивный режим эхоподавления;
• При использовании наушников - эхоподавление можно отключить.

Настройка входящего звука¶

Буферизация¶

Раздел: Входящий звук

Два ключевых параметра влияют на стабильность воспроизведения:

1. Стандартный буфер (Default Jitter Buffer)

• Накапливает входящее аудио перед воспроизведением;
• Компенсирует нестабильность сети;
• По умолчанию: 10 мс;
• Когда увеличивать: если речь заикается когда люди начинают говорить.

2. Задержка вывода (Output Delay)

• Добавляет буферизацию перед выводом звука;
• Когда увеличивать: если слышите быстрое заикание или артефакты на некоторых аудиодрайверах.

Громкость и приглушение¶

• Регулируйте громкость ползунком в клиенте или через системный микшер;
• Автоматическое приглушение (Attenuation) - полезная функция, которая автоматически убавляет музыку или звуки игры, когда кто-то говорит.

Проверка настроек¶

Для проверки используйте Петлевое тестирование (Loopback Test):

• Локальный режим - проверяет ввод и вывод звука;
• Серверный режим - тестирует сетевое соединение.

Уведомления и чат¶

Раздел: Уведомления

В этом разделе можно гибко настроить, какие события будут:

• Отображаться в окне сообщений;
• Сопровождаться звуковым сигналом;
• Озвучиваться с помощью Text-to-Speech.

По умолчанию включены основные уведомления:

• Подключение и отключение пользователей;
• Критичные сообщения и предупреждения.

Подключение к серверу¶

Для подключения к серверу Mumble используются следующие учетные данные:

• Логин - SuperUser;
• Пароль - автоматически сгенерированный пароль (полученный из логов).

Процесс подключения¶

Шаг 1: Запустите клиент Mumble и нажмите кнопку Добавить новый...

Шаг 2: Заполните форму подключения:

• Название: любое имя для вашего сервера;
• Адрес: IP-адрес вашего VPS;
• Порт: 64738 (по умолчанию, если не меняли);
• Имя пользователя: SuperUser;
• Пароль: пароль из логов сервера.

Шаг 3: Нажмите OK, выберите сервер из списка и нажмите Подключиться.

Шаг 4: При первом подключении клиент покажет предупреждение о самоподписанном SSL-сертификате - это нормально для нового сервера, нажмите Да.

После подключения вы окажетесь в корневом канале с именем SuperUser и иконкой администратора.

Подключение обычных пользователей¶

Для подключения к серверу обычным пользователям нужно:

1. Добавить новый сервер в клиенте Mumble;
2. Указать IP-адрес сервера;
3. Указать порт 64738;
4. Придумать себе имя пользователя;
5. Пароль не требуется для обычных пользователей.

Управление сервером¶

Создание структуры каналов¶

По умолчанию есть только корневой канал. Для удобства создадим несколько под-каналов.

Создание канала:

1. Правой кнопкой мыши по корневому каналу;
2. Добавить;
3. Введите название канала.

Пример структуры:

Root (Корневой канал)
├── Общая комната
├── Игры
│   ├── Counter-Strike
│   └── Dota 2
├── Работа
│   ├── Встречи
│   └── Общение
└── AFK (для отошедших)

Права доступа к каналам¶

Права доступа настраиваются через контекстное меню канала:

1. Правой кнопкой по каналу → Редактировать;
2. Вкладка Права доступа (ACL):

Что можно настроить:

• Установить пароль на канал;
• Ограничить доступ определенным группам пользователей;
• Разрешить/запретить говорить в канале;
• Настроить права на создание подканалов.

Управление пользователями¶

Регистрация пользователей¶

Как пользователь регистрируется:

1. Подключается к серверу с любым именем;
2. Правый клик по своему имени → Зарегистрироваться;
3. Сервер запоминает сертификат пользователя.

После регистрации:

• Пользователь автоматически подключается при следующем входе;
• Имя пользователя зарезервировано;
• Можно назначать права доступа.

Ручное создание учетных записей¶

Администратор может создавать учетные записи вручную:

1. Меню Сервер → Зарегистрированные пользователи → Добавить;
2. Введите имя пользователя.

Безопасность и обслуживание¶

Смена порта¶

Стандартный порт 64738 легко найти сканерами. Если хотите усложнить обнаружение сервера, можно сменить порт на любой другой.

Шаг 1: Копируем конфиг на хост:

docker cp <ID_контейнера>:/etc/mumble-server.ini ./mumble-server.ini

Шаг 2: Редактируем конфиг:

nano mumble-server.ini

Находим строку port=64738 и меняем на нужный порт, например:

port=25000

Шаг 3: Копируем обратно:

docker cp ./mumble-server.ini <ID_контейнера>:/etc/mumble-server.ini

Шаг 4: Перезапускаем сервер:

docker restart <ID_контейнера>

Шаг 5: Теперь пользователи должны указывать новый порт при подключении:

IP:новый_порт

Резервное копирование¶

Резервное копирование важно, если вы используете Mumble не только для семейного общения.

База данных Mumble с настройками пользователей и каналов лежит в /mumble/mumble-server.sqlite внутри контейнера.

Ручное резервное копирование¶

Периодически копируйте базу себе:

docker cp <ID_контейнера>:/mumble/mumble-server.sqlite ./mumble-backup-$(date +%Y%m%d).sqlite

Эта команда создаст файл с текущей датой, например: mumble-backup-20250112.sqlite

Восстановление из резервной копии¶

Если сервер умрет, вы сможете развернуть новый контейнер и восстановить все настройки:

docker cp ./mumble-backup-ДАТА.sqlite <ID_нового_контейнера>:/mumble/mumble-server.sqlite

docker restart <ID_нового_контейнера>

Заказ Mumble с помощью API¶

Для установки данного ПО с использованием API следуйте этой инструкции.