mbentley/ums Docker镜像文档## 镜像概述和主要用途mbentley/ums是基于Alpine Linux构建的Universal Media Server (UMS) Docker镜像。UMS是一款开源媒体服务器软件，支持通过DLNA、UPnP等协议将本地媒体文件（视频、音频、图片）流式传输到智能电视、游戏机、移动设备等多种终端。该镜像轻量级、跨架构（支持amd64和arm64），提供灵活的配置选项和持久化存储方案，适用于家庭或小型网络的媒体共享需求。

核心功能和特性-** 轻量级基础 **：基于Alpine Linux，镜像体积小，资源占用低

-** 多架构支持 ：兼容amd64和arm64架构，适配x86服务器、ARM开发板（如树莓派）等硬件 - 版本控制 ：提供多个UMS版本标签（14.x、13.x等），满足不同功能需求 - 持久化配置 ：支持挂载配置文件（UMS.conf）、凭据文件（UMS.cred）及数据目录，确保配置持久化 - 灵活部署 **：支持host网络（自动发现）或端口映射，可通过环境变量自定义配置

镜像标签### 多架构标签| 标签 | UMS版本 | Dockerfile路径 | 基础镜像 | 架构 |

|---------------------|-----------|-------------------------------|----------------|--------------| | latest
14 | UMS 14.x | Dockerfile.14-alpine | alpine:latest | amd64、arm64 | | 14-alpine | UMS 14.x | Dockerfile.13-alpine | alpine:latest | amd64、arm64 | | 13 | UMS 13.x | Dockerfile.13-alpine | alpine:latest | amd64、arm64 | | 13-alpine | UMS 13.x | Dockerfile.13-alpine | alpine:latest | amd64、arm64 |

归档标签这些镜像仍在Docker Hub上发布，但因基础操作系统不再支持或版本过旧，不再定期更新。** 注意：这些镜像可能包含未修复的安全漏洞，使用时需格外谨慎！**| 标签 | UMS版本 | Dockerfile路径 | 基础镜像 | 架构 |

|--------------|-----------|-------------------------------|--------------------|--------------| | 11 | UMS 11.x | Dockerfile.11-alpine | alpine:latest | amd64、arm64 | | 11-alpine | UMS 11.x | Dockerfile.11-alpine | alpine:latest | amd64、arm64 | | 10 | UMS 10.x | Dockerfile.10-alpine | alpine:latest | amd64、arm64 | | 10-alpine | UMS 10.x | Dockerfile.10-alpine | alpine:latest | amd64、arm64 | | 10-debian | UMS 10.x | Dockerfile.10-debian | debian:bullseye | amd64 | | 9 | UMS 9.x | Dockerfile.9 | debian:buster | amd64 | | 9-alpine | UMS 9.x | Dockerfile.9-alpine | alpine:latest | amd64 | | 8 | UMS 8.x | Dockerfile.8 | debian:stretch | amd64 | | 7 | UMS 7.x | Dockerfile.7 | debian:stretch | amd64 | | 6 | UMS 6.x | Dockerfile.6 | debian:stretch | amd64 | | 5 | UMS 5.x | Dockerfile.5 | debian:stretch | amd64 |

显式架构标签这些标签用于显式拉取指定架构的镜像，与多架构标签的镜像内容完全一致。| 标签 | UMS版本 | Dockerfile路径 | 基础镜像 | 架构 |

|-------------------------------|-----------|-------------------------------|--------------------|--------| | latest-amd64
13-alpine-amd64 | UMS 13.x | Dockerfile.13-alpine | alpine:latest | amd64 | | latest-arm64
13-alpine-arm64 | UMS 13.x | Dockerfile.13-alpine | alpine:latest | arm64 | | 13-debian-amd64 | UMS 13.x | Dockerfile.13-debian | debian:bullseye | amd64 | | 11-alpine-amd64 | UMS 11.x | Dockerfile.11-alpine | alpine:latest | amd64 | | 11-alpine-arm64 | UMS 11.x | Dockerfile.11-alpine | alpine:latest | arm64 | | 10-alpine-amd64 | UMS 10.x | Dockerfile.10-alpine | alpine:latest | amd64 | | 10-alpine-arm64 | UMS 10.x | Dockerfile.10-alpine | alpine:latest | arm64 | | 10-debian-amd64 | UMS 10.x | Dockerfile.10-debian | debian:bullseye | amd64 |

权限前提条件默认情况下，UMS以非root用户运行。因此，挂载到容器的媒体目录必须设置"other"权限为rx（读和执行）：

bash
chown -R o+rx /path/to/my/media

使用场景和适用范围-** 家庭媒体中心 **：将本地硬盘、NAS中的媒体文件流式传输到智能电视、投影仪、手机等设备

-** 小型办公网络 ：共享培训视频、产品演示等企业媒体资源 - 嵌入式设备 ：在树莓派等ARM设备上部署，构建低功耗媒体服务器 - 临时媒体共享 **：快速搭建临时媒体服务，用于聚会、展示等场景

详细使用方法和配置说明### 拉取镜像```bash

docker pull mbentley/ums

### 示例用法#### 默认配置（自动生成UMS.conf）```bash
docker run -d \
  --init \
  --net=host \
  --restart=always \
  --name ums \
  -e FOLDER="/media" \
  -e FORCE_CHOWN="false" \
  -e NETWORK_INTERFACE="" \
  -e LOG_LEVEL="" \
  -e PORT=5001 \
  -e SET_MEDIA_PERMISSIONS="false" \
  -v ums-data:/opt/ums/data \
  -v ums-database:/opt/ums/database \
  -v /path/to/your/media:/media \
  mbentley/ums

自定义配置（挂载本地UMS.conf和凭据文件）```bash

docker run -d
--init
--net=host
--restart=always
--name ums
-e FOLDER=""
-e FORCE_CHOWN="false"
-e NETWORK_INTERFACE=""
-e LOG_LEVEL=""
-e PORT=5001
-e SET_MEDIA_PERMISSIONS="false"
-v /path/to/your/UMS.conf:/opt/ums/UMS.conf
-v /path/to/your/UMS.cred:/opt/ums/UMS.cred
-v /path/to/data:/opt/ums/data
-v /path/to/database:/opt/ums/database
-v /path/to/your/media:/media
mbentley/ums

### 环境变量配置| 变量名                  | 默认值   | 说明                                                                 |
|-------------------------|----------|----------------------------------------------------------------------|
| `FOLDER`                | `null`   | 自动在`UMS.conf`中设置媒体文件夹路径                                 |
| `FORCE_CHOWN`           | `false`  | 设为`true`时强制更改`/opt/ums/data`和`/opt/ums/database`目录所有权   |
| `NETWORK_INTERFACE`     | `null`   | 手动指定UMS绑定的网络接口（默认自动检测）                            |
| `LOG_LEVEL`             | `null`   | 日志级别，可选：`ALL`/`TRACE`/`DEBUG`/`INFO`/`WARN`/`ERROR`/`OFF`    |
| `PORT`                  | `null`   | 自定义UMS服务端口（默认5001）                                        |
| `SET_MEDIA_PERMISSIONS` | `false`  | 设为`true`且指定`FOLDER`时，自动设置媒体目录权限为全局可读可执行     |

### 持久化数据管理**警告**：未挂载`UMS.conf`、`data`和`database`目录时，配置和数据将在容器删除后丢失。如需初始配置文件，可从容器复制默认`UMS.conf`：

```bash
docker run -d --name ums-temp mbentley/ums bash
docker cp ums-temp:/opt/ums/UMS.conf UMS.conf
docker stop ums-temp
docker rm ums-temp

注意：持久化文件和目录的所有权需确保为500:500，入口脚本会尝试自动修复权限问题。

非Host网络配置若不使用--net=host，需手动暴露以下端口（自动发现功能可能受影响）：

-** TCP端口 ：2869（SSDP）、5001（Web界面）、9001（媒体传输） - UDP端口 **：1900（SSDP发现）