go-emby2openlist

go-emby2openlist

小白必看

网盘直链反向代理:

正常情况下，Emby 通过磁盘挂载的形式间接读取网盘资源，走的是服务器代理模式，看一个视频时数据链路是：

客户端 => Emby 源服务器 => 磁盘挂载服务 => OpenList => 网盘

客户端 <= Emby 源服务器 <= 磁盘挂载服务（将视频数据加载到本地，再给 Emby 读取） <= OpenList <= 网盘

这种情况有以下局限：

1. 视频经过服务器中转，你看视频的最大加载速度就是服务器的上传带宽
2. 如果服务器性能不行，能流畅播放 1080p 就谢天谢地了，更别说 4K
3. …

使用网盘直链反向代理后，数据链路：

客户端 => Emby 反代服务器 => Emby 源服务器 （请求 Emby Api 接口）

客户端 <= Emby 反代服务器 <= Emby 源服务器 （返回数据）

对于普通的 Api 接口，反代服务器将请求反代到源服务器，再将合适的结果进行缓存，返回给客户端

对于客户端来说，这一步和直连源服务器看不出差别

客户端 => Emby 反代服务器 => OpenList => 网盘 （请求视频直链）

客户端 <= Emby 反代服务器 <= OpenList <= 网盘 （返回视频直链，并给出重定向响应）

客户端 => 网盘（客户端拿着网盘的直链直接观看，此时已经没有服务器的事情了，故不会再消耗服务器流量）

这种方式的好处：

1. 观看时加载速度拉满（前提是有网盘会员）
2. 在客户端处解码，能不能看 4K 取决于你电视盒子的性能

使用前须知

1. 本项目初衷: 易用轻巧、小白友好、深度适配阿里云盘 (如果你使用本项目观看其他网盘时出现问题，也欢迎到 issue 区反馈，我会尽量适配它)

2. 如果你有更复杂的需求, 推荐使用功能更完善的反向代理服务：bpking1/embyExternalUrl

功能

• OpenList 网盘原画直链播放

• Strm 直链播放

• OpenList 本地目录树生成

• 自定义注入 js/css（web）

• OpenList 网盘转码直链播放（阿里云盘）

  是否消耗三方流量包流量：🙅

  非会员是否限速：自行测试

  示例图 ↓：

  

  转码资源直链已达到可正常使用的标准，Emby Web, Emby for AndroidTV 以及其他大部分客户端都可以正常播放，并且不会因为直链过期而中断

  局限：

  如果是有多个内置音频的，转码直链只能播放其中的默认音频

  视频本身的内封字幕会丢失，不过若存在转码字幕，也会适配到转码版本的 PlaybackInfo 信息中，示例图 ↓：

  

• websocket 代理

• 客户端防转码（转容器）

• 缓存中间件，实际使用体验不会比直连源服务器差

• 字幕缓存（字幕缓存时间固定 30 天）

  目前还无法阻止 Emby 去本地挂载文件上读取字幕

  带字幕的视频首次播放时，Emby 会调用 FFmpeg 将字幕从本地文件中提取出来，再进行缓存

  也就是说：

  • 首次提取时，速度会很慢，有可能得等个大半天才能看到字幕（使用第三方播放器【如 MX player, Fileball】可以解决）
  • 带字幕的视频首次播放时，还是会消耗服务器的流量

• 直链缓存（为了兼容阿里云盘，直链缓存时间目前固定为 10 分钟，其他云盘暂无测试）

• 大接口缓存（OpenList 转码资源是通过代理并修改 PlaybackInfo 接口实现，请求比较耗时，每次大约 2~3 秒左右，目前已经利用 Go 语言的并发优势，尽力地将接口处理逻辑异步化，快的话 1 秒即可请求完成，该接口的缓存时间目前固定为 12 小时，后续如果出现异常再作调整）

已测试并支持的客户端

前置环境准备

1. 已有自己的 Emby、OpenList 服务器

2. Emby 的媒体库路径（本地磁盘路径）是和 OpenList 挂载路径能够对应上的

   这一步前缀对应不上没关系，可以在配置中配置前缀映射 path.emby2openlist 解决

3. 需要有一个中间服务，将网盘的文件数据挂载到系统本地磁盘上，才能被 Emby 读取到（也可借助本项目的 OpenList 目录树生成功能）

   目前我知道的比较好用的服务有两个：rclone 和 CloudDrive2(简称 cd2)

   如果你的网盘跟我一样是阿里云盘，推荐使用 cd2 直接连接阿里云盘，然后根路径和 OpenList 保持即可

   在 cd2 中，找到一个 最大缓存大小 的配置，推荐将其设为一个极小值（我是 1MB），这样在刮削的时候就不会消耗太多三方权益包的流量

   ⚠️ 不推荐中间服务直接去连接 OpenList 的 WebDav 服务，如果 OpenList Token 刷新失败或者是请求频繁被暂时屏蔽，会导致系统本地的挂载路径丢失，Emby 就会认为资源被删除了，然后元数据就丢了，再重新挂载回来后就需要重新刮削了。

4. 服务器有安装 Docker

5. Git

   非必须，如果你想体验测试版，就需要通过 Git 拉取远程源码构建

   正式版可以直接使用现成的 Docker 镜像

使用 DockerCompose 部署安装

通过源码构建

1. 获取代码

git clone --branch v2.9.0 --depth 1 https://github.tbedu.top/https://github.com/AmbitiousJun/go-emby2openlist
cd go-emby2openlist

2. 拷贝配置

示例配置为完整版配置，首次部署可以参照核心配置优先跑通程序，再按需补充其他配置

cp config-example.yml config.yml

3. 根据自己的服务器配置好 config.yml 文件

关于路径映射的配置示例图：

4. 编译并运行容器

docker-compose up -d --build

5. 浏览器访问服务器 ip + 端口 8095，开始使用

   如需要自定义端口，在第四步编译之前，修改 docker-compose.yml 文件中的 8095:8095 为 [自定义端口]:8095 即可

6. 日志查看

docker logs -f go-emby2openlist -n 1000

7. 修改配置的时候需要重新启动容器

# 修改 config.yml ...
docker-compose restart

8. 版本更新

# 获取到最新代码后, 可以检查一下 config-example.yml 是否有新增配置
# 及时同步自己的 config.yml 才能用上新功能

# 更新到正式版
docker-compose down
git fetch --tag
git checkout <版本号>
git pull
docker-compose up -d --build

# 更新到测试版 (仅尝鲜, 不稳定)
docker-compose down
git checkout main
git pull origin main
docker-compose up -d --build

9. 清除过时的 Docker 镜像

docker image prune -f

使用现有镜像

1. 准备配置

示例配置为完整版配置，首次部署可以参照核心配置优先跑通程序，再按需补充其他配置

参考示例配置，配置好自己的服务器信息，保存并命名为 config.yml

2. 创建 docker-compose 文件

在配置相同目录下，创建 docker-compose.yml 粘贴以下代码：

version: "3.1"
services:
  go-emby2openlist:
    image: ambitiousjun/go-emby2openlist:v2.9.0
    environment:
      - TZ=Asia/Shanghai
      - GIN_MODE=release
      # - HTTP_PROXY=http://127.0.0.1:7890
      # - HTTPS_PROXY=http://127.0.0.1:7890
    container_name: go-emby2openlist
    restart: always
    volumes:
      - ./config.yml:/app/config.yml
      - ./ssl:/app/ssl
      - ./custom-js:/app/custom-js
      - ./custom-css:/app/custom-css
      - ./lib:/app/lib
      - ./openlist-local-tree:/app/openlist-local-tree
    ports:
      - 8095:8095 # http
      - 8094:8094 # https

3. 运行容器

docker-compose up -d --build

使用说明 ssl

使用方式：

1. 将证书和私钥放到程序根目录下的 ssl 目录中
2. 再将两个文件的文件名分别配置到 config.yml 中

特别说明：

在容器内部，已经将 https 端口写死为 8094，将 http 端口写死为 8095

如果需要自定义端口，仍然是在 docker-compose.yml 中将宿主机的端口映射到这两个端口上即可

已知问题：

可能有部分客户端会出现首次用 https 成功连上了，下次再打开客户端时，就自动变回到 http 连接，目前不太清楚具体的原因

使用说明 自定义注入 web js 脚本

使用方式： 将自定义脚本文件以 .js 后缀命名放到程序根目录下的 custom-js 目录后重启服务自动生效

远程脚本： 将远程脚本的 http 访问地址写入以 .js 后缀命名的文件后（如编辑器报错请无视）放到程序根目录下的 custom-js 目录后重启服务自动生效

注意事项： 确保多个不同的文件必须都是相同的编码格式（推荐 UTF-8）

示例脚本：

使用说明 自定义注入 web css 样式表

使用方式： 将自定义样式表文件以 .css 后缀命名放到程序根目录下的 custom-css 目录后重启服务自动生效

远程样式表： 将远程样式表的 http 访问地址写入以 .css 后缀命名的文件后（如编辑器报错请无视）放到程序根目录下的 custom-css 目录后重启服务自动生效

注意事项： 确保多个不同的文件必须都是相同的编码格式（推荐 UTF-8）

示例样式：

使用说明 OpenList 本地目录树生成

监控扫描 OpenList 目录树变更，在本地磁盘中生成并维护相应结构的目录树，可供 Emby 服务器直接扫描入库，并配合本项目进行直链反代，支持传统 Strm 文件以及附带元数据的虚拟文件生成。

⚠️ 提示：

程序利用 Go 的并发优势，加快了扫描 OpenList 的速度，同时对于 ffmpeg 提取远程文件元数据操作进行了严格的并发控制，同一时刻只会有至多一个文件被提取元数据，扫库的风控风险虽大幅降低，但仍存在！

使用步骤

1. 升级到 go-emby2openlist v2.2.0 以上版本
2. 修改配置，按照自己的需求配置好 openlist.local-tree-gen 属性
3. 修改 docker-compose.yml 文件，将容器目录 /app/openlist-local-tree 以及 /app/lib 映射到宿主机中
4. 运行程序 开始自动扫描生成目录树
5. 将宿主机的目录树路径，映射到 Emby 容器中，即可扫描入库

不同使用场景的配置方式

由于 openlist.local-tree-gen 属性中的不同配置可能会有相互作用的情况，因此本说明按照具体的使用场景逐步递进地说明配置方式

1. 传统 Strm

   将需要转换成 strm 文件的文件容器配置到 openlist.local-tree-gen.strm-containers 属性中，以逗号分隔，不区分大小写，即可生效，示例配置：

   openlist:
     local-tree-gen:
       enable: true
       strm-containers: mp4,mkv,mp3,flac
   

   优点：无需调用 ffmpeg，扫描速度极快，Emby 源端口 8096 也可能可以正常播放

   缺点：每个视频都需要使用 Emby 源端口至少播放一次后才能正常保存播放记录，配合反代服务体验不佳（v2.2.12 版本之后通过反代播放 Strm 也可正常记录播放进度）；无法获取视频的阿里转码版本

2. 虚拟文件

   此方式会在本地磁盘生成与远程文件同名的空文件（每个虚拟文件大小约 300B），对 Emby 来说就是大小为 0MB 的普通媒体文件。同理 Strm，将目标文件容器配置到 openlist.local-tree-gen.virtual-containers 属性中，以逗号分隔，不区分大小写，即可生效，示例配置：

   openlist:
     local-tree-gen:
       enable: true
       virtual-containers: mp4,mkv
   

   下面介绍虚拟文件的两种处理方式，各有优缺，自行斟酌选用：

   默认情况下，程序会为每个媒体文件设置统一的时长元数据（3 小时，基本覆盖 99% 的媒体时长）。在实际使用时，Emby 能够正常记录播放进度，只不过在 UI 展示层面可能有点奇怪，如：播放时进度条完全不动（视频实际时长远远比 3 小时短）

   优点：无需调用 ffmpeg，扫描速度极快，风控风险低；Emby 能够正常记录播放进度

   缺点：视频时长固定写死为 3 小时，体验不佳；Emby 源端口 8096 无法播放

   可以通过开启 ffmpeg，来解析远程媒体的真实时长，并写入虚拟文件中来解决上述问题：

   openlist:
     local-tree-gen:
       enable: true
       ffmpeg-enable: true
       virtual-containers: mp4,mkv
   

   使用这种方式后，程序会在扫描文件时，自动调用 ffmpeg 提取视频的真实时长，并写入本地虚拟文件中

   优点：视频时长真实，Emby 能够正常记录播放进度，且体验良好

   缺点：调用 ffmpeg 解析远程参数，有一定的风控风险；扫描速度相较第一种方式略慢一些；Emby 源端口 8096 无法播放

3. 音乐虚拟文件

   此方式类似于方式 2，扫描时除了提取文件的真实时长之外，还会提取音乐内嵌的标签元数据，写入到本地虚拟文件中（每个文件大小约 300KB~1MB 不等），使得 Emby 能够正常扫描解析音乐标签（标题、艺术家、海报、歌词等）以及音频真实播放时长。

   ⚠️ 这种方式必须开启 ffmpeg 才能生效，且风控风险是 3 种方式中最高的一个，谨慎使用！

   如果使用了此方式，但没有开启 ffmpeg，默认生成的是传统 Strm 文件

   将目标文件容器配置到 openlist.local-tree-gen.music-containers 属性中，以逗号分隔，不区分大小写，即可生效，示例配置：

   openlist:
     local-tree-gen:
       enable: true
       ffmpeg-enable: true
       music-containers: mp3,flac
   

   优点：Emby 扫描音乐虚拟文件入库之后，能正常识别出音乐标签和时长

   缺点：调用 ffmpeg 解析远程参数，有一定的风控风险；扫描速度是三种方式中最慢的；Emby 源端口 8096 无法播放

其他配置

额外说明

1. 为了保持 10MB 大小的精简 Docker 镜像，ffmpeg 默认不会被添加到镜像中。首次将 openlist.local-tree-gen.ffmpeg-enable 配置设置为 true 并运行容器后，程序会自动初始化 ffmpeg 环境，请耐心等待下载完成，中途不要停止容器
2. 当检测出远程文件容器不在上述所说的三种生成方式任何一种之中时，程序的默认行为是将源文件下载到本地。比如在上述的例子中没有配置 nfo 文件格式，则远程的 nfo 文件会原封不动保存下载到本地。所以在使用本功能前请确认好所有的媒体大文件格式全都已经配置到了上述三种生成方式中

开放 API

手动更新本地目录树

🔗 请求地址

POST /ge2o/openlist/local_tree/update

📥 请求参数

请求体为 JSON 格式：

{
  "secret": "test",
  "prefix": "/音乐1/陈楚生",
  "refresh": false
}

📌 参数说明

📤 响应结果

HTTP 状态码固定为 200，通过 body 判断结果。

{
  "success": false,
  "message": "密钥错误"
}

请我喝杯 9.9💰 的 Luckin Coffee☕️

Star History