go-emby2openlist

go-emby2openlist

小白必看

网盘直链反向代理:

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

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

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

客户端 客户端 => 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.8.2 --depth 1 https://github.tbedu.top/https://github.com/AmbitiousJun/go-emby2openlist
cd go-emby2openlist

1. 拷贝配置

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

cp config-example.yml config.yml

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

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

1. 编译并运行容器

docker-compose up -d --build

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

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

2. 日志查看

docker logs -f go-emby2openlist -n 1000

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

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

1. 版本更新

# 获取到最新代码后, 可以检查一下 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

1. 清除过时的 Docker 镜像

docker image prune -f

使用现有镜像

1. 准备配置

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

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

1. 创建 docker-compose 文件

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

version: "3.1"
services:
  go-emby2openlist:
    image: ambitiousjun/go-emby2openlist:v2.8.2
    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

1. 运行容器

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 目录树变更，在本地磁盘中生成并维护相应结构的目录树