告别流氓软件！GitHub 30k+ Star 神器 Cobalt：全网视频下载的终极“洁癖”方案

📁 开源项目

告别流氓软件！GitHub 30k+ Star 神器 Cobalt：全网视频下载的终极“洁癖”方案

摘要：在这个“下载器”=“广告弹窗+隐私窃取”的时代，Cobalt 以其“零广告、零追踪、极致纯净”的架构设计，成为流媒体下载界的一股清流。本文将从架构视角深度剖析 Cobalt，并手把手教你如何用 Docker 私有化部署这套神级工具。

一、 问题分析：为什么传统下载器令人绝望？

作为技术人，我们经常需要保存一些优质的技术视频或素材。但目前的下载工具市场现状令人堪忧：

  1. 广告泛滥：点击“下载”按钮前，你得先关掉3个弹窗，甚至误触下载了流氓软件。
  2. 隐私裸奔：大多数在线转换网站都在后台疯狂收集你的访问记录和设备指纹。
  3. 性能阉割：4K/8K 视频强制压缩，音频比特率惨不忍睹，只为了节省服务器带宽。
  4. 维护困难：平台算法一更新，工具就失效，且由于闭源，无法自行修复。

我们需要的是一个：纯粹、强大、可控的解决方案。

二、 方案设计：Cobalt 的架构之美

Cobalt (官网: cobalt.tools) 不仅仅是一个下载工具，它是一套优雅的媒体处理服务。

1. 核心架构：分离与解耦

Cobalt 采用了经典的 Client-Server 架构：

  • API Service (后端)：负责核心的媒体解析、流处理和格式转换。它并不直接存储庞大的文件，而是像一个高效的“管道”，实时处理数据流。这种设计极大地降低了存储成本，提高了响应速度。
  • Web Client (前端)：基于 Svelte 构建的现代化 UI，极致轻量，无任何多余的追踪脚本。

2. 隐私优先设计 (Privacy First)

这是 Cobalt 最打动我的地方。它的 Docker 镜像在设计时就遵循 No-Log 原则。

  • 无 Cookie 依赖：不需要你登录任何账号。
  • 无追踪器：代码中移除了通过 API 对接 Google Analytics 等统计服务的逻辑。
  • IP 保护：作为中间层，它向目标网站（如 YouTube）发起请求，保护了客户端的真实 IP 不被直接暴露给流媒体平台。

3. 功能矩阵

  • 广度覆盖：支持 YouTube, Bilibili, TikTok, Twitter (X), Reddit, Instagram 等 30+ 主流平台。
  • 深度处理：
    • 极致画质：支持最高 8K (4320p) 视频下载。
    • 音频发烧：支持 FLAC, ALAC 等无损格式，以及高达 320kbps 的 MP3。
    • 容器灵活：MP4, MKV, WEBM 随意切换。
    • 智能组件：自动提取并混流字幕，支持 H.264/AV1 编码选择。

三、 代码实现：一键 Docker 私有化部署

虽然 Cobalt 提供了官网直接使用，但作为技术专家，私有化部署才是王道。可以避免高峰期排队，且完全掌控数据流向。

1. 环境准备

确保你的服务器已安装 Docker 和 Docker Compose。

2. Docker Compose 配置

创建一个 docker-compose.yml 文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
version: '3.8'

services:
  cobalt:
    image: ghcr.io/imputnet/cobalt:latest
    container_name: cobalt
    restart: unless-stopped
    ports:
      - "9000:9000"  # 将容器的9000端口映射到主机的9000端口
    environment:
      # API URL，如果你配置了反向代理和域名，这里填你的域名
      # 例如: https://cobalt.yourdomain.com
      # 本地测试可留空或填 http://localhost:9000
      API_URL: "http://localhost:9000"
      
      # 限制请求频率，防止滥用 (可选)
      # RATELIMIT_IP: 100
      
      # 语言设置
      LANGUAGE: "zh"

3. 启动服务

1
2
3
4
5
# 在目录下运行
docker-compose up -d

# 查看日志确保启动成功
docker-compose logs -f

4. 验证与使用

访问 http://服务器IP:9000，你将看到那个标志性的、极简的紫色界面。
输入一个 Bilibili 或 YouTube 链接，点击 >> 箭头，享受秒级解析的快感。

⚠️ 注意事项：
如果你在国内服务器部署，可能会因为网络原因无法访问 YouTube 等外网资源。建议部署在能够流畅访问国际互联网的 VPS 上。

四、 进阶配置：Nginx 反向代理

为了通过域名安全访问，建议配置 Nginx 反向代理并开启 SSL。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
server {
    listen 80;
    server_name cobalt.yourdomain.com;
    
    # 强制跳转 HTTPS
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name cobalt.yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:9000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

五、 总结

Cobalt 是开源精神的杰出代表：它不试图通过广告变现，而是试图通过技术解决问题。

对于个人用户，它是下载视频的神器；对于开发者，它是学习 Svelte 前端和现代化 API 设计的优秀范本。

项目地址: https://github.com/imputnet/cobalt

本文同步发布于“太阳鸟的AI宝藏库”，关注获取更多硬核开源与AI干货。

🏷️ GitHub 开源神器 Cobalt 媒体下载 Docker 隐私保护