m0wer/murmur

Murmur Docker容器

---

• https://github.com/m0wer/murmur/issues

---

镜像概述和主要用途

Murmur Docker容器是Mumble语音聊天服务器的Docker化部署方案。Mumble是一款开源、低延迟、高质量的语音聊天软件，Murmur作为其服务器端，可用于搭建私人或公共语音通信服务，适用于游戏团队、远程协作、社区交流等场景。该容器提供持久化存储、SSL证书支持和灵活的配置选项，简化了Murmur服务器的部署和管理流程。

核心功能和特性

• 持久化存储：通过卷挂载支持配置文件、数据、日志和SSL证书的持久化
• 端口暴露：同时支持TCP和UDP协议的64738端口，满足Murmur通信需求
• 环境变量配置：提供丰富的环境变量，支持用户ID/组ID设置、调试模式、自定义启动参数等
• SSL证书集成：支持自定义SSL证书（如Let's Encrypt），自动更新配置
• 灵活部署：支持直接docker run命令部署或通过Docker Compose管理

使用场景和适用范围

• 游戏团队语音通信服务器
• 远程办公团队协作沟通平台
• 社区或兴趣小组实时语音交流
• 需要低延迟、高质量语音服务的场景

使用方法和配置说明

暴露的卷

容器暴露以下四个卷，用于数据持久化和配置：

• /opt/murmur/cert - Murmur SSL证书文件
• /opt/murmur/config - Murmur配置文件
• /opt/murmur/data - Murmur数据库和其他数据文件
• /opt/murmur/log - Murmur日志文件（用于故障排查）

暴露的端口

容器暴露以下两个端口：

• 64738/tcp - Murmur服务器TCP端口
• 64738/udp - Murmur服务器UDP端口

基本运行方式

bash
$ docker run --name murmur -d \
    -p 64738:64738/udp -p 64738:64738 \
    m0wer/murmur

推荐：通过Docker Compose运行

建议使用Docker Compose进行部署，便于管理持久化数据和配置：

yaml
version: '3'

services:
  murmur:
    image: m0wer/murmur
    container_name: murmur
    ports:
      - 64738:64738
      - 64738:64738/udp
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - ./cert:/opt/murmur/cert
      - ./config:/opt/murmur/config
      - ./data:/opt/murmur/data
      - ./log:/opt/murmur/log
    environment:
      - TZ=UTC

https://raw.githubusercontent.com/m0wer/murmur/master/examples/docker-compose.yml

环境变量

SSL自定义证书支持（Let's Encrypt等）

1. 将Docker主机的证书存储位置或卷映射到容器暴露的/opt/murmur/cert卷
2. 必须包含与SSL证书对应的PEM格式SSL私钥，私钥文件必须命名为privkey.pem
3. 必须包含PEM格式的SSL证书文件（包含完整证书链）。Let's Encrypt会自动处理，其他提供商可能需要手动操作（参考[***]
4. 启动容器。如果检测到SSL证书文件，启动过程会自动更新murmur.ini中的sslCert和sslKey路径。状态、错误等信息可在容器日志中查看，例如：docker logs <容器名称>

如果不想使用自定义SSL证书，可以不映射/opt/murmur/cert卷。或者，如果privkey.pem和/或fullchain.pem文件不存在，将跳过SSL自定义配置。

要从自定义证书恢复为Murmur自签名证书：停止容器，将/DATA_VOLUME/murmur/cert中的privkey.pem和fullchain.pem重命名或删除。然后编辑/DATA_VOLUME/murmur/config中的murmur.ini文件，将sslCert=/opt/murmur/cert/fullchain.pem改为;sslCert=，将sslKey=/opt/murmur/cert/privkey.pem改为;sslKey=，保存文件并重启容器。