通用媒体下载器

这是一个基于 vinext 运行的 Next.js App Router 兼容项目，支持从 Bilibili、抖音、Instagram、小红书、TikTok、X 等平台下载视频、音频和图文内容。

功能特点

• 🎵 支持 Bilibili 视频/音频下载
• 🎬 支持抖音无水印视频下载及音频提取
• 📱 支持 Instagram Reels、帖子和图文内容下载
• 📷 支持小红书视频笔记和图文笔记下载
• 🎞️ 支持 TikTok 视频下载
• 🐦 支持 X 视频下载及音频提取
• 🔍 自动识别平台链接
• 🎨 现代化的用户界面设计
• 💾 本地下载历史记录
• 🌍 多语言支持（简体中文、繁体中文、英文、日文）

开始使用

首先，运行开发服务器：

pnpm dev

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

使用方法

1. 复制媒体链接（支持 Bilibili、抖音、Instagram、小红书、TikTok、X 等平台）
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/...

技术栈

• 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: 视频

说明：

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

本地开发

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

   pnpm install

3. 运行开发服务器：

   pnpm dev

4. 生产构建：

   pnpm build

5. 启动构建产物：

   pnpm start

SEO 配置

部署时建议配置以下环境变量，确保上游解析服务、canonical 和索引策略都正确：

• API_BASE_URL: 上游解析服务地址，例如 https://api.example.com。生产和预发部署必须配置；本地开发未配置时默认使用 http://localhost:8080
• NEXT_PUBLIC_SITE_URL: 当前环境站点地址（例如 https://downloader.bhwa233.com）
• SEO_INDEXABLE: 是否允许索引，true / false

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

如果生产或预发环境未配置 API_BASE_URL，应用的代理接口会返回 503 SERVICE_UNAVAILABLE JSON 错误，而不是未处理的 500。

默认策略：

• 在 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

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

pnpm deploy:ci

预览部署可使用：

pnpm deploy:preview

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