galaxy-downloader

通用媒体下载器

这是一个基于 vinext 运行的 Next.js App Router 兼容项目，支持从 Bilibili、抖音、Instagram、小红书、TikTok、X、Telegram、Threads、微信公众号、微博、Niconico、Vimeo、Dailymotion、Streamable、Reddit、Newgrounds、Tumblr、Pinterest、VK、OK.ru、Twitch、SoundCloud 等平台下载媒体内容。

功能特点

• 支持 Bilibili 视频/音频下载
• 支持抖音无水印视频下载及音频提取
• 支持 Instagram Reels、帖子和图文内容下载
• 支持小红书视频笔记和图文笔记下载
• ️ 支持 TikTok 视频下载
• 支持 X 视频下载
• 支持 Vimeo、Dailymotion、Streamable、Reddit、Newgrounds、Tumblr、Pinterest、VK、OK.ru、Twitch、SoundCloud 等平台内容解析与下载
• 自动识别平台链接
• 现代化的用户界面设计
• 本地下载历史记录
• 多语言支持（简体中文、繁体中文、英文、日文）

开始使用

首先，运行开发服务器：

pnpm dev

在浏览器中打开 http://localhost:3010 即可看到应用界面。

使用方法

1. 复制媒体链接（支持首页展示的平台）
2. 粘贴到输入框中
3. 点击解析按钮
4. 选择下载视频、音频或图片
5. 等待下载完成，文件会自动保存

支持的链接格式

• Bilibili: https://www.bilibili.com/video/BV... 或 https://b23.tv/...
• 抖音: https://www.douyin.com/... 或 https://v.douyin.com/...
• Instagram: https://www.instagram.com/reel/... 或 https://www.instagram.com/p/...
• 小红书: https://www.xiaohongshu.com/explore/... 或 https://xhslink.com/...
• TikTok: https://www.tiktok.com/@.../video/...
• X: https://x.com/.../status/...
• Pinterest: https://www.pinterest.com/pin/70437485604603/
• VK: https://vk.com/video-1_456239018
• OK.ru: https://ok.ru/video/14627121662690
• Twitch: https://m.twitch.tv/ninja/clip/SuaveNeighborlySrirachaHeyGirl-1J8kzeLFWxdUBZ4C
• SoundCloud: https://soundcloud.com/forss/flickermood

技术栈

• vinext
• Next.js 16 App Router API 兼容层
• React 19
• Vite 8
• TypeScript
• Tailwind CSS
• shadcn/ui
• Fetch API（前端网络请求）
• FFmpeg.wasm (浏览器端音频提取)
• JSZip (图片打包下载)

当前平台支持

• Bilibili: 视频、音频、分享口令
• Bilibili TV: 仅音频
• 抖音: 视频、图文、分享口令
• Instagram: Reels、帖子、图文
• 小红书: 视频、图文
• TikTok: 视频
• X: 视频
• Telegram: 视频
• Threads: 视频、图文
• 微信公众号: 文章视频、多视频
• 微博: 视频、图文、多视频
• Niconico: 视频
• Vimeo: 内容下载
• Dailymotion: 内容下载
• Streamable: 内容下载
• Reddit: 内容下载
• • Newgrounds: 内容下载
• Tumblr: 内容下载
• Pinterest: 内容下载
• VK: 内容下载
• OK.ru: 内容下载
• Twitch: 内容下载
• SoundCloud: 内容下载

说明：

• 音频提取目前以浏览器端处理为主，受浏览器性能和文件大小影响
• 图文内容支持按平台返回结果分别下载或打包下载

本地开发

1. 克隆项目
2. 安装依赖：
   bash复制

   pnpm install

3. 运行开发服务器：
   bash复制

   pnpm dev

4. 生产构建：
   bash复制

   pnpm build

5. 启动构建产物：
   bash复制

   pnpm start

SEO 配置

部署时建议配置以下环境变量，确保公开 API、canonical 和索引策略都正确：

• NEXT_PUBLIC_API_BASE_URL: 公开下载 API 地址，例如 https://downloader-api.bhwa233.com。前端会直接请求这个地址；本地开发未配置时默认使用 http://localhost:8788
• NEXT_PUBLIC_SITE_URL: 当前环境站点地址（例如 https://downloader.bhwa233.com）
• SEO_INDEXABLE: 是否允许索引，true / false

如果本地开发未配置 NEXT_PUBLIC_SITE_URL，应用会默认使用 http://localhost:3010 作为站点基址，避免 manifest、canonical 和 Open Graph 链接错误地指向生产域名。

如果生产或预发环境需要接入非默认公开 API，请显式配置 NEXT_PUBLIC_API_BASE_URL，避免客户端请求落到错误的域名。

默认策略：

• 在 Vercel 生产环境自动允许索引
• 在 Vercel 预览环境默认不允许索引
• 非 Vercel 环境按 NODE_ENV === production 判断是否允许索引
• 可通过 SEO_INDEXABLE 显式覆盖

SEO 监控建议

建议每周检查以下指标，持续验证本仓库内的 SEO 配置是否生效：

1. Search Console 的 索引页面 与 未编入索引原因
2. sitemap.xml 提交状态与抓取成功率
3. Core Web Vitals（LCP、INP、CLS）趋势
4. 重点页面（首页、FAQ、Guides）的展示量与点击量
5. 多语言页面的 hreflang 与 canonical 是否一致

部署

默认使用 vinext 生成 dist/ 构建产物。部署前请先执行：

pnpm build

Cloudflare Workers 部署请使用：

pnpm deploy

部署脚本会只针对 Cloudflare API 的 971 限流错误自动退避重试（默认间隔为 60、120、180 秒）。其他错误会立即失败，避免掩盖配置或构建问题。可通过 CF_DEPLOY_MAX_ATTEMPTS 和 CF_DEPLOY_RETRY_DELAY_MS 调整重试次数和基础等待时间。

如果平台已经先执行过 pnpm build，部署命令请改为：

pnpm deploy:ci

预览部署可使用：

pnpm deploy:preview

不要直接使用 wrangler deploy 作为部署命令。当前项目基于 vinext，应由 vinext deploy 负责生成所需配置、构建并调用 Wrangler。