akafra/emby-plus

Emby网盘直连工具

镜像概述

Emby网盘直连工具是一款用于实现Emby服务器与网盘（支持123网盘和115网盘）直连的工具，可将网盘中的媒体文件通过Emby直接播放，无需将文件下载到本地存储。该工具需配合Emby服务器使用，通过配置Emby连接信息及网盘授权，实现媒体文件的直连访问与播放。

核心功能与特性

• Emby集成：与Emby服务器无缝对接，通过Emby API实现媒体文件直连播放
• 多网盘支持：支持123网盘和115网盘，满足不同网盘用户需求
• 配置管理：提供Web管理界面，支持网盘授权、基本参数配置及用户信息修改
• 持久化存储：通过数据卷挂载实现配置数据持久化，容器重启后配置不丢失
• 自动重启：支持容器自动重启策略，保证服务稳定运行

使用场景

适用于将媒体文件存储在123网盘或115网盘，需要通过Emby服务器播放这些媒体文件的用户。尤其适合媒体文件体积大、本地存储不足，或需要多设备访问网盘中媒体资源的场景。

使用方法与配置说明

前置要求

• 已部署Emby服务器，并获取Emby API密钥（在Emby后台“设置-API密钥”处生成）
• 123网盘开发者账号及申请的ClientId、ClientSecret（申请地址：[***]
• 115网盘账号（用于扫码授权）

Docker Compose部署示例

yaml
services:
  # 定义名为 emby-plus 的服务
  emby-plus:
    # 使用 akafra/emby-plus 镜像
    image: akafra/emby-plus
    # 指定容器名称为 emby-plus
    container_name: emby-plus
    
    # 环境变量配置
    environment:
      # 激活 Spring 的生产环境配置，固定值，无需修改
      SPRING_PROFILES_ACTIVE: 'prod'
      # Emby 服务的 API 认证密钥（需替换为实际密钥）
      EMBY_API_KEY: '71d7c535039349719cf5f43f963f8534'
      # Emby 服务器的主机地址（需替换为实际 Emby 访问地址）
      EMBY_HOST: 'http://192.168.50.238:38096'
    
    # 端口映射配置（主机端口:容器端口）
    ports:
      # 将宿主机的 8080 端口映射到容器的 8080 端口
      - 8080:8080
    
    # 容器重启策略：除非手动停止，否则始终重启
    restart: unless-stopped
    
    # 数据卷配置：将当前目录下的 data 目录挂载到容器的 /data 路径，用于持久化配置数据
    volumes:
      - ./data:/data

环境变量说明

系统设置界面操作

访问方式

容器启动后，通过浏览器访问 容器IP:端口/emby-plus 进入系统设置页面（默认端口为8080，若修改了端口映射需使用实际映射的主机端口）。

默认登录信息

• 用户名：admin
• 密码：admin

主要功能按钮

1. 115授权
   点击后跳转至***页面，使用115网盘客户端扫码完成授权，授权后工具可访问115网盘中的媒体文件。

2. 基本配置
   点击进入配置页面（提交配置时可能因缓存媒体库目录信息而响应较慢，请耐心等待），需配置以下参数：

   • 123网盘ClientId/ClientSecret：填入从123网盘开放平台申请的ClientId和ClientSecret
   • 123网盘/115网盘挂载前缀：用于匹配Emby媒体库路径与网盘实际路径。例如，Emby媒体库路径为/123/video/电视剧，而网盘实际路径为/video/电视剧，则挂载前缀填写/123
   • strm前缀：用于处理strm文件中的路径。若strm文件内容为http://xxx/static/http/xxx/123/video/xxx.mkv，填写/123前的部分，系统将自动截取并匹配网盘路径
   • LanIP：填入内网IP前缀（多个IP前缀用英文逗号分隔），如192.168,10.110,fe80:

3. 修改用户名密码
   用于修改登录系统的用户名和密码，建议首次登录后立即修改默认密码。

注意事项

• 确保Emby服务器与工具容器网络互通，EMBY_HOST需填写Emby服务器的可访问地址
• 123网盘ClientId和ClientSecret需提前申请，申请地址：[***]
• 数据卷./data:/data用于持久化配置，请勿删除或随意修改挂载目录，避免配置丢失