cobalt.tools 使用指南

📖 一、平台介绍

核心定位：

开源免费无广告的网页媒体解析下载工具。基于 AGPL-3.0 协议开源（Github：imputnet/cobalt），主打隐私保护与用户体验。

• 零追踪/日志： 服务器不存储任何用户请求数据，本地优先转码。
• 无需登录： 粘贴链接一键下载公开视频、音频、图片及 GIF。
• 安全无忧： 强制加密隧道（运营商无法识别），无捆绑广告或木马弹窗。
• 多平台支持：
• 涵盖 Bilibili、YouTube、TikTok、抖音、X (Twitter)、Instagram、Reddit、SoundCloud、Vimeo、 Twitch片段等 30+ 主流媒体站点，并支持自建私有实例。

🎥 二、主要功能详解

1. 多规格媒体下载

• 视频：最高画质： 支持 8K/HDR/144fps。
• 格式选择： MP4 / WebM / MKV，分辨率可选（144p ~ 8K）。
• 编码选项： AV1、H264、VP9 等多种硬解兼容模式。
• 音频提取：单独剥离 MP3 音轨，适配短视频 BGM、播客及音乐下载。
• 图片/GIF/图集：支持推文循环视频转 GIF、TikTok 长图采集等。
• 部分站点（抖音/TikTok）提供去水印版本原图下载。

2. 隐私安全机制

• 零日志策略： 服务器端无用户历史记录，保护个人浏览痕迹。
• 加密传输： 强制使用 TLS 加密隧道，防止运营商干扰或监控下载源。
• 本地转码优先：大部分处理直接在浏览器环境完成（基于 WebAssembly），不走公共存储逻辑。

3. 高度自定义设置

• 预设方案： 快速切换画质、容器格式、音频质量开关。
• 高级控制： 长视频分段下载策略、GIF 转换开关开启/关闭等。
• 节点管理：支持多实例切换（官方主站 vs 自建私有解析节点）。

4. 配套能力与技术生态

• API 开放： 提供标准接口，可接入第三方工具或开发自定义前端页面。
• 便捷交互：全键盘快捷键操作（无需鼠标点击输入框：Ctrl+V / Shift+D）。
• 完美适配移动端浏览器，无客户端安装依赖。

5. 高阶开发者功能（技术向）

• 一键部署： Docker Compose/Dockerfile 脚本支持私有化搭建。
• 运维配置： 可自定义限流策略、时长限制规则及本地存储清洗策略。

👥 三、适用人群与场景指引

✅ 适合使用的人群

1. 普通用户：临时保存短视频缓存、下载网课资料或播客收听，不想安装臃肿客户端。
2. 自媒体创作者/剪辑师：提取无水印素材音频扒取、收集离线剪辑用公开视频片段。
3. 学生与研究者：存档公开教学课程（MOOC）、公开课资源以备复习查阅。
4. 技术爱好者：搭建私有解析节点，学习二次开发 API 接口或部署开源项目。

⚠️ 不适合使用的人群/场景

• 批量下载需求者：平台目前无自动播放列表抓取功能。
• 不支持完整合集的连续批量打包（仅支持单视频处理）。
• DRM 加密内容破解：无法解析付费会员专享、私密/仅好友可见内容及高防 DRM 流媒体。
• 专业级素材需求者：GIF 转码体积往往巨大，长视频不建议强转为 GIF。
• 超高码率无损原始素材（部分老旧播放器对 AV1/VP9 支持不佳）。

💰 四、免费与付费情况说明

📌 官方主站永久免费

• cobalt.tools 核心服务目前为 100% 永久开源免费。
• ✅ 无会员等级区分。
• ✅ 不限下载总次数/频率（受限于带宽限流策略）。
• ❌ 无任何隐藏付费墙或广告诱导。
• 资金维持： 项目依靠社区成员捐赠运行，界面内不设强制打赏入口。

💸 关于“收费”的两种情况说明

若遇到需缴费场景，请务必甄别：

• 第三方托管服务：部分服务商（非官方）自建解析实例并收取服务费。此类无统一定价页面，建议按需使用或寻找免费开源方案替代。
• 企业私有部署成本：若选择自行搭建服务器用于内部/团队使用，需自行承担云服务器硬件及带宽费用，平台本身不产生软件授权费。

🛠️ 五、极简使用步骤

1. 访问官网：在浏览器输入 https://cobalt.tools。
2. 获取链接：复制任意公开媒体的分享网页地址（支持 .mp4, .gif 等）。
3. 粘贴解析：打开输入框，按 Ctrl+V (Win) / Command+V (Mac) 或使用页面快捷键快速提交。

• ⚙️ 底部设置栏可选：仅提取音频（MP3）；
• 自定义画质与分辨率；
• 开启加密隧道模式；
• GIF 转换开关。

1. 点击下载：确认参数后点击按钮，浏览器将直接获取文件流进行下载或在线播放预览。
2. (进阶) 自建节点： 技术人员可在设置页填入自定义 API Key 或域名切换至私有实例服务。

⚠️ 六、注意事项与避坑指南

🌐 1. 网络访问提示

• 国内直连问题：海外官方主站在国内服务器加载可能缓慢，解析超时率较高。
• Bilibili / 抖音等国内站点链接相对稳定，建议优先测试此类资源。
• YouTube/TikTok 类国际内容极易出现无法解析的情况（源域名屏蔽）。
• 解决方案： 若主站不稳定且为刚需用户，建议在 Docker/虚拟机内自建私有实例节点解决网络路由问题。

📵 2. 功能硬性限制

• 仅限公开资源：私密视频、仅好友可见的动态、DRM 加密片源一律无法解析。
• 无字幕支持：平台不提供外挂字幕文件的自动下载与同步。
• 超长文件处理：极长视频可能会触发分段输出，或限制单文件大小（保护带宽），非完整打包模式。

⚖️ 3. 版权合规警告

• 个人用途原则：平台仅适用于离线学习/收藏等个人行为。
• 🛑 严禁商用二次分发。用户需自行评估内容版权归属与侵权责任。
• ❌ 禁止用于传播盗版影视作品、付费音乐或破解版权保护机制。

🔒 4. 隐私与安全

• 认准官方域名：仅信任 cobalt.tools。警惕仿站（如 cobalt-tools.com, cobalttools.online），仿建站通常存在广告追踪甚至木马风险。
• 自建实例鉴权：API 密钥、自托管节点严禁公网裸跑，务必配置反向代理及访问令牌进行鉴权保护。
• 公共限流策略：官方公共实例存在防刷机制，短时间高频批量请求会触发封禁（IP/Session），请保持适度使用频率。

📱 5. 设备与兼容性建议

• 浏览器选择：优先推荐 Chrome / Firefox 桌面端环境（长视频转码性能更强）。
• 移动端可用，但注意转码耗时较长，体验可能不如电脑流畅。
• 播放器适配：AV1/VP9 编码在部分老旧手机或电视上可能无法播放，建议在设置中切换至 H.264 (MP4) 格式以保证最大兼容性。

🐳 6. 自托管部署风险（Docker）

• 依赖环境：需提前安装配置好 Python3、yt-dlp、FFmpeg 等二进制文件，否则极易导致解析报错。
• 建议拉取官方 Docker Compose 示例进行一键初始化以减少手动排错成本。
• 带宽瓶颈：自建服务器若上行/下行带宽不足（如小 VPS），大文件下载会出现断流或速度极慢现象，请根据业务量评估硬件资源。