Cobalt十分钟用 Docker 自建视频下载站的完整指南【免费下载链接】cobaltbest way to save what you love项目地址: https://gitcode.com/GitHub_Trending/cob/cobaltCobalt 是一个开源、可自建的媒体下载器视频下载工具没有广告和跟踪代码。它帮经常需要保存 YouTube、TikTok 等平台视频和音频的人以及想给团队搭一个下载站的人省掉手动抓链接的麻烦。本文带你把它跑起来讲清核心用法、API 脚本化和常见报错处理。最短路径跑起来前提机器上装好 Docker 与 docker compose或者 Node.js 18 及以上版本仓库package.json声明node 18。官方推荐 Docker 方式下面按它走。克隆仓库获取示例配置仓库自带完整的 compose 样例git clone https://gitcode.com/GitHub_Trending/cob/cobalt克隆仓库样例文件在 docs/examples 目录下。建一个部署目录把 docs/examples/docker-compose.example.yml 的内容复制进去作为docker-compose.yml并把其中API_URL、WEB_URL改成你自己的地址。启动容器docker compose up -d后台启动 cobalt-api端口 9000和 cobalt-web端口 9001两个容器。如何判断成功浏览器打开http://localhost:9001/能出 cobalt 网页界面说明前端正常访问http://localhost:9000/api/serverInfo返回包含version字段的 JSON当前仓库版本为 7.15说明 API 正常。不走 Docker 也可以流程是git clone https://gitcode.com/GitHub_Trending/cob/cobalt cd cobalt npm run setup npm start依次是克隆仓库、进入目录、运行交互式配置脚本让你选 api 或 web 角色、填域名和端口并自动生成 .env 文件、自动安装依赖、启动服务。它能干什么一条链接保存 19 个平台的公开内容。README 的支持列表覆盖 YouTube、TikTok、Instagram、Twitter/X、Vimeo、Bilibili 等 19 个服务。比如把一条 TikTok 灵感视频存下来它支持无水印视频、幻灯片图片无水印还能取完整原始音频Reddit 的 GIF 和视频也能直接保存。服务视频音频仅音频仅视频youtube✅✅✅tiktok✅✅✅instagram✅✅✅twitter/x✅✅✅soundcloud➖✅➖摘自 README 支持列表完整 19 项见该文件。只抽音频。请求里带上isAudioOnly: true配合aFormat选 mp3、ogg、wav、opus 任一格式。想从 YouTube 音乐视频里留一份音频底稿这是最直接的办法仓库配置里音频输出固定 320k 码率。YouTube 的清晰度与编码精细控制。vQuality从 144 到 2160 可选vCodec支持 h264、av1、vp9README 注明支持 8K、4K、HDR、VR 和高帧率视频。自己存的 4K 素材可以按目标设备的兼容性指定编码而不是拿到一个默认的封装。文件名和元数据可选风格。filenamePattern提供 classic、pretty、basic、nerdy 四种命名方式下载的文件可携带标题、作者等元数据disableMetadata可关掉。素材库按标题命名比一串随机 ID 好整理得多。多媒体的帖子可以挑选。Instagram 和 Twitter/X 的多媒体帖子返回一个 picker选择器响应里带缩略图让你从同一个帖子里只保存想要的那几张图或那一段视频。进阶用法用脚本批量调用 API操作步骤对/api/json发 POST 请求请求体里必须有url字段curl -s -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}让 cobalt 处理一条链接并返回处理结果。预期结果响应 JSON 中status为redirecturl字段是文件直链可直接用它落盘适合写循环脚本处理一整份链接清单。注意点两个Accept/Content-Type请求头一个都不能少默认限速是 60 秒内 20 次请求超了会收到rate-limit状态。用 cookies.json 解锁需要登录才能看的服务操作步骤在docker-compose.yml同目录建一个cookies.json格式照 docs/examples/cookies.example.json 填支持 instagram、twitter、reddit 等键然后在 compose 文件里取消COOKIE_PATH和对应 volume 挂载的注释重启容器。预期结果之前因登录墙取不到的公开内容如某些 Instagram 帖子可以正常解析下载。注意点项目明确声明只能下载免费、公开可访问的内容cookie 只是替实例过身份验证你对自己下载和分发的内容负责。调整环境变量匹配你的负载操作步骤在 compose 文件的environment段修改几个变量RATELIMIT_WINDOW限速窗口秒数默认 60、RATELIMIT_MAX窗口内最大请求数默认 20、DURATION_LIMIT允许的视频最大时长秒数默认 10800。预期结果限速和时长门槛贴合你的使用规模长视频或高频调用不再被拦。注意点完整变量表包括必填的API_URL、WEB_URL在 docs/run-an-instance.md实例要面向公网时官方建议加 nginx 这类反向代理。常见坑与排错启动后终端报 cobalt wasnt configured yet or configuration is invalid。说明.env不存在或配置无效。重新执行npm run setup按提示回答即可脚本会重建.env并装好依赖。Ubuntu 22.04 上跑 ffmpeg 相关下载失败DNS 解析不了。ffmpeg-static的二进制在这套系统上依赖 nscd 解析域名装好并启动它就能解决sudo apt install nscd sudo service nscd start安装并启动 nscd修复 ffmpeg 的动态库 DNS 解析问题。网页里点粘贴没反应旧版 Firefox。Firefox 125 起原生支持剪贴板粘贴旧版本要手动开地址栏进about:config搜dom.events.asyncClipboard.readText把 false 改成 true刷新页面即可。图文步骤见 docs/troubleshooting.md。调/api/json一直报格式错误。九成是漏了请求头或请求体。POST 必须带Accept: application/json和Content-Type: application/json两个头且请求体必须有url字段详见 docs/api.md。网页能打开但点下载就失败。通常是 web 容器的API_URL指错了地址。核对 compose 配置web 容器的API_URL要指向 api 服务的地址WEB_URL是 web 自己的地址两者都要带结尾的/。去哪找帮助部署与环境变量全集docs/run-an-instance.mdAPI 字段说明docs/api.md自排障指南进行中持续补充docs/troubleshooting.md想加新平台支持或提交功能先看 CONTRIBUTING.md 里的规范拿不准的改动建议先开 issue 讨论。Cobalt 的代码以 AGPL-3.0 许可发布媒体文件的转码和合并由 ffmpeg 完成。它只处理免费公开可访问的内容使用他人素材时记得保留原始创作者署名。【免费下载链接】cobaltbest way to save what you love项目地址: https://gitcode.com/GitHub_Trending/cob/cobalt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考