- 项目源码：
https://github.com/gerbera/gerbera - 项目仓库：
docker pull gerbera/gerbera - 快速启动命令：
docker run -d --name gerbera \
-e PUID=$(id -u) -e PGID=$(id -g) \
--network=host \
-v <path-to>/conf:/var/run/gerbera \
-v <path-to>/photos:/mnt/content/photos:ro \
-v <path-to>/video:/mnt/content/video:ro \
-v <path-to>/music:/mnt/content/music:ro \
gerbera/gerbera
Gerbera UPnP媒体服务器概述
Gerbera 是一款基于UPnP（通用即插即用）协议的开源媒体服务器，它允许用户在家庭网络环境中高效地流式传输数字媒体内容，并在各种兼容UPnP的设备上实现无缝的视频观看与音乐收听体验。这款服务器可以被视为 Jellyfin、Kodi 和 Emby 等流行媒体解决方案的轻量级替代品，具备类似的 core 功能，同时以更高的效率和简洁性著称。
- 支持多种常见媒体格式，包括但不限于MP3、OGG、AAC、M4A、FLAC音频文件以及JPG等图像格式，并内置了元数据自动提取和媒体缩略图生成功能，以提升内容管理的便捷性。
- 提供直观的Web用户界面，使用户能够轻松浏览和管理媒体库，无需复杂的学习过程即可上手操作。
- 具备灵活的媒体格式转码能力，能够根据设备需求动态调整媒体流，确保在不同平台上获得最佳的播放兼容性。
- 集成自动目录重新扫描机制，当媒体文件发生变化时，服务器会自动更新库内容，保持数据同步与实时性。
安装配置与初步体验
按照上述快速启动命令，用户可以通过Docker容器快速完成Gerbera的安装与部署过程。启动成功后，在浏览器中输入地址 http://<NAS-IP>:49494 即可访问Gerbera的Web管理界面，开始配置和使用服务。
' fill='%23FFFFFF'%3E%3Crect x='249' y='126' width='1' height='1'%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)
在初次启动阶段，Gerbera会自动扫描挂载在 /mnt/content 目录下的所有视频、音乐和图片文件，扫描进度会实时显示在界面下方，方便用户监控处理状态。以个人测试为例，在包含超过一万张照片、数百个视频文件以及大量音乐曲目的媒体库中，完整扫描过程大约耗时8分钟，整体效率相比之前使用的Jellyfin服务器有所提升，体现出其优化的资源处理能力。
扫描完成后，用户可以通过菜单中的“FileSystem”选项查看已成功导入的媒体数据，界面会以树状结构展示目录和文件，便于快速定位和访问内容。
在电脑端访问Web界面时，可能会感觉UI设计较为简洁，但这并不影响核心功能的可用性。为了获得更全面的体验，建议尝试在移动设备上使用Gerbera服务，以验证其跨平台兼容性。
移动设备播放体验
在智能手机上使用Gerbera时，只需安装任何支持UPnP协议的播放器应用即可实现流媒体播放。例如，可以选择像OPlayer这样历史悠久且稳定的应用，安装后打开Gerbera服务器界面，即可浏览和选择媒体内容进行播放。
尽管Gerbera的logo设计可能不够美观，但这并不影响其功能性。作为纯粹的流媒体服务器，Gerbera负责内容的传输与管理，而实际的播放和查看操作则由OPlayer等第三方应用完成。在测试中，播放一个容量为5GB的高清电影文件时，流媒体传输非常流畅，没有出现卡顿或缓冲问题，证明了服务器在处理大文件时的稳定性能。
总结与优缺点分析
Gerbera采用C++语言编写，底层优化使其在资源利用和响应速度上表现出色，尤其适合对性能有较高要求的家庭媒体服务器场景。虽然其Web界面设计较为朴素，但核心流媒体功能完整可靠，用户如果能够接受外观上的不足，完全可以将其作为日常媒体服务的首选工具。大多数使用场景中，用户主要通过OPlayer等播放器与应用交互，因此服务器本身的UI美观度对实际体验影响有限。总体而言，Gerbera是一款高效、轻量且兼容性强的UPnP媒体服务器，值得用户尝试部署和使用。