Cookie 配置指南

本指南将帮助你配置浏览器 Cookie，以便下载需要登录才能访问的视频。

为什么需要配置 Cookie？

在使用 VideoCaptioner 下载视频时，你可能会遇到以下错误：

这通常是因为：

1. 某些视频平台（如 B 站、YouTube）需要用户登录才能获取高质量视频
2. 网络条件较差时，部分网站需要验证用户身份才能下载
3. 地区限制的内容需要特定账号权限

何时需要配置

只有当你看到上述错误提示时才需要配置 Cookie。大多数情况下，VideoCaptioner 可以直接下载视频。

---

配置步骤

1. 安装浏览器扩展

根据你使用的浏览器选择对应的扩展：

浏览器	扩展名称	下载链接
Chrome	Get CookieTxt Locally	Chrome 应用店
Edge	Export Cookies File	Edge 插件商店
Firefox	cookies.txt	Firefox 附加组件

其他浏览器

如果你使用其他浏览器（如 Safari、Opera），可以搜索类似的 "Export Cookies" 扩展。

2. 导出 Cookie 文件

安装扩展后，按以下步骤操作：

步骤一：登录目标网站

打开需要下载视频的网站（如 B 站、YouTube），确保你已登录账号。

步骤二：导出 Cookie

1. 在该网站页面点击浏览器扩展图标
2. 选择 "Export Cookies" 或类似选项
3. 扩展会自动下载一个 cookies.txt 文件

注意事项

• 确保在目标网站的页面上导出 Cookie（不是在其他网站）
• 某些扩展可能默认导出为 cookies.json，请重命名为 cookies.txt

3. 放置 Cookie 文件

将导出的 cookies.txt 文件移动到 VideoCaptioner 的 AppData 目录下。

AppData 目录位置

VideoCaptioner 的 AppData 目录通常位于：

VideoCaptioner/
├─ app/
├─ resource/
├─ AppData/          # Cookie 文件放这里
│  ├─ cache/
│  ├─ logs/
│  ├─ models/
│  ├─ cookies.txt    # ← 将文件放在这里
│  └─ settings.json
└─ work-dir/

快速定位

在 VideoCaptioner 中点击 设置 → 打开日志文件夹，然后返回上一级目录即可看到 AppData 文件夹。

4. 验证配置

配置完成后：

1. 重启 VideoCaptioner
2. 再次尝试下载视频
3. 如果仍然失败，请检查 Cookie 文件是否正确放置

---

常见问题

Cookie 文件格式不正确

问题：提示 "Cookie 文件格式错误"

解决方法：

• 确保文件名为 cookies.txt（不是 cookies.json 或其他）
• 使用文本编辑器打开文件，检查是否为 Netscape Cookie 格式
• 重新导出 Cookie，确保选择正确的格式

下载仍然失败

问题：配置 Cookie 后仍然无法下载

可能原因：

1. Cookie 已过期 - 重新登录网站并导出新的 Cookie
2. 账号权限不足 - 确认你的账号能否在浏览器中正常观看该视频
3. 地区限制 - 视频可能仅限特定地区访问

需要为每个网站单独配置吗？

答案：不需要。

• 一个 cookies.txt 文件可以包含多个网站的 Cookie
• 浏览器扩展通常会导出所有已登录网站的 Cookie
• 建议在常用的视频网站（B 站、YouTube 等）都登录后再导出

Cookie 安全吗？

安全建议：

• Cookie 文件包含你的登录信息，不要分享给他人
• 定期更新 Cookie（每月导出一次）
• 如果担心安全，可以使用小号登录并导出 Cookie

支持哪些视频网站？

VideoCaptioner 使用 yt-dlp 作为下载引擎，支持 1000+ 个视频网站，包括：

• 🎬 YouTube、Bilibili、抖音、快手
• 📺 爱奇艺、腾讯视频、优酷
• 🎓 Coursera、Udemy、Khan Academy
• 🐦 Twitter、Facebook、Instagram
• ...以及更多

完整列表请查看 yt-dlp 支持列表

---

下一步

配置完成后，你可以：

• 查看 快速开始指南 下载并处理视频
• 了解 批量处理功能 处理多个视频
• 探索 视频下载技巧