Mumble¶

在这篇文章中

Mumble 关键特性

部署功能

部署 Mumble 后的入门指南

客户端配置

连接到服务器

服务器管理

安全与维护

视频教程

使用 API 订购带有 Mumble 的服务器

信息

Mumble 是一款免费且开源的 VoIP 软件，采用客户端-服务器架构。用户可以在同一服务器上通过语音进行实时通信。Mumble 服务器可以为不同的社区和用户组进行单独配置和管理。 Mumble 常用于在线游戏期间的语音通信，以及组织内部的语音会议和远程团队协作。

Mumble 关键特性¶

该平台提供适用于 Windows、Linux、macOS、iOS 和 Android 的客户端应用程序，实现跨平台兼容。
使用 Opus 音频编解码器以确保低延迟和高音质。
语音流量使用 TLS 协议加密，以保持对话的机密性。
服务器可处理数千名同时在线用户，具有高度可扩展性。
支持空间音频和定向语音，为游戏和虚拟现实提供逼真的音频体验。
插件架构可用于扩展客户端和服务器组件的功能。

部署功能¶

ID	软件名称	兼容操作系统	虚拟机	物理机	vGPU	GPU	最低CPU(核)	最低内存(GB)	最低硬盘(GB)	自定义域名	是否启用
78	Mumble	Ubuntu 22.04	+	+	+	+	1	1	-	否	订购

已安装软件：
- Mumble 服务器。

备注

除非另有说明，默认情况下，我们从开发者网站或操作系统存储库安装软件的最新发布版本。

部署 Mumble 后的入门指南¶

支付订单后，当服务器准备就绪时，将向注册时指定的电子邮件发送通知。邮件中将包含 VPS 的 IP 地址以及连接所需的登录名和密码。我司客户可通过服务器硬件管理面板和 API 控制面板 — Invapi 进行管理。

服务器连接的 登录名 和密码：在软件部署完成且服务器准备就绪时，通过电子邮件发送至您的邮箱。

获取管理员密码¶

备注

SuperUser 密码在服务器首次启动时自动生成并显示在日志中。

步骤 1： 通过 SSH 连接到服务器：

ssh root@YOUR_IP_ADDRESS

步骤 2： 查找 Mumble 的 Docker 容器 ID：

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 <container_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 <container_ID> murmurd -ini /etc/mumble-server.ini -supw NewPassword123

或在容器内部：

murmurd -ini /etc/mumble-server.ini -supw NewPassword123

步骤 4： 退出容器并检查服务器是否正在运行：

exit


docker ps

客户端配置¶

要开始使用服务，您需要将 Mumble 客户端下载到本地设备并安装。

首次启动时，您需要通过配置向导完成初始设置：

设备输入和输出 - 您可以保留 default 选项，并选择其他设置（可选）：
- 使用回声抑制；
- 启用位置音频；
- 在其他用户说话时减弱应用程序音量。
设备调整 - 使用滑块设置为最小值；
音量调整 - 调整级别；
语音活动检测 - 设置阈值（在此步骤您还可以分配一个按钮来激活语音通信）；
质量与通知 - 设置偏好；
位置音频 - 调整设置；
使用现有证书 - 建议选择 Automatic certificate creation；
点击 ~~Finish~~ 按钮。

更改界面语言¶

Mumble 界面默认为英语。要更改语言设置：

关闭服务器列表；
导航至：Configure > Settings > User Interface > Language；
从下拉列表中选择语言；
点击 ~~Apply~~ 和 OK 按钮：

应用程序将以所选界面语言重启。

配置音频输出¶

连接到服务器后，建议配置 Mumble 客户端。所有设置均可在桌面版本的 Configure > Settings 菜单中，或移动客户端的应用设置中找到。

音频质量¶

Mumble 使用 Opus 编解码器，具有可调节的目标音频传输质量。

部分：音频输入 > 压缩 > 质量

40 kbit/s - 标准值，足以进行舒适的语音通信
64-96 kbit/s - 用于音乐或专业音频的高质量
32 kbit/s - 节省流量（移动网络），可能导致质量降低

备注

实际比特率可根据传输条件和服务器设置动态变化。

音频传输模式¶

部分：音频输入 > 传输

默认使用 语音活动 模式。在此模式下，检测到语音时麦克风会自动激活。

灵敏度调整：

滑块允许您调整触发阈值；
避免传输背景噪音；
确保正确的语音识别。

替代模式：

按键说话 - 仅在按下按钮时激活麦克风（推荐用于嘈杂环境）；
持续 - 麦克风持续工作（不推荐）。

音频处理¶

部分：音频输入 > 音频处理

客户端支持降噪算法：

Speex - 经典算法；
RNNoise - 在抑制恒定背景噪音（风扇、空调、键盘）方面更有效。

您可以同时使用这两种算法以获得最大效果。

降噪：

调整 Speex 降噪强度滑块；
启用 RNNoise 进行额外过滤；
结合两种方法以获得最佳结果。

回声消除¶

应根据使用的设备选择回声消除参数：

使用扬声器时 - 更激进的回声消除模式；
使用耳机时 - 可以禁用回声消除。

警告

maximum amplification 参数应谨慎更改，因为过高的值可能导致噪音放大和音频失真。

配置音频输入¶

缓冲¶

部分：音频输出

两个关键参数影响播放稳定性：

1. 默认抖动缓冲

在播放前累积传入音频；
补偿网络不稳定；
默认值： 10 ms；
何时增加： 如果人们在开始说话时出现语音卡顿。

2. 输出延迟

在音频输出前添加缓冲；
何时增加： 如果在某些音频驱动程序上听到快速卡顿或伪影。

音量和衰减¶

使用客户端中的滑块或通过系统混音器调整音量；
衰减 - 有用功能，当有人说话时自动降低音乐或游戏声音。

测试设置¶

使用 回路测试 进行验证：

本地模式 - 测试输入和输出音频；
服务器模式 - 测试网络连接。

通知和聊天¶

部分：消息

在此部分，您可以灵活配置哪些事件将：

显示在消息窗口中；
伴随声音信号；
使用文本转语音 (Text-to-Speech) 播报。

默认情况下，主要通知已启用：

用户连接和断开连接；
关键消息和警告。

连接到服务器¶

要连接到 Mumble 服务器，请使用以下凭据：

登录名 - SuperUser；
密码 - 自动生成的密码（从日志中获取）。

连接过程¶

步骤 1： 启动 Mumble 客户端并点击 ~~Add New...~~ 按钮

步骤 2： 填写连接表单：

Label： 为您的服务器指定任意名称；
Address： 您的 VPS IP 地址；
Port： 64738（默认，如果未更改）；
Username： SuperUser；
Password： 服务器日志中的密码。

在哪里找到 IP 地址

服务器 IP 地址可以在 Invapi 面板的服务器卡片上的 Network 选项卡中找到：

步骤 3： 点击 OK，从列表中选择服务器并点击 ~~Connect~~。

步骤 4： 首次连接时，客户端将显示关于自签名 SSL 证书的警告 - 对于新服务器这是正常的，点击 ~~Yes~~。

连接后，您将位于根频道，用户名为 SuperUser 并带有管理员图标。

连接普通用户¶

普通用户要连接到服务器，需要：

在 Mumble 客户端中添加新服务器；
指定服务器 IP address；
指定 端口 64738；
选择 用户名；
普通用户 无需密码。

用户身份验证

Mumble 默认不使用登录名和密码进行用户识别 - 基础是 客户端证书。

当用户首次连接到服务器时，客户端会自动生成唯一证书。当其他用户连接时，密码输入是可选的，取决于管理员配置的设置。

服务器管理¶

创建频道结构¶

默认情况下，只有根频道。为了方便起见，让我们创建几个子频道。

创建频道：

右键点击根频道；
~~Add~~；
输入频道名称。

示例结构：

Root (根频道)
├── General Room
├── Games
│   ├── Counter-Strike
│   └── Dota 2
├── Work
│   ├── Meetings
│   └── Communication
└── AFK (用于离开)

频道访问权限¶

访问权限通过频道上下文菜单配置：

右键点击频道 > Edit；
ACL 选项卡：

可配置内容：

为频道设置密码；
限制特定用户组的访问；
允许/禁止在频道中发言；
配置创建子频道的权限。

默认情况

默认情况下，所有注册用户都可以进入任何频道并发言，这对大多数情况来说是正常的。

用户管理¶

用户注册¶

用户如何注册：

使用任意名称连接到服务器；
右键点击其名称 > ~~Register~~；
服务器记住用户的证书。

注册后：

用户下次登录时自动连接；
用户名被保留；
可以分配访问权限。

重要

如果用户重新安装 Mumble 或从另一台计算机连接 - 他们将拥有不同的证书，并在服务器上显示不同的名称。

手动创建账户¶

管理员可以手动创建账户：

菜单 Server > Registered Users > Add；
输入用户名。

备注

这仅保留用户名，实际连接仍通过客户端证书进行。

安全与维护¶

更改端口¶

标准端口 64738 容易被扫描器发现。如果您想使服务器发现更加困难，可以将端口更改为任何其他端口。

端口选择

端口号应谨慎选择：

系统端口 (1-1023) - 被系统占用；
流行端口 (80, 443, 22, 25, 3306) - 可能被占用或被主机商阻止；
安全范围： 10000 到 65000

步骤 1： 将配置复制到主机：

docker cp <container_ID>:/etc/mumble-server.ini ./mumble-server.ini

步骤 2： 编辑配置：

nano mumble-server.ini

找到行 port=64738 并更改为所需端口，例如：

port=25000

步骤 3： 复制回去：

docker cp ./mumble-server.ini <container_ID>:/etc/mumble-server.ini

步骤 4： 重启服务器：

docker restart <container_ID>

步骤 5： 现在用户在连接时应指定新端口：

IP:new_port

备份¶

如果您不仅将 Mumble 用于家庭通信，备份非常重要。

包含用户和频道设置的 Mumble 数据库位于容器内的 /mumble/mumble-server.sqlite。

手动备份¶

定期将数据库复制给自己：

docker cp <container_ID>:/mumble/mumble-server.sqlite ./mumble-backup-$(date +%Y%m%d).sqlite

此命令将创建一个带有当前日期的文件，例如：mumble-backup-20250112.sqlite

从备份恢复¶

如果服务器崩溃，您可以部署新容器并恢复所有设置：

docker cp ./mumble-backup-DATE.sqlite <new_container_ID>:/mumble/mumble-server.sqlite

docker restart <new_container_ID>

备注

有关 Mumble 基本设置的更多信息，请参阅开发者文档。