30 秒速读：Gerbera 是一款用 C++ 编写的家庭网络 UPnP / DLNA 媒体服务器：把 NAS 或小主机上的音乐、视频、图片集中管理，家里的电视、音响、手机只要支持 DLNA 就能直接浏览播放。它带 Web 管理界面、元数据提取、缩略图和自动扫描，还支持按需转码。结论先行：播放设备认 DLNA，它就是最轻的自托管方案；否则别碰。
项目信息
| 项目 | 说明 |
|---|---|
| 软件名称 | Gerbera（UPnP / DLNA 媒体服务器） |
| 版本 | 滚动发布，以 GitHub Releases 为准 |
| 平台 | Linux / BSD / macOS（支持 x86 / ARM / MIPS 架构） |
| 界面语言 | Web UI 多语言（据项目说明） |
| 许可证 | GPLv2 |
| 安装方式 | Docker 镜像 / 发行版软件包 / 源码编译 |
安装步骤：三种安装方式怎么选
结论先行：Docker 一条命令最省心，是 90% 人的答案；玩 NAS / 软路由的用系统包；只有要改代码或深度调转码才需要源码编译。
| 维度 | Docker 镜像 | 系统软件包 | 源码编译 |
|---|---|---|---|
| 上手成本 | 最低，一条命令启动 | 低，包管理器安装 | 高，需配齐一堆依赖 |
| 依赖地狱 | 无（镜像自带） | 发行版解决 | 自己解决：UPnP 库二选一 + SQLite + XML/JSON 等 |
| 更新 | 拉新镜像即可 | 跟随发行版 | 自己编译更新 |
| 适合谁 | 只想用的大多数人 | NAS / 软路由玩家 | 要魔改或调优的人 |
上手四个卡点
- 先确认播放端。电视、音响、手机 App 必须支持 UPnP / DLNA 协议——这是硬门槛。设备不认 DLNA，后面全白搭，先拿电视的说明书确认。
- 同一局域网是铁律。服务器和播放设备必须在同一子网，UPnP 靠组播做设备发现；跨 VLAN 或多路由环境要放行组播，否则就会出现经典的”搜不到服务器”。
- Docker 启动注意网络模式。映射 Web UI 端口和媒体目录，建议用 host 网络模式——组播发现在桥接网络下容易出问题，host 模式最省心。
- 首次进 Web UI 建库。按启动日志的地址打开 Web 管理界面，添加媒体目录并开启自动扫描（支持 inotify 实时扫描和定时重扫），剩下的交给它。
装完先调这四个设置
- 媒体目录自动扫描（入口：Web UI → 数据库 → 添加目录）：开启 inotify 实时扫描或定时重扫。体感差别：新拷进 NAS 的电影自动入库，不用每次手动点刷新，7×24 的”无人值守”感就有了。
- 转码配置（入口：设置 → 转码）：按自家播放设备配置转码脚本。体感差别：老电视播不动 H.265 或外挂字幕时，服务器端实时转码是救命功能；注意转码工具链（如 ffmpeg）需自行准备。
- 自定义媒体布局（入口：Web UI → 服务器布局）：按元数据（歌手 / 专辑 / 类型）组织虚拟目录。体感差别：音乐库从”文件夹堆”变成”可按专辑浏览的唱片架”，找歌效率质变。
- Last.fm 同步（入口：设置 → 可选开启）：听歌记录自动同步。体感差别：歌单党狂喜，年度听歌报告的数据源有了。
四个常见问题
- 电视搜不到 Gerbera 怎么办？三查：服务器和电视是否在同一局域网、路由器或防火墙有没有拦组播、Docker 是否用了 host 网络模式。90% 的”搜不到”都是这三处之一。
- 和 Jellyfin / Plex 比选哪个？一句话：Gerbera 是纯 UPnP / DLNA 服务器，无账号体系、无精美客户端；要的是”电视原生 DLNA 播放”，选 Gerbera；要精美 App、远程串流、多用户权限管理，选 Jellyfin。
- 转码要自己配？是的。Gerbera 只提供插件 / 脚本机制，转码工具链自行准备，README 也未给出全格式组合的兼容性矩阵——动手前先确认你家那台老电视到底需要什么格式。
- 跑在什么设备上最合适？NAS、软路由、树莓派都行（支持 x86 / ARM / MIPS 多架构），7×24 开机的小主机是最佳拍档；它本身很轻，不挑硬件。
谁适合用 Gerbera
一句话判断：适合家里已有 DLNA 播放设备、想极简自托管影音库的技术爱好者；不适合想要开箱即用的精美客户端、远程串流和多用户权限管理的人——后者请移步 Jellyfin。
说透它的取舍：Gerbera 的取舍是”协议优先、体验让路”——它只把 UPnP / DLNA 这一件事做好，不做客户端、不做账号、不做转码预设。结论：你的播放设备认 DLNA，它就是最轻的方案；不认，别碰，就这么简单。
注意事项
- 局域网发现依赖 DLNA / UPnP：若电视或音响搜不到服务器，先检查设备与服务器是否在同一局域网、防火墙是否放行相关端口，具体端口以官网说明为准。
- 媒体库扫描需要读取媒体文件夹的权限，挂载 NAS 目录时先确认路径与读取权限，避免扫出空库。
- 按需转码会吃 CPU，老设备或小主机上先只对确实播不动的格式开转码，不要全量开启。
版本对比与推荐
结论先行：只想用的大多数人直接用 Docker 镜像，玩 NAS 或软路由的用系统软件包，只有要改代码或深度调转码才考虑源码编译。
| 版本 | 适合人群 | 推荐结论 |
|---|---|---|
| Docker 镜像 | 只想用的大多数人 | 推荐：一条命令启动，最省心 |
| 系统软件包 | NAS / 软路由玩家 | 可用：跟随发行版更新 |
| 源码编译 | 要改代码或深度调转码的人 | 按需：上手成本高，以官网为准 |
开源地址
GitHub 国内访问较慢，如打不开可多刷新几次
推广
关注「软件教程管家」
回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。
版权与使用提示
本站资源仅供个人学习交流，请勿用于商业用途。软件与资料版权归原作者所有；如有侵权，请通过公众号「软件教程管家」联系我们，我们将在 24 小时内下架处理。查看免责声明 ›
文章推荐
标签推荐
正文完
