universalmediaserver/ums

Universal Media Server 镜像文档

概述和主要用途

Universal Media Server是一款符合DLNA标准的UPnP媒体服务器，主要用于在各类现代设备间共享视频、音频和图片文件。该服务器最初基于shagrath开发的PS3 Media Server优化而来，旨在提供更高的稳定性和文件兼容性，支持家庭或小型网络环境中的媒体内容无缝共享。

核心功能和特性

• 多协议支持：全面兼容DLNA、UPnP协议，并支持HTTP(S)传输，确保与智能电视、手机、平板、游戏机等多种设备的互联互通。
• 跨平台兼容性：提供Windows、Linux和macOS版本，可部署于不同操作系统环境。
• 媒体处理能力：支持流式传输和实时转码多种媒体格式，配置需求低，多数场景下无需复杂设置即可直接使用。
• 丰富工具集成：整合FFmpeg、MediaInfo、OpenSubtitles、Crowdin、MEncoder、tsMuxeR、AviSynth、VLC等核心工具，凭借这些组件的协同工作，实现对广泛媒体格式的支持。

使用场景和适用范围

• 家庭媒体中心：适用于家庭网络环境，实现电视、电脑、手机等设备间的媒体文件共享，满足多终端播放需求。
• 跨设备媒体传输：当需要在不同品牌、不同系统的设备间传输媒体内容时，提供标准化的协议支持，减少兼容性问题。
• 复杂格式媒体管理：对于包含多种编码格式的媒体文件库，可通过内置转码功能确保各类设备正常播放，提升媒体使用灵活性。

使用方法和配置说明

基础部署示例（Docker Run）

bash
docker run -d \
  --name=universal-media-server \
  -p 1900:1900/udp \  # UPnP设备发现端口
  -p 2869:2869/tcp \  # SSDP服务端口
  -p 8001:8001/tcp \  # HTTP控制界面端口
  -v /本地媒体目录:/media \  # 挂载本地媒体文件目录（需替换为实际路径）
  -v /本地配置目录:/config \  # 挂载配置文件持久化目录（需替换为实际路径）
  universalmediaserver/universalmediaserver

关键配置说明

• 端口映射：必须映射UPnP发现（1900/udp）、SSDP服务（2869/tcp）和HTTP控制界面（8001/tcp）端口，具体端口可根据网络环境调整。
• 目录挂载：
  • /media：存放待共享的媒体文件（视频、音频、图片），需确保容器对该目录有读取权限。
  • /config：用于保存服务器配置文件，避免容器重启后配置丢失。
• 高级配置：可通过修改配置目录中的UMS.conf文件调整转码参数、设备权限、网络设置等，详细配置项参考官方文档。