抖音音乐下载工具：把热门 BGM 和无水印视频批量存到本地的 3 步教程

抖音音乐下载工具：把热门 BGM 和无水印视频批量存到本地的 3 步教程

【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具，去水印，支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader

douyin-downloader 是一个开源的抖音音乐下载工具，可以把抖音热门 BGM 和原声保存成本地文件，也能批量下载无水印视频、图文、合集以及作者主页作品。它解决的是平台本身不提供直接下载的尴尬：把链接写进配置文件，选好下载模式，原声 MP3、封面、元数据就会按作者和日期整理好存到硬盘，整个过程支持并发、自动重试，并跳过已经下载过的作品。

它适合哪些人

• 短视频创作者：需要把听到顺耳的 BGM 和参考视频批量存下来做素材
• 音乐爱好者：想按作者或时间范围收集抖音原声，建立自己的音频库
• 内容运营：持续跟踪某个账号的新作品，定期把主页内容同步到本地
• 数据整理者：需要作品标题、标签、封面等元数据（JSON 文件）配合媒体文件归档

几个真正用得上的功能

• 原声优先的音乐提取：支持单条音乐链接和按作者主页的 music 模式，优先取原始音频文件；下载视频时也可以附带作品原声 MP3，而不是从视频里转码。
• 批量下载加自动去重：一个配置文件里可以放多个链接，配合number限制每个模式的下载条数（0 表示不限）；程序用 SQLite 记录加本地文件双重检查，重复运行不会重复下载。
• 翻页受限时自动兜底：接口翻页被风控卡住时，可以配置浏览器兜底接管翻页，并弹出窗口让你手动过一次验证，避免只能抓到前几条。

抖音音乐下载快速上手

第 1 步：获取代码并安装依赖

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt

装完后环境里就齐了运行所需的 Python 依赖，接下来只需准备一份配置文件。

第 2 步：准备配置并获取 Cookie

cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml

第一条命令把示例配置复制为实际使用的config.yml；第二条会打开浏览器窗口，登录抖音后回到终端按 Enter，Cookie 会自动写回配置，无需手动复制。

第 3 步：写下第一个下载任务并运行

在config.yml的link里填一条音乐链接或作者主页地址，并设置mode: [music]，然后执行：

python run.py -c config.yml

终端会按进度条显示任务状态，完成后文件落在Downloaded/作者名/music/下，形如：

Downloaded/某音乐人/music/2026-09-01_作品标题_....mp3 任务完成：成功 1 / 共 1

每个作品会单独建一个子目录，媒体文件旁边还有封面和_data.json元数据，方便日后检索。

批量下载与定时任务的进阶玩法

批量收集某个作者的全部原声：在配置里把模式、数量和时间范围写在一起，start_time/end_time按YYYY-MM-DD格式过滤发布时间，increase打开后下次运行只补新增作品：

link: - https://www.douyin.com/user/xxxxxx mode: - music number: music: 0 # 0 表示不限数量 start_time: "2026-01-01" end_time: "2026-12-31" thread: 3 # 并发数，默认 5 increase: music: true

跑完这一次之后，同一份配置可以随时重跑，数据库和已有文件会自动跳过旧作品。

定时更新本地音乐库：Linux 或 macOS 下用 crontab 每周一凌晨自动跑一遍增量下载即可：

0 3 * * 1 cd /path/to/douyin-downloader && python run.py -c config.yml >> music_download.log 2>&1

结合上面的increase配置，这个定时任务每周只会拉取新发布的原声，日志里能直接看到当次结果。

常见问题避坑指南

• 只能抓到约 20 条就停：这是翻页风控的典型表现，把browser_fallback.enabled设为true、headless设为false，弹出浏览器后手动完成验证再继续，不要立刻关窗口。
• Cookie 失效导致下载失败：重新执行python -m tools.cookie_fetcher --config config.yml走一遍登录即可恢复。
• 进度条重复刷屏：保持progress.quiet_logs: true（默认开启），调试时才临时加-v参数看完整日志。
• 想重新下载某批作品：程序是数据库加文件双重去重，只删一边不够；需要同时清掉Downloaded下对应目录和数据库记录，删除后重跑才会真正重新下载。

写在最后

douyin-downloader 把「找歌、存歌、整理文件」这条链路压进了一个配置文件里，对只想要音乐的用户和要批量囤素材的创作者都够用，Docker 部署也在仓库里准备好了。更多参数细节可以直接看仓库内的 README.zh-CN.md，下载的内容建议仅用于个人学习和资料整理，商业用途请取得相应授权。

【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具，去水印，支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader