leoverto/mumble-web

mumble-web镜像说明

镜像概述

mumble-web是一个HTML5版的Mumble客户端，可在现代浏览器中使用。它通过Websockets处理控制指令，WebRTC（或Websockets fallback）传输语音，支持Opus等编解码器，无需安装桌面客户端即可访问Mumble服务器。

核心功能

1. 浏览器端语音支持：通过WebRTC（优先）或Websockets fallback实现语音传输
2. 编解码器支持：WebRTC模式仅支持Opus；fallback模式支持Opus和CELT Alpha
3. 主题切换：默认MetroMumbleLight主题，支持深色主题MetroMumbleDark（通过theme=dark参数切换）
4. Matrix集成：可作为Matrix房间小部件使用，自动同步用户信息
5. 轻量部署：通过Docker快速启动，配合反向代理即可提供服务

使用场景

• 团队远程协作时的浏览器端语音沟通
• 无需安装桌面客户端即可访问Mumble服务器
• Matrix房间内的语音会议集成
• 低配置设备上的轻量级语音聊天需求

配置说明

Docker部署示例

基础运行

bash
docker run -d -p 8080:80 --name mumble-web leoverto/mumble-web

（注：需配合mumble-web-proxy和反向代理（如NGINX/Caddy）以支持安全Websocket连接）

配合NGINX的反向代理配置

nginx
server {
    listen 443 ssl;
    server_name voice.example.com;
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:8080;
    }
    location /demo {
        proxy_pass http://<proxybox>:64737;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
    }
}

map $http_upgrade $connection_upgrade {
    default upgrade;
    '' close;
}

主题配置

访问页面时添加theme=dark参数切换为深色主题，例如： https://voice.example.com/?theme=dark

Matrix小部件集成

在Matrix房间中创建自定义状态事件，配置URL参数以同步用户信息：

json
{
  "waitForIframeLoad": true,
  "name": "Mumble",
  "creatorUserId": "@your_user:your_server",
  "url": "https://voice.example.com/?address=voice.example.com&port=443/demo&matrix=true&username=$matrix_display_name&theme=$theme",
  "data": {},
  "type": "customwidget",
  "id": "mumble"
}

注意事项

• 需部署mumble-web-proxy以支持WebRTC模式连接标准Mumble服务器
• fallback模式性能较低，建议优先使用WebRTC模式
• 更新镜像时需备份dist/config.local.js以保留自定义配置
• 遵循ISC开源许可证使用该镜像