🧭 核心功能与特点

MediaGo 定位为简单易用的视频下载器,其核心优势包括:

  • 内置嗅探:无需抓包或复杂的命令行配置,打开页面即可自动检测视频资源。
  • 浏览器扩展:配套的 Chrome/Edge 扩展可一键将当前页面视频发送至 MediaGo 下载。
  • 广泛支持:基于 yt-dlp,支持 YouTube、Twitter、Instagram、Reddit 等主流平台。
  • AI 助手集成:可为 Claude Code、Cursor 等 AI 编码助手安装 Skill,通过自然语言指令(如“请下载这个视频:”)触发下载。
  • HTTP API:提供完整的 HTTP API,方便脚本、自动化工具或第三方应用集成。
  • 内置格式转换:下载完成后,可直接在应用内转换视频格式或质量。
  • 跨平台:提供 Windows、macOS、Linux 桌面客户端及 Docker 镜像。

📦 部署与安装方式

方式一:桌面客户端(推荐普通用户)

从项目的 GitHub Releases 页面 或官网下载对应系统的安装包:

  • Windows.exe 安装包或便携版。
  • macOS:Apple Silicon (arm64) 或 Intel (x64) 的 .dmg 文件。
  • Linux.deb 包。
    下载后,像安装普通软件一样完成安装即可。

方式二:Docker 部署(适合服务器或远程访问)

适用于在服务器上部署无界面版本,并通过局域网 Web UI 访问。

1
2
3
4
docker run -d --name mediago \
-p 8899:8899 \
-v /path/to/mediago:/app/mediago \
caorushizi/mediago:3.5.0
  • 参数说明
    • -p 8899:8899:将容器的 8899 端口映射到宿主机。
    • -v /path/to/mediago:/app/mediago:挂载本地目录以持久化下载的文件和配置。
  • 访问:浏览器打开 http://你的服务器IP:8899 即可使用 Web 界面。

方式三:集成到 AI 助手(使用 Skill)

如果你是 Claude Code、Cursor 等 AI 编程助手的用户,可以安装 MediaGo Skill,让 AI 帮你下载视频。

1
npx clawhub@latest install mediago

安装后,你只需在聊天中告诉 AI:“请下载这个视频: [视频链接]”,AI 就会自动调用 MediaGo 进行下载。

🚀 使用指南

  1. 主界面:启动 MediaGo 后,主界面会显示一个类似浏览器的地址栏。
  2. 粘贴链接下载:将视频页面的 URL 粘贴到地址栏,按回车。应用会自动分析页面,检测并列出可下载的视频资源。
  3. 选择资源并下载:从检测到的资源列表中选择需要的视频格式、清晰度,点击下载按钮。
  4. 管理下载任务:你可以在任务列表中查看下载进度、暂停/继续或取消任务。
  5. 格式转换:下载完成后,可在已完成任务中点击“转换”按钮,选择新的格式或质量进行转换。
  6. 浏览器扩展:安装扩展后,在浏览视频页面时点击扩展图标,可一键将视频发送至 MediaGo 开始下载。

⚙️ 高级配置与集成

  • HTTP API:MediaGo 运行时会启动一个本地 API 服务(默认端口 8899),你可以通过 HTTP 请求创建下载任务、查询进度和管理列表。这为脚本和自动化工具提供了集成能力。
  • Docker 端口与访问:桌面版默认同时监听 127.0.0.1 和局域网 IP,因此同一 Wi-Fi 下的手机或平板也可以访问其 Web 界面(使用电脑的局域网 IP 和端口 8899)。
  • 开发环境:如需从源码构建,需要 Go、Node.js 环境,并使用 Task 作为构建工具。克隆仓库后,依次运行 task setuptask dev:all 启动开发服务器。

❓ 常见问题与注意事项

  • 法律与免责声明:项目明确声明仅限教育和研究目的禁止用于商业或非法用途。用户需遵守所在地区法律,下载内容版权归原作者所有,应在 24 小时内删除或获得授权。
  • 平台兼容性:支持的网站列表基于 yt-dlp,其兼容性会持续更新。如果某个网站无法下载,可能需要更新 yt-dlp 或使用内置的浏览器扩展进行嗅探。
  • Docker 存储:务必挂载一个宿主机目录到容器的 /app/mediago,否则容器删除后下载的文件会丢失。
  • 无法嗅探到视频:部分网站可能需要登录或使用了特殊的加密播放器。可以尝试使用浏览器扩展,或在应用内开启“调试模式”查看详细日志。

总结

MediaGo 是一款功能丰富且易于使用的视频下载工具,其核心优势在于内置嗅探、浏览器扩展和广泛的平台支持。对于普通用户,直接从官网下载桌面客户端是最简便的方式,配合浏览器扩展使用能获得最佳体验。对于需要远程访问或服务端集成的用户,Docker 部署提供了灵活的选择。同时,其 AI 助手 SkillHTTP API 为技术用户提供了强大的扩展能力。使用时请务必遵守其免责声明,仅用于合法目的。