企业官网建设流程全解析

Cobalt：3 条命令跑起自己的免费无广告媒体下载器

【免费下载链接】cobaltbest way to save what you love项目地址: https://gitcode.com/GitHub_Trending/cob/cobalt

想存下喜欢的视频，常规做法是打开浏览器开发者工具，翻网络请求找 m3u8 或直链，多数人折腾一半就放弃了。Cobalt 把这套动作简化成一次粘贴：贴链接，它去抓取处理，直接回给你一个可下载的文件，没有广告、没有追踪、不用注册。

🚀 3 条命令跑起自己的实例

官方推荐用 Docker Compose 部署，仓库里自带示例配置，照着改就行：

git clone https://gitcode.com/GitHub_Trending/cob/cobalt cd cobalt cp docs/examples/docker-compose.example.yml docker-compose.yml # 再把 docker-compose.yml 里的 API_URL、WEB_URL 改成你自己的访问地址 docker compose up -d

跑起来后，网页界面在 9001 端口，API 服务在 9000 端口。配置里带了 watchtower，会替你把镜像更新到新版本。想调试源码的话，克隆仓库后npm run setup再npm start，需要 Node 18 以上。

🎬 这三个核心能力最值得看

贴个链接，直接拿文件

场景：刷到一条 TikTok 或 YouTube 教程，想存下来当素材。操作：打开网页界面，粘贴链接，选保存模式——视频、纯音频都行。效果：后台抓取并处理完，返回直连文件地址，全程没有广告弹窗和追踪请求。

平台覆盖 20 来个主流站点，体验各有侧重：YouTube 可以要 8K、4K、HDR、VR 和高帧率，还能在 h264/av1/vp9 编码间切换；TikTok 返回无水印视频和完整原始音频；Instagram 的 Reels 和多媒体帖子能挑具体哪一项保存。

画质、格式、文件名都能挑

想要 4K 就传vQuality，音频在best / mp3 / ogg / wav / opus里选aFormat。文件名也不是随便起的：filenamePattern提供 classic/pretty/basic/nerdy 四种命名风格，生成逻辑在文件名生成器里，可以预判命名结果。

用开放 API 接进自己的工具

场景：想批量处理一串链接，或者把 Cobalt 嵌进自己的脚本。操作：对/api/json发一次 POST。效果：返回带流地址的 JSON，脚本里直接取用。

curl -X POST http://localhost:9000/api/json \ -H "Content-Type: application/json" -H "Accept: application/json" \ -d '{"url":"https://www.youtube.com/watch?v=xxx","vQuality":"max"}'

请求参数和返回字段的完整说明在 API 文档里，复制即用。

📊 支持哪些平台和模式

✅ 支持，❌ 不支持，➖ 不适用。完整平台列表在 README 表格里，还在持续扩充。

🔧 想改什么，就去改哪个文件

1. 端口与限流：API_PORT（默认 9000）、RATELIMIT_WINDOW/RATELIMIT_MAX（默认 60 秒 20 次），全部走环境变量，见部署文档。
2. 外发请求走代理：把API_EXTERNAL_PROXY指到你的代理地址，所有对外抓取都会经过它。
3. 需要登录的内容：在配置旁放一份 cookies.json，用COOKIE_PATH指过去，cookie 模块负责注入。
4. 长视频上限：DURATION_LIMIT默认 10800 秒，按机器性能自己放宽。
5. 新增平台支持：在服务配置里加 URL 模式，到服务目录写抓取逻辑，模式匹配负责链接路由。

⚠️ 高频踩坑与失败排查

端口被占了怎么办

9000 或 9001 冲突时，改API_PORT/WEB_PORT环境变量，compose 文件里的宿主机端口映射跟着一起改。

页面能打开但下载报 URL 相关错误

十有八九是API_URL和WEB_URL没从示例值改掉——它们必须和你实际访问实例的地址一致，这是排名第一的翻车原因。

需要登录的内容为什么下不动

服务端没有登录态，得给对应平台准备好 cookies.json 并挂进容器，否则会直接提示无权限。

返回 rate-limit 状态

默认 60 秒内最多 20 次请求，超了会被拦到窗口结束。流量大就把RATELIMIT_WINDOW和RATELIMIT_MAX调大。

Ubuntu 22.04 上 ffmpeg 报错

先装好nscd并启动，否则 ffmpeg-static 的二进制无法解析 DNS，部署文档里有现成命令。

📮 跑起来之后去哪找资料

Cobalt 是 AGPL-3.0 开源项目，活跃维护中，只抓取公开免费的内容，下载时请尊重原作者版权。参数全集查部署文档和 API 文档，社区讨论可以走项目主页关联的 Discord 服务器。

【免费下载链接】cobaltbest way to save what you love项目地址: https://gitcode.com/GitHub_Trending/cob/cobalt