Skip to content
a317634186Public

About

☁️ 开源云播放器:磁力/种子离线下载 + OneDrive/Google Drive 云盘挂载 + 网页在线播放,AList + Aria2,Docker 一键部署

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

17 Commits

Folders and files

Repository files navigation

yun · 云播放器

粘贴磁力链接 → 云端下载 → 网页直接播放。

界面就三样东西:一个链接输入口、一个播放器、一份播放记录。 不需要任何网盘账号,文件存在 VPS 硬盘上,下载完点开就看。基于 AList + Aria2 + ffmpeg + 自带极简前端页,Docker 一键部署。

什么格式都能在浏览器里播。 MKV、H.265/HEVC、10bit、AC3/DTS 这些浏览器原生放不出来的,服务端会自动实时转码成 HLS 喂给播放器;内嵌字幕和外挂字幕自动转 WebVTT,多音轨(国语/粤语/原声)网页里直接切。

使用就三步

第 1 步 · 安装(VPS 上执行一条命令)

curl -fsSL https://raw.githubusercontent.com/a317634186/yun/main/install.sh | bash

全自动,不用输入任何东西。首次安装会构建转码服务镜像,比以前多花 1-3 分钟。装完屏幕上会显示网址、账号 admin、密码,截图保存。

记得在云服务器控制台的安全组放行 5244 端口,否则网页打不开。 提示 Could not resolve host(DNS 问题)先执行:

systemctl disable --now systemd-resolved 2>/dev/null; rm -f /etc/resolv.conf; printf 'nameserver 1.1.1.1\nnameserver 8.8.8.8\n' > /etc/resolv.conf

第 2 步 · 打开网页,输入密码

浏览器打开 http://你的VPS_IP:5244,就是登录页:账号 admin + 安装时显示的密码(浏览器会记住,下次自动登录)。

第 3 步 · 粘链接 → 等下载 → 直接看

  1. 顶部输入框粘贴磁力链接(magnet:?xt=... 或 .torrent 文件的下载链接)→ 点「添加下载」
  2. 「下载列表」实时显示进度条(内置高速下载:64 分片、16 连接、自动 tracker)
  3. 点任务的「展开文件」→ 对着视频点「▶ 播放」,下载中也能先看
  4. 「播放记录」自动记录看到哪了,下次点击从上次位置继续;看完的标 ✅

下载是怎么走的(为什么下载中就能播)

磁力/种子链接 → aria2 直接下到 downloads/ → 立刻可播

直连 aria2,不经 AList 的「先下到临时目录、再转存」两段式。 这一步是关键:

  • 老流程里文件下载期间躺在 AList 临时目录,播放器看不到,必须等下完 + 搬完才能播;而 BT 下完会继续做种,任务永不结束,转存也就永不触发,表现就是"进度 100% 却没有播放按钮"
  • 现在文件从第一秒就落在 downloads/ 里,配合 bt-prioritize-piece=head=32M,tail=32M(先抓文件头尾,让 moov/索引尽早到手)和 seed-time=0(下完不做种),下载中点开就能看
  • 任务的文件清单直接来自 aria2,不再靠任务名去猜文件夹。多文件种子展开后每一集都有独立进度和播放按钮

aria2 连不上时,前端会自动回退到原来的 AList 离线下载(功能仍可用,只是回到"要等转存"的老行为),并在界面上标出来。

在线播放是怎么做到的

点播放后,服务端先探测这个文件浏览器到底能不能吃,然后二选一:

模式 什么时候用 特点
原画直连 mp4/webm 容器 + H.264/VP9/AV1 + AAC/MP3/Opus 零 CPU 占用、随便拖进度条、下载中就能看
实时转码 其余全部情况(MKV / H.265 / 10bit / AC3 / DTS / AVI / TS…) 转成 HLS 喂给播放器,同样能拖进度条,顺带把带宽压下来

播放器上方会显示当前用的是哪种模式和原因,右边可以手动切清晰度 / 音轨 / 字幕。直连播不动时会自动降级去转码,不用你自己判断格式。

转码的实现是每个分片独立起一个 ffmpeg(-ss 精确定位 + -output_ts_offset 拼回全局时间轴),所以:

  • 拖进度条到片尾不用等前面转完,点哪播哪
  • 转好的分片会缓存,回看和二次观看不重复烧 CPU
  • 播放中断/刷新页面不会丢进度

转码要吃 CPU。 安装时会按 CPU 核数自动配一套参数(1 核 → 480p、2-7 核 → 720p、8 核以上 → 1080p),之后可以用 bash menu.sh 菜单 10 随时调。卡顿就把清晰度调低一档,觉得糊就往上调。

存储与流量说明

  • 容量上限 = VPS 硬盘大小(df -h 查看)
  • 播放走 VPS 流量:原画直连看 10GB 电影约耗 10GB 流量;走转码(比如降到 720p)通常能省下一半以上
  • 自动清理由服务端常驻执行:下载文件默认保留 1 小时,磁盘占用超过 90% 会提前删最旧的,正在看的文件不会被删。网页关掉照样生效(旧版本的清理写在前端 JS 里,不开网页就不执行)
  • 保留时长、磁盘水位、缓存上限都可以用菜单 10 改,RETENTION_HOURS=0 就是永不自动删

安全说明

  • 视频直链 /d/... 和目录列表 /ls/... 都需要登录后下发的签名票据才能访问(HMAC 签名,默认 12 小时有效),不再是知道 IP 就能列目录、拖走文件
  • 想关掉这层校验(不建议):.env 里设 AUTH_ENFORCE=0
  • 仍然建议只在自己用的机器上开放端口,或者套一层 HTTPS 反代

可选功能

  • 挂载网盘扩容:VPS 磁盘不够时,访问 http://IP:5244/@login 打开原版 AList 管理后台 → 存储 → 添加 OneDrive / Google Drive
  • 硬件加速:机器有核显/独显时,.env 里设 HWACCEL=vaapi(或 qsv / cuda)与 VIDEO_ENCODER=h264_vaapi,转码能力可以翻好几倍

管理(VPS 上执行 bash menu.sh)

  ------------------------------------------------
    yun 云播放器  ·  已安装 · 服务运行中 · 转码就绪 720p
    面板地址: http://你的IP:5244
  ------------------------------------------------
    1. 安装
    2. 更新
    3. 卸载
    ------------------------------------------------
    4. 查看服务状态
    5. 重启服务
    6. 停止服务
    7. 查看日志
    ------------------------------------------------
    8. 重置管理员密码
    9. 修改访问端口
   10. 播放与清理设置(清晰度 / 保留时长 / 磁盘上限)
    ------------------------------------------------
    0. 退出
  ------------------------------------------------
  请输入你的选择:

菜单顶部实时显示安装状态、运行状态、转码服务状态和面板地址。忘记密码选 8。

常见问题

问题 处理
网页打不开 云厂商安全组放行 5244 端口;bash menu.sh 选 7 看日志
登录一直转圈/失败 bash menu.sh 选 8 重置密码后重试
磁力下载没速度 种子冷门,属正常现象;换热门种子测试
画面卡一下一下的(转码模式) CPU 不够。菜单 10 把清晰度降到 480p、画质调到 26
提示「转码超时」 同上,降清晰度;或改用 X264_PRESET=ultrafast
有画面没声音 换个音轨试试;日志里看 ffmpeg 报错
字幕不显示 只支持文本字幕(SRT/ASS);蓝光原盘的 PGS 图形字幕转不了,不会出现在列表里
下载中播放报错 头尾已优先抓,但中间数据仍是乱序到的。等进度再多一点重试
进度 100% 却没有播放按钮 老版本的「转存没触发」问题。更新后新任务走 aria2 直连不会再有;旧任务在界面上会给出提示
提示「aria2 直连不可用」 已自动回退,功能仍在。查 docker exec yun-caster wget -qO- http://alist:6800/jsonrpc 是否可达;有 RPC 密钥就填到 .env 的 ARIA2_SECRET
401 / 一直提示重新点击播放 票据过期,重新点一次播放即可
视频列表全空 转码服务没起来(目录列表要它鉴权)。bash menu.sh 选 4 看状态
VPS 磁盘满 网页里删除看完的文件,或把 RETENTION_HOURS 调小

目录结构

yun/
├── install.sh            # 一键安装脚本
├── menu.sh               # 管理菜单
├── web/index.html        # 播放器前端页面(输入框+播放器+记录)
├── caster/               # 播放服务:探测 / 转码 / 字幕 / 鉴权 / 清理
│   ├── app.py            #   纯标准库 HTTP 服务,调 ffmpeg 干活
│   └── Dockerfile        #   python + ffmpeg + 内置 hls.js
├── nginx.conf            # 前端页面 + 接口/视频反代 + 直链鉴权
├── docker-compose.yml    # alist + caster + web 三个容器编排
├── .env.example          # 配置模板(端口、转码参数、清理策略)
├── data/                 # AList 数据(运行时生成)
├── downloads/            # 下载存放目录(运行时生成)
└── cache/                # 转码分片缓存(运行时生成,可随时删)

致谢

  • AList — 后端 API 与文件服务
  • aria2 / P3TERX 配置 — 高速下载引擎与调优配置
  • FFmpeg — 探测、转码与字幕转换
  • hls.js — 浏览器端 HLS 播放
  • nginx — 前端承载与反代

免责声明

本项目仅提供下载与播放工具的部署配置,请遵守所在地区法律法规使用。

About

☁️ 开源云播放器:磁力/种子离线下载 + OneDrive/Google Drive 云盘挂载 + 网页在线播放,AList + Aria2,Docker 一键部署

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages