把「刷到好视频」从手动下载变成自动归档
- 2026-11-22 12:17:15
一个 89 星的小众工具,把「刷到好视频」从手动下载变成自动归档:MediaSync 装进 NAS 全解

图 1|MediaSync:把下载、订阅、直播录制装进你自己的 NAS
先说场景,你大概率也遇到过:晚上刷 B 站刷到一个讲调色思路的教程,想着「这个得存下来,回头跟着练」,手指一滑点了收藏。然后这个收藏就再也没被打开过。等你真要找它的时候,平台改版、UP 主删视频、清晰度变糊,三件套排队上门。
不少人解决这个问题靠的是 yt-dlp,命令行确实强,但它有个绕不开的问题——每次都要你主动想起来去敲命令。一个只在手动执行时才工作的工具,本质上还是在跟人的记性较劲。GitHub 上有个 lincolnpark2000/MediaSync,89 star、10 fork、15 个 commit,数字小得可怜,但它做的事正好对着这个痛点:把「解析下载」从命令行搬进 Web UI,再挂到 NAS 上变成会自动跑的订阅。
先把话说在前面:这篇是把它的 README、六份 guides 文档和全部界面截图逐条读完后整理的(截图里的界面文字我用 OCR 核对过,端口、挂载、参数都对着原文抄),但我自己没有 NAS 做真机部署实测。所以凡是文档写得含糊或者前后矛盾的地方,我会明确标出来,而不是替你猜一个答案。
这篇讲清楚三件事:它是什么、怎么装、值不值得你花这两个小时。

图 2|MediaSync 能力地图:模块、平台与 PRO 边界
一、它到底是什么:一个把 yt-dlp 藏到界面后面的媒体管家
一句话概括:多平台视频/图片下载 + 订阅同步 + 直播录制 + 文件管理,全部塞进一个 Web UI,Docker 一键起。
技术栈是现在很顺手的组合——前端 Next.js 16 + React 19 + TypeScript + Tailwind CSS 4,后端 FastAPI,解析引擎是 yt-dlp 加 f2(抖音那条线)再加各平台自己的解析模块,媒体处理靠 FFmpeg,数据用 SQLite,通知走 Telegram Bot 和企业微信,备份支持 WebDAV。部署方式是 Docker 多阶段构建,另外给了 Windows 桌面安装包。
覆盖的平台比我预期宽。除了 YouTube、B 站、抖音、小红书、Twitter/X、Instagram、Pinterest、微博这些常规选手,还有几个很有意思的:微信视频号(需要你在 Cookie 设置里配腾讯元宝的登录态)、微信公众号(抓正文里的图片和可获取的视频)、Telegram 频道相册、新片场,以及 Behance、Squarespace 这类作品页的图片/GIF/内嵌视频。优酷、爱奇艺、腾讯视频、央视频也在列表里,但官方话说得很老实:只能拿到「账号权限范围内、解析器可获取、且未受 DRM 保护」的部分。

图 3|MediaSync 单个解析页面:粘贴链接即可解析下载
二、五个模块,其中两个是 PRO,这一点必须提前知道
界面按功能分成五块:媒体解析(单个/批量)、关注收藏与聚合搜索、订阅同步、直播监控与录制、下载任务与文件浏览,再加一个设置中心。
这里有个坑我得放在最前面讲:README 里「订阅同步」和「直播监控与录制」这两块标题后面都跟了一个 · PRO。也就是说,自动订阅追踪和直播录制不是默认就给你的,需要 License 激活。好消息是,在「设置中心 → 系统设置 → License 管理」里,除了「激活 / 查看 License 状态」,还明明白白写着一行「免费激活码申请」。所以别看到 PRO 就划走,先去申请一个激活码,成本可能就是填个表。
如果你只是想「粘贴链接→下载」,那前面两个模块完全够用,跟免费工具没区别;真正拉开差距的自动化能力才在 PRO 里。这个边界搞清楚再决定要不要花时间部署,别装完了才发现要激活。

图 4|MediaSync 订阅同步:按 UP 主、收藏夹、画板建立长期追踪
三、部署:三条路,Docker 是文档写得最完整的那条

图 5|MediaSync 部署路径选择与端口对照
路径一,Windows 桌面版,最省事。去仓库 Releases 下 MediaSync-Setup-*.exe,装完启动,按首次运行提示设好保存目录,需要的话再配平台登录和代理。适合只想在自己电脑上下载、不想折腾 NAS 的人。
路径二,Docker / NAS,文档写得最细的一条,也是这个工具真正的形态。群晖、威联通、极空间、绿联这些支持 Docker 的 NAS 都能跑。新建一个 compose.yaml:
services:
mediasync:
image:lincolnpark2000/mediasync:latest
container_name:mediasync
restart:unless-stopped
ports:
-"4399:3000"
volumes:
-./downloads:/downloads
-./data:/app/data
-./live_recordings:/live_recordings
environment:
MEDIASYNC_DATA_DIR:/app/data
BACKEND_URL:http://localhost:9000
#ALL_PROXY: http://你的代理地址:端口
然后 docker compose -f compose.yaml up -d,浏览器打开 http://localhost:4399(NAS 上就把 localhost 换成设备 IP)。前端会代理后端请求,后端的 9000 端口不用另外映射,这点省了不少事。
路径三,源码本地跑,适合想改代码的人。需要 Python 3.11+、Node.js 20+,以及命令行能调到的 FFmpeg。Windows 可以在源码目录直接双击 start.bat,脚本会检查依赖并启动。注意端口跟 Docker 完全不同:源码是前端 3100、后端 8000,Docker 是对外 4399、容器内后端 9000,改后端端口记得同步设置前端的 BACKEND_URL。
三个必须提醒的点:
1. 镜像大约 2GB,因为里面打包了 Chromium 和 FFmpeg,NAS 上先确认留出空间。
2. `/app/data` 一定要挂载。这个目录存的是 Cookie、配置、订阅数据库和缓存,没挂上的话容器一重启,你所有平台的登录态全丢,得重新扫码一遍。官方 NAS 指南里专门用警告框强调了这条。
3. README 和 NAS 指南的镜像名不一样。README 快速开始写的是 lincolnpark2000/mediasync:latest(直接拉镜像仓库),NAS 指南的示例写的是 mediasync:latest(本地构建出来的镜像名)。照抄指南却发现拉不到镜像的,就是这个原因——从源码构建才需要 --build,直接部署请用带仓库名的那个。

图 6|MediaSync NAS Docker 部署五步与挂载路径
四、装好之后先干这五件事
官方「首次使用」给了五步顺序,下面按 guides 里散落的细节把它补全。
第一,配存储。「设置中心 → 下载路径」里设目录、文件名模板和默认下载位置,Docker 里必须填容器路径——下载目录填 /downloads,直播录制目录填 /live_recordings。文件名和目录支持 {platform} {uploader} {playlist_name} {title} {date} {year} {month} {day} {time} {random} 这些变量,按「平台/作者/日期」分文件夹,是这些变量能直接拼出来的常用组合,回头找素材不用靠记忆。
第二,登录平台。「设置中心 → Cookie」里按平台扫码、浏览器登录或者直接导入 Cookie。这一步决定了你能拿到什么画质,单个解析页面右侧的「说明 & 画质提示」写得很直白(我截图里逐条读了一遍):B 站普通账号最高 1080P,大会员才能解锁 4K / HDR / 杜比视界,充电专属视频要充电会员;YouTube 有 Cookie 才能下 Premium 高画质、会员专属和年龄限制内容;Instagram 未登录时图片会被压缩或加水印,登录 Cookie 才拿得到原始尺寸;Pinterest 公开画板不用登录就能解析,私密画板要 Cookie。
第三,配代理。要看 YouTube 就得配,在「设置中心 → 代理设置」填 HTTP/HTTPS/SOCKS 地址。⚠️ 容器里填 `127.0.0.1` 是经典大坑——那个地址指向容器自己,不是你的宿主机。得填容器能访问到的宿主机 IP 或者局域网地址,并且确认代理允许这个来源连接。
第四,试一个链接。进「媒体解析 → 单个解析」,粘贴链接点解析,选画质,选下载到本地还是服务器。这里有个我很喜欢的细节:解析单个视频后,如果系统检测到它属于某个合集或播放列表,页面下方会自动出现「解析全部视频」按钮,一键把整个系列捞下来。跟「批量解析」配合用,几十个链接每行一个粘进去,全部解析完统一选格式批量下。
第五,按需自动化。创建订阅、加直播间、配通知渠道,用「数据同步」把配置备份到 WebDAV。

图 7|MediaSync 批量解析:多平台链接一次性解析下载
五、真正让它甩开 yt-dlp 的三件事
第一件:从「下载一条」变成「追踪一个人」。订阅同步支持 B 站收藏夹/稍后再看/关注 UP 主、YouTube 播放列表/关注频道、抖音收藏/关注博主、小红书收藏、Pinterest 画板。创建时配三个参数:扫描间隔、扫描项数上限、发现新内容是否自动下载。扫描分两种——快速扫描看近期内容,深度扫描补齐历史内容,之后走增量扫描。订阅卡片上直接显示「监控数 / 下载数」和上次扫描时间,还能勾选「已下载项」做去重。这才是它和命令行工具的分水岭:你不再需要记得去看有没有更新。
第二件:直播录制。支持开播监控 + 自动录制,录制参数可以按全局、平台、房间三级分别配置,画质、保存目录、文件名模板都能定制,支持按时长或文件大小分段、只录音频,录完还能做 FLV 修复、MP4 转换和封面提取。房间卡片会显示录制次数、累计大小、录制质量,以及「直播进行中 - 未开启监控」这种状态,一键「开启监控」。
这里我发现一个文档口径不一致:README 说直播录制支持 B 站、抖音、虎牙、斗鱼、Twitch、YY、网易 CC、AcFun、微博、小红书等,但 guides/live-recorder-guide.md 里只写了「Bilibili 直播、YouTube 直播等,更多平台持续扩展中」。两处对不上,实际能录哪些建议以你界面上能添加的房间为准,别按 README 那张清单下结论。
第三件:把 NAS 变成可以用聊天窗口指挥的机器。通知渠道支持 Telegram Bot 和企业微信,可按事件自定义模板;填了「服务器公网地址」之后,下载完成和录制完成的通知里会直接带上可点击的在线播放和下载链接。配好命令接收后,能在聊天里发 /analyze <链接>、/download <链接>、/subscribe <链接>、/status、/help 来远程操作,Telegram 里甚至直接把链接甩给机器人,它自动识别类型给出可执行操作。
企业微信这里有个坑要单独说:只配 CorpID / Secret / AgentId 只能收通知,发命令是没反应的。命令模式还需要在企业微信应用里配消息回调,回调地址指向 你的MediaSync地址/api/notifications/wechat/callback,再加 Token、EncodingAESKey,最后在通知配置里打开 enable_commands。这五项少一个就只能被动收消息。

图 8|MediaSync Telegram 通知与远程命令效果

图 9|MediaSync 下载任务与文件浏览:进度、画质、大小与在线播放
六、不好听的部分,我也照直说
成熟度是真的浅。15 个 commit、89 star、0 个 watcher,这意味着接口变动时你得自己盯 issue。仓库 FAQ 末尾那句「欢迎提交 Issue」的链接到现在还是 https://github.com/your-repo/mediasync/issues 这种占位符没替换——项目作者还没来得及把文档细节收拾干净,这是个很实在的信号:功能跑得起来,但工程规范还在路上。
B 站风控会找上你。批量拉收藏夹、并发调高,很容易撞到频率限制。官方给的缓解路径是:设置里切到「安全」或「极端安全」预设、降低并发、增大请求间隔、等 5-10 分钟再试,另外确保 Cookie 没过期。字幕也有硬限制——最多两种语言(默认/原始语言 + 简体中文),不是你想的全量下载。
403 / 412 基本都是 Cookie 的锅。平台 Cookie 有效期差别很大:B 站通常能撑几个月但频繁使用可能被登出,YouTube 较长,抖音偏短。遇到「拿不到收藏夹」「高清画质不可用」,第一件事是去 Cookie 页面看登录状态,别怀疑人生。
页面能打开但解析失败,查 `BACKEND_URL`。这个报错路径太典型了:前端代理没指向容器内的 http://localhost:9000,界面一切正常,API 全挂。
PRO 是道真实的门。前面说过可以申请免费激活码,但如果你不想申请、或者以后收费策略变了,那订阅和直播录制这两块核心自动化就用不了,工具的价值会掉一大截。
升级和备份还算让人放心。数据都在宿主机挂载目录里,docker compose pull 再 up -d 就完成升级,Cookie、配置、下载历史都保留。但注意:设置里的导出和 WebDAV 备份只覆盖配置与记录,不等于完整媒体备份,Telegram 账号会话也不在普通配置导出里。

图 10|MediaSync 常见故障排查速查表
七、合规这条线,别踩
这部分不是我提醒你,是仓库自己在 README 里写明的:请仅下载和保存自己创作、获授权或依法可使用的内容,并遵守来源平台的使用规则;媒体版权归原作者或权利人所有。
再补三条实操判断:DRM 保护的内容它拿不到(优酷爱奇艺那类只在「未受 DRM 保护」的前提下可解析);平台接口和访问策略一变,部分功能就会失效,这是这类工具永恒的宿命;以及最重要的一条——下载下来自己备份、离线看,和二次分发、搬运牟利,是完全不同的两件事,后者跟你用什么工具没有任何关系,都是违法的。工具解决的是「我收藏的东西我打不开了」,不是「别人的作品我拿来用」。
写在最后
值不值得装?我的判断分三种人:
值得:素材党、教程党、有 NAS 的人。你缺的从来不是下载能力,是「不用我记着」的机制,订阅同步解决的就是这个。
先别急:只想偶尔下一条视频的人,用在线解析工具就够了,2GB 镜像 + Cookie 维护 + 可能的 PRO 激活,不值得。
别用:想拿来批量搬运别人内容的人,这条路本来就不该走。
装的过程卡在哪一步了——镜像拉不下来、代理不通、企业微信命令没反应、还是激活码不知道去哪申请——评论区说一声,文档里有答案的我尽量把原文给你翻到。觉得有用,点个「在看」给作者也给我一点更新的动力。