Cobalt完整指南如何用Docker快速跑起一个无广告的开源视频下载器【免费下载链接】cobaltbest way to save what you love项目地址: https://gitcode.com/GitHub_Trending/cob/cobaltCobalt 是一个开源的免费视频下载器粘贴链接拿到文件中间没有广告、没有追踪、没有付费墙。想把 YouTube、TikTok、Bilibili 等平台的视频存到本地磁盘的人都适合用它。这篇教程讲清楚它是什么、支持哪些平台如何用 Docker 五分钟部署自己的实例以及几个真正用得上的配置技巧和排障方法。它是什么一个不让你烦的开源下载器市面上的下载站你多半见过弹广告、要会员、还偷偷收集你的浏览数据。Cobalt 的思路反过来——它不关心你是谁你贴什么链接它就处理什么链接处理完直接返回文件地址。它的几个核心卖点实际用起来感受很明显无广告、无追踪代码开源AGPL-3.0 协议行为透明不会把你导流到别的页面操作极简粘贴链接、选下载模式、点下载三步完成可自托管官方推荐你部署自己的实例数据和处理逻辑都在自己手里完全免费代码免费自托管后也没有任何用量门槛支持哪些平台从YouTube到B站Cobalt 目前支持 20 个主流平台官方明确说这个列表还在持续扩充。几个重点平台的下载能力如下平台可选下载方式能拿到的内容YouTube含Shorts和音乐视频音频 / 仅音频 / 仅视频144p 到 8K、HDR、VRh264/AV1/VP9 三种编码多语种配音TikTok视频音频 / 仅音频无水印视频、完整原始音频、图文帖图片Twitter/X视频音频 / 仅音频多媒体帖子可自选要保存哪一条哔哩哔哩视频音频 / 仅音频 / 仅视频常规视频简单直接InstagramReels和帖子视频音频 / 仅音频 / 仅视频多媒体帖子可在视频、Reels、照片之间选择SoundCloud仅音频音轨且支持私有链接Reddit视频音频 / 仅音频GIF 与视频Vimeo视频音频 / 仅音频 / 仅视频高质量视频保留丰富元数据其余 12 个平台Dailymotion、Facebook、Pinterest、Snapchat、Twitch 片段、VK、Rutube、Loom、Ok、Streamable、Tumblr、Vine的支持细节可以直接查项目 README 里的完整对照表。Docker三步跑起来5分钟部署自己的实例官方文档明确建议除非是本地开发调试否则一律用 Docker Compose 部署。实际跑过之后这条路确实最省心——容器自带 ffmpeg不用在宿主机装任何额外依赖。# 1. 建一个配置目录 mkdir cobalt cd cobalt # 2. 新建 docker-compose.yml从项目自带的示例配置复制内容 # 把里面的 API_URL / WEB_URL 换成你自己的访问域名 nano docker-compose.yml # 3. 启动 docker compose up -d示例配置里有两个必须改的地方API_URL和WEB_URL。它们决定客户端访问实例的地址不改对的话服务起不来。改完之后API 默认跑在9000端口网页前端跑在9001端口。两个建议提前知道示例配置自带 watchtower 容器Cobalt 镜像会自动更新不用手动拉新镜像如果实例要暴露到公网强烈建议前面加一层 nginx 之类的反向代理再顺手把端口绑定到127.0.0.1完整的 compose 示例文件见 docker-compose 示例配置里面每个环境变量都有注释。手动安装Node.js适合本地开发如果你要改代码或调试用普通 Node.js 跑更合适。要求 Node.js 18 以上当前版本 7.15package.json里写死了18git clone https://gitcode.com/GitHub_Trending/cob/cobalt cd cobalt npm run setup # 交互式选择你要跑 API 还是 WEB然后自动装依赖 npm start一个小坑在 Ubuntu 22.04 上跑ffmpeg 的静态二进制会解析不了 DNS官方给的办法是先sudo apt install nscd sudo service nscd start文档里有说明。跑起来之后值得配置的三件事部署完成只是起点下面三个配置能让实例从能用变成好用。所有变量的完整列表见 环境变量文档。开启速率限制防止实例被滥用默认配置是60 秒内最多 20 次请求RATELIMIT_WINDOW60、RATELIMIT_MAX20超出后请求会被拦截一个窗口周期。如果你把实例分享给别人用建议把上限调低、窗口调长如果只是自己用默认值通常不用动。另外有个默认时长限制DURATION_LIMIT默认 10800 秒3 小时超过这个长度的视频会被直接拒绝。想存长视频的话记得调大它。用 Cookie 下载需要登录的内容有些平台的公开内容在抓取侧也要求登录态比如部分 B 站或 VK 的链接。Cobalt 的做法很直接在 compose 同目录放一个cookies.json然后给 API 容器加上COOKIE_PATH: /cookies.json并把文件挂进容器。格式参考项目里的 cookies 示例文件。自定义下载文件的命名规则批量存文件之后文件名就是生产力。Cobalt 内置了 4 种命名模式classic如youtube_MMK3L4W70g4_1920x1080_h264_mute.mp4、pretty带标题、作者、分辨率、平台的完整标题式命名、basic和nerdy全量信息堆在括号里。生成逻辑不长就在 文件名生成模块想改规则直接看它就行。适合谁用三个真实场景个人备份党。刷到好教程、好 BGM不想哪天它就没了——贴个链接存下来配合pretty命名模式文件名自带标题和平台往硬盘一扔就是结构化归档。内容创作者。收集转场参考、色彩参考、无水印的 TikTok 视频素材。Cobalt 对多媒体帖子的处理是让你选要存哪一条而不是全给你一锅端这在整理素材时省很多事。开发者。Cobalt 的 API 是开放且免费的个人项目可直接用官方实例核心就是POST /api/json一个端点请求和响应都是 JSON十几行脚本就能把批量下载自动化curl -X POST http://localhost:9000/api/json \ -H Accept: application/json \ -H Content-Type: application/json \ -d {url: https://www.youtube.com/watch?vXXXX, isAudioOnly: true}接口的全部参数编码选择、画质、文件名模式、静音等和返回结构见 API 文档。注意官方的一条红线免费 API 不能用于商业场景付费墙或广告后面的产品商用请自托管。出问题怎么办常见排障提示 429 / rate-limit触发速率限制了。稍等一个窗口周期或调整自己实例的RATELIMIT_WINDOW/RATELIMIT_MAX旧版 Firefox 粘贴按钮失灵Firefox 125 起默认支持剪贴板读取旧版本需要去about:config打开dom.events.asyncClipboard.readText步骤见 官方排障指南实例访问地址打不开九成是API_URL/WEB_URL没改成自己的域名或结尾漏了/改完重启容器Ubuntu 22.04 手动安装报 ffmpeg/DNS 错误安装并启动nscd见上文实例面向公网加反向代理别把 9000/9001 裸奔在公网上还有一个进阶选项可以顺手了解Linux 上配置FREEBIND_CIDR后Cobalt 会给每次下载随机分配一个 IPv6 出口地址适合需要分散出口 IP 的托管场景官方文档里有完整说明。下一步跑起来回顾一下最短路径建目录 → 放一份改过 URL 的 compose 配置 →docker compose up -d→ 打开 9001 端口贴链接。整个过程不到五分钟之后镜像会自动更新你只需要偶尔看看日志。部署自己的实例把下载权握在自己手里——把繁琐留给工具把时间留给创作。【免费下载链接】cobaltbest way to save what you love项目地址: https://gitcode.com/GitHub_Trending/cob/cobalt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考