Homepage媒体服务集成：Plex/Jellyfin/Emby配置-优快云博客

Homepage媒体服务集成：Plex/Jellyfin/Emby配置

【免费下载链接】homepage 一个高度可定制的主页（或起始页/应用程序仪表板），集成了Docker和服务API。项目地址: https://gitcode.com/GitHub_Trending/ho/homepage

Homepage作为高度可定制的应用仪表板，支持与主流媒体服务器（Plex、Jellyfin、Emby）集成，通过简单配置即可在主页展示媒体库状态、播放信息等关键数据。本文将详细介绍三种媒体服务的集成方法，帮助你打造一站式媒体中心监控面板。

媒体服务集成概览

Homepage通过服务小部件（Service Widgets）实现与媒体服务器的连接，支持显示在线用户、媒体库统计、实时播放等核心信息。所有配置通过YAML文件完成，无需复杂编程知识。

官方文档提供了完整的服务配置指南：服务配置文档

Plex集成配置

Plex是最流行的媒体服务器之一，Homepage通过其API获取库大小和活跃流数据。

配置步骤：

获取Plex Token
登录Plex网页端，访问Settings > XML找到X-Plex-Token值，或参考Plex Token获取教程

编辑服务配置文件
在config/services.yaml中添加：

- 媒体服务:
    - Plex服务器:
        href: http://plex.local:32400
        icon: plex.png
        description: 家庭媒体中心
        widgets:
          - type: plex
            url: http://plex.local:32400
            key: YOUR_PLEX_TOKEN
            fields: ["streams", "movies", "tv"] # 显示的信息字段

支持的信息字段
可配置显示：streams（活跃流）、movies（电影数量）、tv（剧集数量）、albums（音乐专辑）

完整配置说明：Plex Widget文档

Emby集成配置

Emby提供更丰富的自定义选项，支持媒体控制和用户信息展示。

配置步骤：

创建Emby API密钥
登录Emby后台，进入设置 > 高级 > API密钥生成新密钥

服务配置示例
在config/services.yaml中添加：

- 媒体服务:
    - Emby服务器:
        href: http://emby.local:8096
        icon: emby.png
        description: 多平台媒体服务器
        widgets:
          - type: emby
            url: http://emby.local:8096
            key: YOUR_EMBY_API_KEY
            enableBlocks: true # 显示媒体统计块
            enableNowPlaying: true # 显示正在播放
            enableUser: true # 显示用户信息
            showEpisodeNumber: true # 显示剧集编号

高级选项
- enableMediaControl: 启用播放控制按钮（默认true）
- expandOneStreamToTwoRows: 优化单流显示布局（默认true）

完整配置说明：Emby Widget文档

Jellyfin集成配置

Jellyfin作为开源媒体服务器，虽无官方专用Widget，但可通过通用API小部件实现基础监控。

配置步骤：

启用Jellyfin API
确保Jellyfin设置中API设置 > 允许跨域请求已开启

使用Custom API Widget
在config/services.yaml中添加：

- 媒体服务:
    - Jellyfin服务器:
        href: http://jellyfin.local:8096
        icon: jellyfin.png
        description: 开源媒体解决方案
        widgets:
          - type: customapi
            url: http://jellyfin.local:8096/System/Info
            method: GET
            headers:
              Authorization: "MediaBrowser Token=YOUR_JELLYFIN_TOKEN"
            format: |
              <div>在线用户: {{json.Data.ActiveUsers}}</div>
              <div>媒体库: {{json.Data.LibraryCount}}个</div>

获取Jellyfin Token
通过Jellyfin登录接口获取临时令牌，或使用API密钥认证

Jellyfin API文档：Jellyfin开发者文档

服务配置文件结构

所有媒体服务配置集中在services.yaml中，采用分组式结构：

# 示例services.yaml结构
- 媒体服务组:
    - 服务1:
        # 服务配置
    - 服务2:
        # 服务配置
- 其他服务组:
    # 更多服务...

默认配置模板：services.yaml示例

故障排除

连接失败
- 检查服务URL和端口是否正确
- 验证API密钥/Token权限
- 确保Homepage容器网络可访问媒体服务器
信息不更新
- 清除浏览器缓存
- 检查配置文件格式是否正确（使用YAML验证工具）
- 查看Homepage日志：docker logs homepage

故障排除指南：官方故障排除文档

总结

通过简单的YAML配置，Homepage可将多种媒体服务整合到统一面板，实时监控播放状态和媒体库统计。根据需求选择合适的媒体服务器，参考本文配置示例即可快速实现集成。

更多服务集成：Homepage Widget库

【免费下载链接】homepage 一个高度可定制的主页（或起始页/应用程序仪表板），集成了Docker和服务API。项目地址: https://gitcode.com/GitHub_Trending/ho/homepage

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考