NAS 媒体中心 · 自动追番 · 文件整理 · 音乐四端播放

MediaManager

你的 NAS 媒体中心,装好就不用管

订阅剧集自动追番下载、整理归档;把 NAS 音乐扫描入库、统一管理。
管理:Web + App 双端 | 音乐播放:Windows / Web / 手机 App / 鸿蒙 四端

01 · CORE FEATURES

四件事,装好就能用

自动下载追番 · 文件整理 · 音乐管理 · 音乐播放,围绕 NAS 媒体的完整闭环

自动下载追番

订阅一次,新集自己下

  • 定时抓取 BT 资源站磁力,无人值守
  • 多集过滤、跨源按 hash 去重
  • 下完自动归档,进媒体目录即可播放
看追番流程 →
订阅跟踪列表

文件整理

下载完就是标准命名

  • 下载完成自动归档到媒体目录
  • 批量标准命名(SxxExx / .Exx.Sxx)
  • 分散文件批量合并,外部播放器直接识别
看整理能力 →
文件管理与批量编码

音乐管理

把 NAS 音乐变成私人曲库

  • 9 种音频格式扫描入库,多源刮削补全
  • 封面 / 歌词缓存,缺失字段逐项兜底
  • 按文件名 / 歌手 / MD5 智能去重与播放列表
看音乐管理 →
音乐库管理

音乐播放

四端接力,进度不丢

  • Windows / Web / 手机 App / 鸿蒙 四端全覆盖
  • HTTP Range 流式,WMA / APE 实时转码
  • 锁屏 / 通知栏媒体卡片,后台播放不中断
看四端能力 →
Windows 桌面端播放器
02 · AUTO DOWNLOAD

自动追番:配置一次,全季无忧

订阅的剧集更新后自动抓取磁力、自动下载、自动归档,全程不用盯

1

订阅剧集

添加剧集地址,设置季度、起始集数与清晰度,可同时监控多个资源站。

→
2

定时抓取

node-cron 定时调度,解析页面中的磁力链接,多集批量过滤、跨站去重。

→
3

自动下载

新集磁力自动进 QinTorrent 下载队列,支持限速、Peer 管理与断点续传。

→
4

归档入库

下载完成按剧集 / 季数规则整理进 NAS 媒体目录,命名直接给播放器识别。

失败自动重试与自愈 清晰度 / 集数过滤 跨站按 hash 去重 仅支持 BT 下载类资源站
03 · FILE SORTING

文件整理:下载完就是标准命名

不用再手动改名、搬目录,归档、编码、合并和空间查看都在一个页面完成

下载完成自动归档

按剧集 / 季 / 集规则自动移动到媒体目录,不用二次整理。

批量标准命名

多选文件一次编码为 SxxExx / .Exx.Sxx 形态,外部播放器可直接刮削。

文件夹批量合并

把下载分散的多个子目录合并到同一剧集目录,告别碎片化。

目录树与空间

左侧目录树懒加载,右侧列表支持移动、删除、重命名与空间查看。

文件管理:目录树、批量编码与合并
04 · MUSIC

音乐:管得清楚,四端播得顺

把 NAS 里的音乐整理成私人曲库,管理在 Web 与 App,播放在四个端

音乐管理

一键扫描 NAS 音乐目录,自动提取标题、艺术家、专辑、封面与歌词,多源刮削补全缺失信息, 重复文件智能检测,把曲库整理得井井有条。

  • 支持 mp3 / flac / ogg / wav / m4a / aac / wma / ape / opus 九种格式
  • MusicBrainz 多源元数据刮削,字段级独立兜底
  • 封面自动提取缓存,嵌入式歌词与 LRC 同步解析
  • 播放列表、播放历史与热门排行,按文件名 / 歌手 / 歌名 / MD5 智能去重
音乐库管理

音乐播放

基于 HTTP Range 的流式播放,不落盘、不转码损耗;WMA / APE 等特殊格式自动调用 FFmpeg 实时转码。Windows 桌面端、Web、手机 App 与鸿蒙四端都能接着听。

  • Windows / Web / 手机 App / 鸿蒙 四端全覆盖,账号与曲库同步
  • 移动端锁屏 / 通知栏媒体卡片,后台播放不中断,移动网络自动省流
  • 顺序 / 随机 / 单曲循环,进度记忆与跨端续播
  • 播放时自动补全封面、歌词与专辑信息
Windows 桌面端播放器
05 · MORE

更多能力

影视发现、下载引擎与家庭共享,同样内置

热门影视榜单

豆瓣热门剧集 / 电影分榜,一键转订阅。

影视多源搜索

3 个资源站并行检索,坏源自动识别。

搜索转订阅

批量勾选结果,按 hash 跨源去重后入库。

QinTorrent 引擎

uTP / TCP 双协议、DHT 双栈、HTTP 回退兜底。

亲友邀请注册

一次性邀请链接,15 分钟内有效,微信发给亲友即可注册。

06 · MULTI-PLATFORM

管理双端,播放四端

一套账号与媒体库:Web 与 App 都能管理,音乐在 Windows / Web / 手机 / 鸿蒙 都能播

管理端Web + App

Web 管理后台

追番订阅、下载任务、文件整理、音乐库、用户权限、定时任务与日志。

手机 App

首页总览、文件管理、影视追番、下载任务、音乐库、定时任务与用户管理。

播放端4 端全覆盖

Windows

桌面播放器,后台常驻与进度续播。

Web

浏览器打开即听,无需安装。

手机 App

Android / iOS,锁屏通知栏与后台播放。

鸿蒙

原生播放与通知栏控制。

客户端下载

Windows 桌面端

正在获取最新安装包…

Android App

正在获取最新安装包…

HarmonyOS

点我扫码下载

Android 可直接下载上方 APK 安装包,也可前往应用商店搜索 “QM影音”; iOS(苹果)与 HarmonyOS(鸿蒙)请前往对应应用商店下载;Windows 用户直接下载上方的安装包(安装包未签名,首次运行如遇 SmartScreen 拦截,请点“更多信息 → 仍要运行”)。

07 · DEPLOYMENT

快速部署

Docker 一键部署,五分钟上线你的 NAS 媒体中心;示例只保留必要参数,其余见下方可选说明

适配主流 NAS,有 Docker 就能跑

以 Docker 镜像交付,不挑品牌与机型:成品 NAS、自建 Windows / Linux 小主机, 只要能运行 Docker 容器就能部署。

群晖 Synology 威联通 QNAP 绿联 UGREEN 铁威马 TerraMaster 爱速特 ASUSTOR 万由 UNAS 极空间 * TrueNAS unRAID Windows / Linux

* 极空间需选用官方固件已开放 Docker 的机型;各品牌入口不同,compose 与挂载方式一致。

  • 官方镜像 compose 一键启动
  • host 网络适配 P2P / IPv6
  • 数据、日志、下载全挂卷,升级重建不丢
正在获取服务端镜像…
docker-compose.yml
        services:
          node:
            image: mediamanager:latest
            container_name: mediamanager
            # P2P 下载需要 IPv6 直通,bridge 模式无 IPv6 时连不上 v6 为主的 peer
            network_mode: host
            volumes:
              # 数据 / 日志 / 下载缓存:持久化,容器重建不丢
              - /vol2/1000/www/mediamenage/data:/app/data
              - /vol2/1000/www/mediamenage/logs:/app/logs
              - /vol2/1000/www/mediamenage/downloads:/app/downloads
              # 媒体存储:容器内 /video/**(对应默认 ROOTPATH=/video,按你的卷增删)
              - /vol1/1000/music:/video/music
            # 以下几项建议按需设置,其余全部有默认值;JWT 密钥无需配置(见下方说明)
            environment:
              # ⚠️ 注册邀请码,逗号分隔,建议配置多个,逗号隔开防止泄露后被攻击;不配置即关闭注册(三端注册入口随之隐藏)
              - INVITE_CODES=change-me
              # 首次初始化管理员账号,仅建库时生效,之后请在管理端修改
              - ADMIN_USERNAME=admin
              - ADMIN_PASSWORD=admin
            # 堆 2048MB + BT 原生缓冲,低于 3g 做大种子做种易被 OOM 杀掉,可以根据你的实际情况调整,至少保证2G,否则一旦任务多了可能会被OOM
            mem_limit: 4g
            restart: unless-stopped
            # 需要覆盖时再按下方「可选参数说明」追加
          

可选参数说明:均已在镜像或代码中兜底,只在需要覆盖时加到 environment 里

端口与网络

  • PORT9011后端 HTTP 服务端口;LSD 局域网发现复用它的 UDP 半边
  • MAGNETPORT9012BT 下载端口,TCP 监听与 uTP(UDP)共用同号,出站 TCP 也绑定此源端口
  • DHT_PORT9013DHT 双栈 UDP 端口,独立于 MAGNETPORT 以免与 uTP / LSD 抢端口
  • UDP_TRACKER_PORT9014UDP Tracker 固定端口(自研 BEP-15 客户端单 socket 服务全部 udp:// Tracker,不再每个 tracker 一个随机端口)
  • host 网络模式下容器端口即宿主机端口,无需 -p 映射;改端口记得在 NAS 防火墙 / 安全组同步放行对应 TCP + UDP。

路径与持久化

  • ROOTPATH/video媒体根目录:文件浏览、下载归档的总入口,取的是上方 /video/… 这批挂载的父目录;媒体分散在多块卷时继续按 /video/1、/video/2 … 增挂即可,ROOTPATH 保持不变

日志与数据库

  • LOG_LEVELinfo支持 debug / info / warn;默认已按生产口径取 info,排障时才临时开 debug(BT 引擎日志很密,debug 会把日志刷得很大)
  • LOG_TO_FILELOG_TO_CONSOLELOG_COLORLOG_DIRtrue / true / true / ./logs分别控制写文件、写控制台、彩色输出与日志目录(仅显式写 false 才关闭);单文件满 10MB 轮转,最多保留 30 份
  • DB_ENABLE_LOGSfalsetrue 时打印 SQL 语句,仅排障时开启

运行时与安全

  • NODE_ENVNODE_OPTIONSUV_THREADPOOL_SIZEproduction / 堆 2048 / 16由镜像 ENV 注入,必须在 node 启动前就位(写进 .env 无效,CMD 不经 npm scripts)。覆盖堆上限时要同步抬高 mem_limit,否则容器会因 RSS 超限被 OOM 杀掉。
  • TZAsia/Shanghai镜像已内置时区(tzdata + /etc/localtime),日志时间戳按它取值;容器内需要别的时区再显式覆盖
  • commandnode index.js镜像 CMD 已定义,一般无需写;只在换启动方式(如加 --inspect)时覆盖
  • ACCESS_TOKEN_EXPIRES_IN2haccessToken 有效期(可写 30m);JWT 签名密钥无需配置:首次启动自动生成强随机密钥并持久化到 data/config/.jwt_secret(随 data 卷保存,升级重建容器不丢),refresh / persist 密钥由主密钥派生;删除该文件重启即轮换密钥,代价是全员重新登录
  • ALLOWED_ORIGINS空NODE_ENV=production 时跨域白名单(逗号分隔),不开放跨源就不用配;同域部署(前端由服务端托管)同样无需设置
08 · CHANGELOG

更新记录

已发布的版本更新历史

正在获取更新记录…