dms常见问题解答：解决你的媒体服务器疑惑

【免费下载链接】dmsA UPnP DLNA Digital Media Server that includes basic video transcoding. Tested on a Panasonic Viera television, several Android UPnP apps, and Chromecast.项目地址: https://gitcode.com/gh_mirrors/dm/dms

dms是一款功能强大的UPnP DLNA数字媒体服务器，支持基础视频转码功能，已在松下Viera电视、多款Android UPnP应用和Chromecast等设备上经过测试。本文将解答用户在使用dms过程中可能遇到的常见问题，帮助你快速解决疑惑，顺利搭建和使用媒体服务器。

安装相关问题

如何安装dms？

安装dms非常简单，只需执行以下命令：

go install github.com/anacrolix/dms@latest

注意，你需要先安装Go，并且确保$GOPATH/bin（或$HOME/go/bin）在你的PATH环境变量中。

如何以Docker容器方式运行dms？

如果你更倾向于使用Docker，可按照以下步骤操作：

docker pull ghcr.io/anacrolix/dms:latest docker run -d --network host -v /path/to/media:/dmsdir ghcr.io/anacrolix/dms:latest

这里--network host是必不可少的，它能确保SSDP/UPnP发现功能正常工作。

如何将dms作为systemd服务运行？

项目中提供了示例服务文件，路径为helpers/systemd/dms.service。你只需将其复制到/etc/systemd/system/目录，然后根据需要调整ExecStart路径和媒体目录即可。

如何在FreeBSD上以服务方式运行dms？

将helpers/bsd/dms服务文件安装到/etc/rc.d或/usr/local/etc/rc.d，然后在/etc/rc.conf中添加以下内容：

dms_enable="YES" dms_root="/path/to/my/media" # 可选 dms_user="myuser" # 可选

NixOS系统上二进制文件无法工作怎么办？

预构建的二进制文件使用动态链接，在NixOS上可能无法正常工作。这种情况下，建议从源代码安装：

go install github.com/anacrolix/dms@latest

配置相关问题

如何使用配置文件而非命令行标志？

通过-config /path/to/config.json参数指定配置文件。例如：

{ "path": "/path/to/media", "friendlyName": "My Media Server", "noTranscode": true, "deviceIcon": "/path/to/icon.png", "deviceIconSizes": ["48:512", "128:512"] }

配置文件中的键与标志名称（驼峰式）匹配。注意：v1.7.2之前的版本中，配置文件中的allowedIps存在问题，如有相关问题请升级版本。

如何提供多个目录的媒体文件？

dms只能提供单个根路径的媒体文件。若要提供多个目录，你可以创建一个父目录并使用符号链接：

mkdir ~/media ln -s /path/to/movies ~/media/movies ln -s /path/to/music ~/media/music dms -path ~/media

如何限制哪些客户端可以连接？

使用-allowedIps参数，后跟以逗号分隔的IP或CIDR范围列表：

dms -allowedIps 192.168.1.0/24,10.0.0.1

如何更改HTTP端口？

使用-http :8080参数（默认端口为1338）。若要仅监听IPv6：-http [::]:1338。若要监听所有接口（包括IPv6）：-http [::]:1338。

如何设置自定义服务器名称？

通过以下命令设置：

dms -friendlyName "Living Room Server"

如何忽略隐藏文件和点目录？

执行以下命令即可：

dms -ignoreHidden -ignoreUnreadable

如何忽略特定目录（如缩略图）？

使用-ignore参数指定要忽略的目录：

dms -ignore thumbnails,thumbs,.git

如何配置SSDP广播间隔？

使用-notifyInterval参数设置，例如：

dms -notifyInterval 60s

默认间隔为30秒。

如何将dms限制在特定网络接口？

通过-ifname参数指定网络接口，如：

dms -ifname eth0

转码和媒体相关问题

dms需要ffmpeg吗？

ffmpeg（或avconv）是可选的。没有它，dms会直接提供文件。有了它，dms可以：

• 将视频转码为mpeg2 PAL-DVD或WebM/VP8格式（例如用于Chromecast）
• 生成缩略图（需要单独的ffmpegthumbnailer）

如何禁用转码功能？

使用以下命令：

dms -noTranscode

或者在配置文件中设置："noTranscode": true

如何强制转码为特定格式？

可以使用-forceTranscodeTo参数，例如：

dms -forceTranscodeTo chromecast # WebM/VP8格式 dms -forceTranscodeTo vp8 # VP8格式

如何禁用ffprobe媒体扫描？

执行以下命令：

dms -noProbe

这将禁用比特率/持续时间元数据，但会提高大型媒体库的启动时间。

为什么在大型媒体库上首次浏览速度很慢？

dms是按需扫描目录而非在启动时扫描，但旧版本存在一个bug，即childCount会触发完全递归扫描。这个问题已修复，请升级到v1.7.0或更高版本。

dms支持字幕吗？

dms会提供字幕文件，但客户端支持情况各不相同。大多数DLNA渲染器需要自己处理字幕加载。这是一个已知限制，可参考issue #140。

dms支持FLAC和MP3吗？

是的，音频文件会直接提供。如果它们没有显示出来，请检查文件是否有标准的媒体扩展名且可读。使用-logHeaders运行dms可以查看客户端的请求内容。

如何使用ffmpeg而非avconv？

dms优先使用ffmpeg/ffprobe，然后回退到avconv/avprobe。确保ffmpeg在你的PATH中，它将被自动使用。

如何提供直播流（如RTSP摄像头）？

使用-allowDynamicStreams启用动态流，并在你的媒体目录中创建一个.dms.json文件：

{ "Title": "My Camera", "Resources": [ { "MimeType": "video/webm", "Command": "ffmpeg -i rtsp://camera-ip:554/stream -c:v copy -c:a copy -f matroska -" } ] }

兼容性相关问题

哪些播放器和渲染器已知可以工作？

以下设备和应用已被测试可与dms配合使用：

• 松下Viera电视
• BubbleUPnP和AirWire（Android）
• Chromecast
• VLC（桌面和移动版）
• LG智能电视（效果不一）
• Roku设备
• Apple TV 4K（通过VLC或8player）
• iOS VLC和8player

三星电视：能找到视频但无法播放怎么办？

三星电视对DLNA一致性要求较高。你可以尝试：

1. 不使用转码运行：dms -noTranscode
2. 如果暂停/ seek功能无法工作，这是一个已知问题（#165）——三星需要特定的DLNA传输控制头。
3. 对于三星Frame电视，请确保使用v1.6.0或更高版本（#110）。

LG电视：日志中出现"stalled subscribe connection"消息怎么办？

尝试使用-stallEventSubscribeworkaround：

dms -stallEventSubscribe

这是专门为发送格式错误的事件订阅请求的旧款LG电视添加的。

Windows 10无法发现DMS服务器怎么办？

Windows 10的DLNA发现使用UPnP多播。请确保：

• 你的防火墙允许UDP端口1900（SSDP）和TCP端口1338（HTTP）
• dms绑定到正确的网络接口（-ifname）
• 你在同一个子网（DLNA默认不跨路由器）

如何在不同网络段（VLAN）间访问dms？

DLNA依赖多播，无法跨网络边界。可以使用dlna-proxy在不同网段之间桥接。

BubbleUPnP在大型音乐库上运行缓慢或崩溃怎么办？

对于非常大的音乐库（例如26k+曲目），每次浏览都会触发对新文件的ffprobe，这会累积进程。使用-noProbe完全禁用ffprobe，或者如果不需要转码功能，使用-noTranscode -noProbe。详见issue #105。

故障排除相关问题

网络上无法发现dms怎么办？

1. 确保dms正在运行并监听：curl http://localhost:1338/rootDesc.xml
2. 检查UDP端口1900是否未被防火墙阻止
3. 尝试指定接口：dms -ifname eth0
4. 在多宿主主机上，尝试每个接口名称直到找到可用的
5. 如果使用Docker，确保设置了--network host

转码时ffmpeg出现"broken pipe"错误怎么办？

这是正常现象——当客户端在转码完成前停止播放时会发生。这些错误是良性的。详见issue #129。

符号链接目录不可见怎么办？

最近的版本已修复此问题。请升级到最新版本。如果仍然有问题，请确保符号链接目标对运行dms的用户可读。

path标志需要绝对路径怎么办？

始终使用绝对路径与-path参数：

dms -path /home/user/media # 正确 dms -path ~/media # 在所有shell中可能无法工作

如何获取更详细的日志输出？

目前没有-verbose标志（#126）。使用-logHeaders可以查看HTTP请求/响应头。转码日志默认位于~/.dms/log/；可使用-transcodeLogPattern更改。

如何禁用转码日志？

执行以下命令：

dms -transcodeLogPattern /dev/null

服务器在关闭时冻结或崩溃怎么办？

v1.7.0版本修复了Close()时出现的close of closed channel恐慌问题。如果你遇到此问题，请升级版本。

【免费下载链接】dmsA UPnP DLNA Digital Media Server that includes basic video transcoding. Tested on a Panasonic Viera television, several Android UPnP apps, and Chromecast.项目地址: https://gitcode.com/gh_mirrors/dm/dms