pengshp/minidlna

ReadyMedia (原MiniDLNA) 镜像文档

镜像概述和主要用途

ReadyMedia（前身为MiniDLNA）是一款简单的媒体服务器软件，旨在完全兼容DLNA/UPnP-AV客户端。它能够将存储的媒体文件（如音乐、视频、图片）共享到支持DLNA/UPnP协议的设备上，如智能电视、音响、游戏机等。

项目地址：<[***]>

核心功能和特性

• 完全兼容DLNA/UPnP-AV标准，支持主流客户端设备
• 轻量级设计，资源占用低，运行稳定
• 支持媒体文件自动索引和共享
• 支持自定义配置，可灵活调整媒体库路径和服务参数

使用场景和适用范围

• 家庭网络媒体共享：将电脑或服务器上的媒体文件共享到智能电视、音响等设备播放
• 小型办公环境媒体分发：便捷地在多设备间共享培训视频、演示材料等
• 个人媒体中心搭建：构建个人化的媒体存储和播放系统

使用方法和配置说明

Docker Compose 部署

1. 创建 compose.yaml 文件

yaml
version: '3.9'

services:
  minidlna:
    image: pengshp/minidlna:latest
    container_name: minidlna
    volumes:
      - ./data:/media  # 媒体文件存储目录，将本地媒体文件放入此目录
      - ./config/:/etc/minidlna/  # 配置文件目录，用于持久化配置
    network_mode: host  # 使用主机网络模式，确保DLNA设备能够发现服务
    environment:
      - PUID=1000  # 运行容器的用户ID，确保对挂载目录有读写权限
      - PGID=1000  # 运行容器的用户组ID
      - TZ='Asia/Shanghai'  # 设置时区
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

2. 启动服务

在 compose.yaml 文件所在目录执行以下命令启动服务：

sh
docker compose up -d

3. 查看日志

启动后可通过以下命令查看服务日志，确认服务运行状态：

sh
docker compose logs -f -n 20

配置说明

卷挂载

• ./data:/media：本地媒体文件目录，需将需要共享的媒体文件放入此目录，容器会自动索引其中的媒体内容
• ./config/:/etc/minidlna/：配置文件目录，可在其中放置自定义的 minidlna.conf 配置文件，实现高级配置

环境变量

• PUID：运行容器的用户ID，建议设置为当前用户ID（可通过 id -u 命令查看）
• PGID：运行容器的用户组ID，建议设置为当前用户组ID（可通过 id -g 命令查看）
• TZ：时区设置，如 'Asia/Shanghai'（上海时区）、'Europe/London'（伦敦时区）等

网络模式

使用 network_mode: host 可确保DLNA服务能够被局域网内的设备发现，这是DLNA协议正常工作的必要条件。