fnytdlp 使用教程
飞牛 NAS 上的视频下载器，集成 yt-dlp，支持 1000+ 视频站点一键下载。
目录
1. 安装与启动
在 FnOS 应用中心安装
- 下载
fnytdlp.fpk
- 进入飞牛 NAS → 应用中心 → 手动安装 → 选择 fpk 文件
- 安装后应用中心启动应用
- 首次使用点击右下角 ⚙ 设置 → 配置下载路径
直接运行（开发调试）
cd /path/to/fnytdlp
TRM_PKGVAR=/tmp/fnytdlp-test PORT=19634 node ui/server.js
然后浏览器访问 http://localhost:19634
版本号
应用页脚显示当前版本号，如 v0.2.0。
2. 界面概览
**────────────────────────────────────────────────────────────**
** [▶] fnytdlp · yt-dlp 视频下载器 🎨 ❤ ** ← 头部
** 14:28:30 **
** **
** **──────** **──────** **──────** **──────** **
** ** 下载中** **实时速度** **已完成** **总任务数** ** ← KPI 卡片
** ** 3 ** **2.4MB/s** ** 12 ** ** 15 ** **
** **──────** **──────** **──────** **──────** **
** **
** [➕添加] [🔍解析] ** [🗑清理] [⏹全部停止] ** [⚙设置] [🍪Cookie] ** ← 工具栏
** **
** [🔍 搜索 URL / 文件名... ] ** ← 搜索
** **
** [全部 15] [下载中 3] [已完成 12] [出错 0] ** ← 筛选标签
** **
** ☐ 全选 **
** **──────────────────────────────────────────────** **
** ** ⏬ 1080p · 张三的Vlog.mp4 2.4MB/s ** ** ← 任务卡
** ** 📅 2026-06-14 14:20 45% ** **
** ** 🗑 ⏹ ▶ ** **
** **──────────────────────────────────────────────** **
** **
** **──────────────────────────────────────────────** **
** ** ✅ 如何做红烧肉.mp4 12.3MB ** ** ← 已完成
** ** 📅 2026-06-14 14:10 100% ** **
** **──────────────────────────────────────────────** **
** **
** ───────────────────────────────────────────── ** ← 状态栏
** ● 运行中 总计 15 / 下载 3 / 完成 12 **
**────────────────────────────────────────────────────────────**
① 头部
- 左侧：应用 logo + 名称，点击无操作（纯展示）
- 中间：实时时钟（24 小时制 + 日期）
- 右侧：🌙/☀️ 主题切换、❤ 赞助弹窗
② KPI Dashboard（4 张卡片）
| 卡片 |
含义 |
| ⏬ 下载中 |
正在下载的任务数 |
| ⚡ 实时速度 |
当前下载总速度（含 Sparkline 趋势小图） |
| ✅ 已完成 |
下载完成的任务数 |
| 📊 总任务数 |
所有任务总和 |
每张卡片右下角有 Sparkline 趋势图，展示该指标的 6 个采样点滑动窗口。
③ 工具栏
| 按钮 |
功能 |
| ➕添加 |
打开新建下载任务弹窗 |
| 🔍解析 |
输入 URL 预览视频信息（标题/时长/格式等） |
| 🗑清理 |
清理所有已完成的任务（有确认弹窗） |
| ⏹全部停止 |
停止所有正在下载的任务 |
| ⚙设置 |
打开设置面板（基本/高级/过滤） |
| 🍪Cookie |
管理多网站 Cookie 认证 |
④ 搜索栏
按 URL 或文件名搜索任务，实时过滤。
⑤ 筛选标签
| 标签 |
快捷键 |
显示 |
| 全部 |
1 |
所有任务 |
| 下载中 |
2 |
正在下载的任务 |
| 已完成 |
3 |
已完成的任务 |
| 出错 |
4 |
报错的任务 |
⑥ 任务列表
每个任务卡片显示：
- 左侧图标：⏬ 下载中 / ✅ 已完成 / ❌ 出错 / ⏸ 已暂停
- 文件名（截断长名）
- 速度（下载中）或文件大小（已完成）
- 进度条 + 百分比
- 时间
- 右侧操作按钮：🗑 删除 / ⏹ 停止 / ▶ 启动
点击任务卡片任意位置 → 弹出任务详情弹窗，显示 13 个字段。
⑦ 底部状态栏
- 左侧：运行状态指示（● 运行中 / ● 空闲）
- 右侧：任务统计（总计 / 下载中 / 已完成）
3. 下载视频
3.1 添加任务
- 点击工具栏 ➕添加 或按键盘
N
- 在弹窗中输入视频 URL（支持单行粘贴）：
https://www.**.com/watch?v=xxxx
https://www.bilibili.com/video/BVxxxx
https://www.douyin.com/video/xxxx
- 可选：点击 🔍解析第一条 预览视频信息
- 可选：选择 Cookie 认证（如果站点需要登录）
- 可选：选择 格式（默认使用设置中的全局格式）
- 展开 高级选项 可配置输出文件名模板、SponsorBlock、元数据等
- 点击 📥 开始下载
批量添加：每行一个 URL，批量提交。yt-dlp 会自动处理播放列表。
3.2 格式选择
| 选项 |
说明 |
| 使用默认 |
跟随设置中的全局格式 |
最佳画质+音频 bv*+ba/b |
画质优先（推荐） |
最佳画质+最佳音频 bv*+ba |
视频音频分离下载后合并 |
最佳（单文件）b/b |
单个文件不分离 |
最小体积 worst |
最低画质最快速度 |
| 4K/2K/1080p/720p/480p 限高 |
限制最大分辨率 |
| 仅音频（最佳/最小） |
只下载音频 |
自定义格式输入框支持 yt-dlp 格式表达式，如：
bv*[height<=1080][fps<=30]+ba
3.3 URL 解析
在解析弹窗中输入 URL 点击解析，可获取视频的：
- 标题
- 时长
- 上传者
- 可用的格式列表（分辨率/编码/码率/大小）
- 是否支持字幕
3.4 SponsorBlock 广告跳过
支持自动标记/跳过视频中的赞助片段，在新建任务高级选项中用逗号分隔：
| 类别 |
含义 |
sponsor |
广告/赞助段落 |
selfpromo |
作者自推广 |
intro |
片头介绍 |
outro |
片尾 |
interaction |
互动提醒 |
preview |
预告/下集预览 |
music_offtopic |
非音乐内容 |
4. 设置选项
点击 ⚙ 设置 打开设置面板，分为 3 个标签页：
4.1 基本设置
| 选项 |
说明 |
默认 |
| 下载路径 |
视频保存目录，建议 /volX/1000/fnytdlp/ |
应用数据目录 |
| 同时下载任务数 |
最多同时下载几个任务 |
3 |
| 分片并发数 |
单个文件分片下载的线程数 |
4 |
| 默认格式 |
yt-dlp 格式表达式 |
bv*+ba/b |
| 格式排序 |
格式优先级排序 |
res:1080,ext:mp4:m4a |
| 重试次数 |
下载失败自动重试 |
3 |
| HTTP 代理 |
通过代理下载（如 某科学软件/V2Ray） |
空（直连） |
复选框选项：
| 选项 |
说明 |
| 嵌入元数据 |
将标题/上传者/日期写入文件元数据 |
| 下载字幕 |
自动下载字幕 |
| 自动字幕 |
下载自动生成的字幕 |
| 缩略图 |
下载视频缩略图 |
| 单视频 |
不下载播放列表，只下当前视频 |
| 字幕嵌入 |
字幕内嵌到视频文件 |
| 缩略图嵌入 |
缩略图嵌入到视频文件 |
| 仅音频 |
不下载视频，只下载音频 |
| 多音轨 |
下载所有可用音轨 |
| mtime |
文件修改时间设为视频发布时间 |
4.2 高级设置
| 选项 |
说明 |
| 限速 |
限制下载速度（如 5M / 500K） |
| 字幕语言 |
指定字幕语言（如 zh-Hans,en） |
| 音频格式 |
仅音频模式下的输出格式（mp3/m4a/opus/flac） |
| 音频质量 |
0（最佳）~ 10（最差） |
| 合并输出 |
视频音频合并格式（mp4/mkv） |
| 字幕转换 |
字幕格式转换（srt/vtt/ass） |
| 下载归档 |
避免重复下载，已下载的视频 ID 自动跳过 |
| 最大下载数 |
限制一次最多下载多少个视频 |
4.3 过滤设置
| 选项 |
说明 |
| 起始日期 |
只下载此日期后的视频（如 20260101 / today-1week） |
| 截止日期 |
只下载此日期前的视频 |
| 最小文件大小 |
过滤掉小文件（如 50M） |
| 最大文件大小 |
过滤掉大文件（如 2G） |
| 复杂过滤 |
yt-dlp match-filters 表达式 |
5. Cookie 认证
某些网站需要登录才能下载（如 ** 会员视频、B站大会员）。
5.1 获取 Cookie
- 在浏览器安装 Get cookies.txt LOCALLY 扩展
- 登录目标网站（如 **.com / bilibili.com）
- 点击扩展 → 导出 cookies.txt
5.2 导入 Cookie
- 应用内点击 🍪 Cookie
- 填写：
- 名称：唯一标识（如
**、bilibili）
- 网站域名（可选，如
**.com）
- Cookies 内容：粘贴 cookies.txt 全文
- 点击 💾 保存 Cookie
5.3 使用 Cookie
新建任务时，Cookie 认证下拉框选择对应的 Cookie 名称即可。每个网站独立配置，互不干扰。
5.4 管理 Cookie
Cookie 管理界面会列出所有已保存的 Cookie，可逐个删除。
6. 任务管理
6.1 任务状态
| 状态 |
图标 |
说明 |
| 下载中 |
⏬ |
正在下载，显示实时速度 + 进度条 |
| 已完成 |
✅ |
下载成功，显示文件大小 |
| 出错 |
❌ |
下载失败，显示错误信息 |
| 已暂停 |
⏸ |
手动停止，可重新启动 |
6.2 任务操作
- 单击任务卡 → 查看详情（13 个字段）
- 点击 🗑 → 删除任务（可选择"仅删除记录"或"删除记录+文件"）
- 点击 ⏹ → 停止下载
- 点击 ▶ → 恢复下载
6.3 批量操作
勾选任务前的复选框，或勾选顶部全选：
| 按钮 |
功能 |
| ✕ 取消 |
取消全选 |
| 🔄 重试 |
批量重试出错任务 |
| ⏹ 停止 |
批量停止下载中任务 |
| ▶ 启动 |
批量启动已暂停任务 |
| 🗑 删除 |
批量删除（需确认） |
6.4 任务详情弹窗
点击任务卡弹出，包含 13 个字段：
| 字段 |
说明 |
| ID |
任务唯一标识 |
| 标题 |
视频标题 |
| URL |
原始视频链接 |
| 文件名 |
保存的文件名 |
| 文件大小 |
总大小 |
| 已下载 |
已下载大小 |
| 存储位置 |
文件所在目录 |
| 状态 |
当前状态 |
| 进度 |
下载进度百分比 |
| 格式 |
视频编码 + 分辨率 + 音频格式 |
| 创建时间 |
任务添加时间 |
| 完成时间 |
下载完成时间 |
| 错误信息 |
如果出错显示错误原因 |
6.5 多流下载（视频+音频分离）
当 yt-dlp 下载视频和音频为两个独立流时：
- 任务列表显示两段子进度条：视频流 0-50%、音频流 50-100%
- 两部分都下载完成后自动合并
- 格式描述如：
1080p HEVC · mp4 + 128k mp4a · m4a
6.6 常用操作路径
| 场景 |
操作 |
| 下一个视频 |
N → 粘贴 URL → 回车（开始下载） |
| 下个视频（不同站需要登录） |
N → 粘贴 URL → 选 Cookie → 下载 |
| 只下音频 |
设置里勾"仅音频"或任务里选"仅音频"格式 |
| 批量下载播放列表 |
设置里取消勾"单视频" → 粘贴播放列表 URL |
| 清理已完成 |
工具栏 🗑 清理 → 确认 |
| 找某个任务 |
搜索栏输入 URL 或文件名片段 |
7. 键盘快捷键
| 按键 |
功能 |
N |
新建下载任务 |
S |
聚焦搜索框 |
R |
刷新任务列表 |
1 |
筛选：全部任务 |
2 |
筛选：下载中 |
3 |
筛选：已完成 |
4 |
筛选：出错 |
Esc |
关闭弹窗 / 搜索框失焦 |
? |
查看快捷键帮助 |
8. 常见问题
Q: 下载速度很慢？
尝试以下设置：
- 分片并发数：调大到 8-16（设置 → 基本）
- 同时下载任务数：调低到 1-2（任务少时单任务速度更高）
- 限速：确保没有设置限速
- 代理：如果需要用代理，在设置 → 基本填 HTTP 代理地址
Q: 下载 B 站视频需要大会员？
- 浏览器登录 B 站大会员账号
- 用 Get cookies.txt LOCALLY 扩展导出 cookies
- 应用内 🍪 Cookie → 保存 → 名称填
bilibili
- 新建任务，Cookie 认证选择
bilibili
Q: 下载后文件在哪里？
设置 → 基本 → 下载路径 中配置的目录。默认在应用数据目录下的 data/downloads/。
Q: 为什么有些视频只下了音频或低画质？
可能原因：
- 检查默认格式设置，确保不是
ba（仅音频）或 worst
- 某些视频站限制画质（如非会员限 720p）
- 任务级格式选择覆盖了全局设置
Q: 支持哪些视频站？
yt-dlp 支持 1872+ 站点，包括但不限于：
| 国内 |
国际 |
| Bilibili / 哔哩哔哩 |
** |
| 抖音 / TikTok |
Twitter / X |
| 微博 |
Twitch |
| 西瓜视频 |
Vimeo |
| 好看视频 |
Dailymotion |
| AcFun |
Facebook / Instagram |
| 腾讯视频 |
Reddit |
| 爱奇艺 |
SoundCloud |
| 优酷 |
Bandcamp |
| **云音乐 |
PBS / NPR |
Q: 如何开启下载归档？
设置 → 高级 → 下载归档，填 archive.txt。已下载的视频 ID 会被记录，下次遇到相同视频自动跳过，避免重复下载。
Q: 应用打不开/报错？
- 确认已在 fnOS 应用中心启动应用
- 在应用中心重启应用（不是刷新页面，需要重启进程）
- 检查
/vol3/@appdata/fnytdlp/info.log 查看错误日志
更多帮助: yt-dlp 官方文档
项目主页: FnDepot
2026-6-11 15:12:45
2026-6-14 07:47:28 楼主
每个视频都是解析失败，如何处理呢
添加cookie认证了 还是不行!!!
