croc/minidlna

docker-minidlna 镜像文档

概述

docker-minidlna 是一个 Docker 化的 minidlna 媒体服务器实现，基于轻量级设计，用于通过 DLNA/UPnP 协议在局域网内共享音频、视频和图片文件。容器化部署简化了安装与配置流程，适用于家庭或小型网络环境中实现多设备媒体共享。

核心功能与特性

• DLNA/UPnP 协议支持：兼容标准 DLNA/UPnP 协议，可被智能电视、音响、手机等设备发现并访问
• 媒体自动索引：自动扫描指定目录下的媒体文件并建立索引，支持增量更新
• 多格式支持：兼容常见音频（MP3、FLAC 等）、视频（MP4、MKV 等）和图片（JPG、PNG 等）格式
• 轻量级设计：资源占用低，适合在树莓派等嵌入式设备或低配置服务器上运行
• 灵活配置：支持通过环境变量或配置文件自定义媒体目录、服务器名称等参数

使用场景与适用范围

• 家庭局域网内共享媒体文件，供智能电视、机顶盒、无线音响等设备播放
• 个人媒体中心搭建，集中管理并共享本地存储的音视频资源
• 嵌入式设备（如树莓派）作为轻量级媒体服务器，低功耗运行

使用方法与配置说明

基本部署（docker run）

bash
docker run -d \
  --name minidlna \
  --net=host \  # 推荐使用host网络以确保UPnP正常发现
  -v /path/to/your/media:/media \  # 挂载本地媒体目录到容器内/media
  -e FRIENDLY_NAME="My MiniDLNA Server" \  # 自定义服务器名称
  -e MEDIA_DIR=/media \  # 指定媒体文件目录（容器内路径）
  crocandr/docker-minidlna

端口映射（非host网络模式）

若不使用--net=host，需映射必要端口：

bash
docker run -d \
  --name minidlna \
  -p 8200:8200 \  # HTTP控制端口
  -p 1900:1900/udp \  # UPnP发现端口（UDP）
  -v /path/to/your/media:/media \
  -e FRIENDLY_NAME="My MiniDLNA Server" \
  crocandr/docker-minidlna

环境变量配置

持久化配置（可选）

如需自定义minidlna.conf配置文件，可挂载配置文件到容器内/etc/minidlna.conf：

bash
docker run -d \
  --name minidlna \
  --net=host \
  -v /path/to/your/media:/media \
  -v /path/to/your/minidlna.conf:/etc/minidlna.conf \
  crocandr/docker-minidlna

docker-compose 部署示例

yaml
version: '3'
services:
  minidlna:
    image: crocandr/docker-minidlna
    container_name: minidlna
    network_mode: host  # 推荐使用host网络确保UPnP发现
    volumes:
      - /home/user/media:/media  # 本地媒体目录
    environment:
      - FRIENDLY_NAME=Home Media Server
      - MEDIA_DIR=/media/music:/media/videos:/media/photos
    restart: unless-stopped

注意事项

• 使用--net=host网络模式可确保UPnP设备发现功能正常，尤其在复杂网络环境中
• 媒体文件更新后，minidlna会自动重新索引（默认每小时扫描一次），也可通过重启容器立即更新索引
• 确保挂载的媒体目录权限正确，容器内用户需有读取权限

更多信息

详细配置与更新请参考项目GitHub仓库：https://github.com/crocandr/docker-minidlna