leakypixel/gmrender

gmrender Docker镜像文档

镜像概述

本镜像基于最新的debian:stable基础镜像构建，用于运行gmrender-resurrect（GMediaRender的分支），实现DLNA/UPnP媒体渲染功能，可接收并播放来自DLNA/UPnP服务器的媒体内容。

核心功能与特性

• 基础环境：基于debian:stable，提供稳定的运行环境
• 参数自定义：支持通过覆盖Docker COMMAND来自定义gmrender-resurrect运行参数
• 网络支持：需使用host网络模式以确保UPnP功能正常
• 配置灵活性：支持通过环境变量和卷挂载进行配置，满足不同使用需求

使用场景

适用于需要DLNA/UPnP媒体渲染功能的场景，如：

• 家庭媒体中心，接收来自DLNA服务器的音频/视频流
• 智能音箱或音响设备的媒体播放扩展
• 多设备间的媒体内容共享与播放

使用方法与配置说明

基本运行方式

通过docker run命令运行，可直接覆盖COMMAND来自定义gmrender参数：

bash
docker run leakypixel/gmrender your-gmediarender-args

Docker Compose配置示例

推荐使用docker-compose进行配置管理，以下为完整示例：

yaml
gmrender:
    image: leakypixel/gmrender
    restart: unless-stopped
    network_mode: host  # 目前需使用host网络以支持UPnP功能
    environment:
      - 'DBUS_SESSION_BUS_ADDRESS=unix:path=/run/dbus/system_bus_socket'  # DBus会话总线地址
    volumes:
      - '/etc/localtime:/etc/localtime:ro'  # 挂载本地时间，确保时间同步
      - '/run/dbus/system_bus_socket:/run/dbus/system_bus_socket'  # 用于avahi服务发布
      - 'fifo:/tmp/:rw'  # FIFO文件挂载，用于音频输出
      - '/etc/machine-id:/etc/machine-id:ro'  # 挂载机器ID，确保设备标识一致
    entrypoint: gmediarender
    command: ["--gstout-audiopipe=audioresample ! audioconvert ! audio/x-raw,rate=48000,channels=2,format=S16LE ! wavenc ! filesink location=/tmp/dlna-fifo", "--logfile=stdout"]  # 自定义音频管道和日志输出

关键配置说明

• network_mode: host：必须使用host网络模式，以确保UPnP发现和通信功能正常
• 环境变量：DBUS_SESSION_BUS_ADDRESS指定DBus总线地址，用于服务通信
• 卷挂载：
  • /etc/localtime：只读挂载，确保容器时间与主机同步
  • /run/dbus/system_bus_socket：用于avahi服务发布，实现设备发现
  • fifo:/tmp/：读写挂载，用于音频FIFO文件输出
  • /etc/machine-id：只读挂载，确保设备唯一标识一致
• command参数：可根据需求自定义gmrender-resurrect参数，如音频处理管道、日志输出位置等