leedaisen/leelaa-drama-server repository overview

⁠短了个剧 · Leelaa Drama

把 NAS 中的本地短剧，变成随时打开就能观看的私人剧场。

短了个剧是一款面向本地短剧的媒体管理与网页播放器。通过 Docker 部署，将已有短剧目录挂载到容器，即可在手机、平板和电脑浏览器中浏览、搜索和播放。

提供 AMD64、ARM64 架构构建，适用于支持 Docker 的 NAS 和 Linux 环境。

⁠主要功能

• 上下滑刷剧：上下滑动切换短剧，支持剧内自动连播和整部播放结束后切换下一部。
• 选集与续播：自由选择集数，保存观看进度，从历史记录继续观看。
• 多媒体库管理：添加多个短剧目录，统一扫描、搜索、分类和筛选。
• 海报与资料：优先读取本地海报和 NFO，支持生成视频封面及按需匹配短剧资料。
• 收藏与观看历史：集中管理喜欢的短剧和观看记录。
• 多用户使用：管理员创建用户，各自保存收藏、历史和播放偏好。
• 播放控制：支持进度定位、0.5–3 倍速、音量调节及浏览器支持的全屏功能。
• 按需播放处理：兼容媒体直接播放，其他格式按需封装或使用 CPU 软件转码。
• 手机主屏幕入口：通过可信 HTTPS 地址访问时，可使用支持的浏览器添加到主屏幕。

⁠使用方式

1. 使用 Docker Compose 部署容器，持久化应用数据和密钥。
2. 将 NAS 上已有的短剧目录只读挂载到容器的 /media。
3. 在浏览器中打开 http://NAS地址:9906/。
4. 登录管理员账号，修改初始密码。
5. 在「设置 → 媒体库管理」中添加 /media 下的目录并扫描。
6. 扫描完成后即可观看，也可以创建普通用户供家人使用。

建议每部短剧使用一个独立文件夹：

短剧目录/
  剧名 A/
    poster.jpg
    tvshow.nfo
    01.mp4
    02.mp4
  剧名 B/
    第1集.mkv
    第2集.mkv

支持扫描 MP4、M4V、TS、MOV、MKV、WebM 等常见格式，实际播放方式取决于媒体编码和浏览器能力。

⁠账号与授权

Docker 版使用独立本地账号，每个实例只有一个管理员，普通用户由管理员创建。

默认管理员用户名为 admin。未指定初始密码时，系统会生成随机密码，可在部署目录执行以下命令读取：

docker compose exec drama cat /data/bootstrap-admin.txt

首次登录必须修改密码。

每个安装实例只需激活一次，同一实例内的用户共享播放授权；收藏、观看历史和播放偏好仍按账号独立保存。首次使用提供 3 天试用，授权价格以应用内显示为准。

⁠数据与挂载

容器服务端口为 9906，默认以 10001:10001 非 root 用户运行。绑定宿主目录时，请确保应用能够读取媒体目录、写入数据目录。

升级或重建容器时，请保留原有数据卷和密钥卷。备份及恢复应同时保留完整应用数据与匹配密钥，密钥丢失将无法恢复加密数据库。

⁠部署说明

• 局域网可直接通过 HTTP 访问，外网访问请配置 HTTPS 反向代理。
• 转码使用 CPU 软件处理，速度与主机性能、源视频编码有关。
• 扫描和播放以只读方式访问原始媒体文件。
• 无需特权模式，也无需挂载 Docker Socket。
• 请使用与主机 CPU 架构匹配的镜像，具体标签以仓库 Tags 页面为准。

短了个剧用于管理和播放你自己的本地媒体，不提供片源、影视下载、在线内容订阅或内网穿透服务。