Veyra

项目概述

Veyra 是一个短剧聚合播放器，由 Android 客户端（APK）与自建 Node.js 后端（Docker 镜像）两部分组成，支持红果与黄果短剧的在线播放、私密模式鉴权、代理绕行，以及手机端与 NAS 端的下载合并。后端地址由用户在登录页自行填写，不内置任何私有域名；手机端合并引擎为自研 NDK 移植 ffmpeg 加手写 JNI，仓库已带预编译 so 库，无需本地工具链即可构建。

项目	内容
平台	Android 客户端 + Docker 后端
技术栈	Java、Kotlin、C（JNI）、Node.js
后端端口	8888（可用 PORT 修改）
许可	GPL-3.0

客户端与后端都握在自己手里，短剧怎么看、下到哪，由你决定。

主要功能

• 多源播放：红果、黄果短剧在线播放，后端地址由用户自填，不内置任何私有域名
• 账号体系：登录注册由后端 WebUI 动态控制，账号与设备无关
• 私密模式：输入后端动态码解锁，鉴权一次跟随账号，管理员账号免输直进
• 代理绕行：黄果可配置代理端口，代理不通自动经后端转发，红果不受影响
• 手机端下载合并：10 路并发下载后本地规范化并合并为单文件，合并失败自动降级保留分集可重试
• NAS 端下载合并：管理员可将剧集下载到 NAS，后端用 ffmpeg 解密合并，产物直接可播
• WebUI 管理台：用户列表、角色切换、删除用户与注册开关管理，凭管理员密码进入

适用人群

• 自建 NAS 用户
• Docker 部署爱好者
• 短剧追剧用户
• 重视数据自主的用户

快速上手

1. 在 NAS 或任意 Docker 主机上用 Docker Compose 部署后端，端口默认 8888，务必修改 ADMIN_PASSWORD
2. 国内拉不动镜像时，从 Releases 下载 veyra-backend.tar，拷到 NAS 后 docker load -i 导入
3. 安装 APK，首次打开在登录页填写你自己的后端地址（如 http://192.168.x.x:8888）
4. 公开模式直接观看红果；需要私密模式时在设置中输入后端动态码
5. 详情页选择集数，下载到手机（本地合并）或下载到 NAS（管理员）

核心优势

• 数据自主：后端完全自建，账号、任务与下载产物都存在自己的服务器上
• 自研合并引擎：NDK 移植 ffmpeg 加手写 JNI 完成解密、规范化与合并，与后端下载器语义对齐
• 双端下载：普通用户下载到手机本地，管理员还能下载到 NAS 统一存储

系统要求

项目	要求
客户端	Android，arm64-v8a（内置预编译 libffconcat.so）
后端	任意 Docker 主机（NAS、服务器）
端口	8888（可用 PORT 环境变量修改）
构建	Android SDK 与签名密钥（仅自行构建 APK 时需要）

注意事项

• 内容版权：内容版权归各内容源所有，本项目仅提供技术实现，请勿用于非法用途
• 管理台密码：部署后端时务必修改 ADMIN_PASSWORD 默认值，防止管理台被随意进入
• 离线导入：Docker Hub 拉取困难时优先用 Release 附带的 veyra-backend.tar 离线导入
• 代理仅限黄果：代理绕行设置只对黄果生效，红果播放不受代理影响