批量下载抖音音频douyin-downloader 上手指南【免费下载链接】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 可以直接完成这件事。它支持单个链接、主页批量、音乐原声、直播录制四类任务全部通过一份 YAML 配置驱动。下面从装环境开始带你跑通第一个音频任务。 能力速览先知道它能做什么类别内容能下载单个视频/图集/合集/音乐链接、作者主页作品post、喜欢列表like、直播流能提取视频去水印、原声音频music: true、封面、作者头像、JSON 元数据能跳过SQLite 数据库记录历史increase开启后重复运行只取新内容有限制collect/collectmix收藏夹模式只能单独使用且只作用于当前登录账号直播录制为实验性功能 最短上手路径装环境、拿 Cookie、写配置第一步拉取代码并安装依赖。浏览器兜底功能依赖 Playwright一并装上git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt pip install playwright python -m playwright install chromium这一步装好运行时和浏览器内核后面 Cookie 自动获取和翻页兜底都靠它。第二步复制配置文件并获取 Cookie。抖音接口需要登录态工具会用浏览器带你登录一次cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml按提示扫码登录回到终端回车Cookie 自动写回 config.yml这一步做完后长期有效。第三步把config.yml改成只保留这几个键就是一份可运行的音频提取任务link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ music: true json: true thread: 3music: true让工具把作品的原声单独保存json: true附带一份元数据。然后运行python run.py -c config.yml命令行参数也可以在运行临时覆盖配置比如-p ./out/改保存目录、-t 8改并发完整参数见 README.md。 单个作品只提取一条视频的音频把link换成任意作品短链v.douyin.com开头也认music保持true、video设为false就不会再存视频本体只留音频。运行后在Downloaded/作者名/post/下找到对应的音频文件json: true时会多一个包含标题、作者、发布时间的.json。 主页批量提取一位作者全部作品的原声把link换成https://www.douyin.com/user/{sec_uid}模式设为post再配合number控制数量link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0 increase: post: truenumber.post: 0表示全部拉取increase.post: true保证第二次运行时跳过已下载的作品实现增量收集。任务中心界面会显示每个链接的成功/失败计数API 翻页被拦时浏览器兜底browser_fallback.enabled: true会自动接管遇到验证需要你在弹出的浏览器里手动处理一次。 直播录音保存直播间的音频流link填https://live.douyin.com/{room_id}再打开live配置块link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 idle_timeout_seconds: 30录制结果保存在Downloaded/{作者}/live/下的 FLV 文件中断或主播下播时已录部分会保留。注意 FLV 是容器格式若要转 MP3 需自行用 ffmpeg 处理。 定时任务每天自动增量收集把增量配置留着用系统计划任务定时跑同一条命令即可。Linux 下加入 crontab每天凌晨 3 点执行0 3 * * * cd /path/to/douyin-downloader python run.py -c config.yml download.log 21因为increase默认开启每天只会有新作品落盘旧文件不动。 配置参数速查表参数默认值什么时候改musicfalse要提取音频时改为truevideotrue只要音频时改为false省空间jsonfalse需要保存标题、作者等元数据时开启thread5网络一般或频繁超时降到 3rate_limit2每秒请求数出现风控保持 2 或调低retry_times3弱网环境可加到 5number.post0只要最近 N 条时填具体数字start_time/end_time空按时间范围筛选作品时填日期databasetrue建议保持开启增量去重依赖它 高频问题排查提示登录态失效或要求重新登录原因Cookie 过期通常数周后发生。 动作重跑python -m tools.cookie_fetcher --config config.yml登录一次。批量任务中途大量失败原因并发和请求速度触发限制。 动作thread降到 3rate_limit保持 2观察失败率是否回落。运行结束但没有音频文件原因music仍是false只下了视频本体。 动作把music改为true再跑一次已下载的视频会自动跳过。重复运行把文件下了两遍原因increase被关成false会强制重下覆盖。 动作改回true磁盘文件误删想补下时删掉对应数据库记录或保持redownload_missing_files: true即可。 收尾这套流程适合需要长期收集抖音音乐素材、备份作者主页内容的场景。下一步建议定期用git pull拉取更新配合 docs/ 里的设计文档了解增量与风控细节。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考