免费抖音音频下载:3 个配置模板,10 分钟批量出文件
【免费下载链接】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 是个命令行工具:贴链接,自动下视频、图集、合集和音频,去水印,还带 SQLite 去重和失败自动重试。下面 10 分钟,从装环境到出第一个文件,全部跑通。
| 传统做法 | 用这个工具 |
|---|---|
| 先下视频再剪音频 | 音频直出 MP3 |
| 手动一个一个存 | 贴主页批量下 |
| 自己记哪些下过 | 自动跳过已下载 |
| 失败全靠自己来 | 自动重试断点续传 |
| 水印留在一角 | 自动选无水印源 |
30 秒看懂它能干什么 🎵
- 🎵 它能帮你只抠出原声 MP3,不用先下整段视频
- 📦 它能帮你扫一个创作者主页,按你设的数量批量下载
- 📊 它能帮你自动跳过下过的作品,跨次运行不重复
- 🔁 它能帮你把失败的条目自动重试,网络断了重跑接着来
适合管着好几个创作者素材库的你;不适合想下私密或付费内容的人,它只管公开内容。
从零到第一次成功出文件
装环境
工具是纯 Python 写的,先把代码拿到本地、装好依赖。
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt看到Successfully installed,这步就成了。
拿登录凭证
抖音要登录态才能返回完整数据,凭证就是 Cookie(网站的"免登录凭证",过期就要重新拿)。两种方式:自动抓取(打开浏览器登录一次即可,新手推荐)和手动复制浏览器里的 Cookie 填进配置。新手直接走自动:
python -m tools.cookie_fetcher --config config.yml浏览器弹出、登录完抖音,回终端按回车,Cookie 会自动写进config.yml。看到提示"cookies 已保存"就说明拿到了。
改配置,跑第一个任务
把示例配置复制一份,只动几处就行:
link: - https://v.douyin.com/你的短链/ path: ./Downloaded/ # 存放目录 music: true # 只出音频 cover: false # 不要封面 json: true # 存元数据 thread: 3 # 并发数 retry_times: 3 # 失败重试然后执行python run.py -c config.yml。看到进度条走完、Downloaded目录里出现.mp3和_data.json,第一个任务就成了。
链接粘贴后即可开始下载
挑你的角色,抄配置
给做音乐的
挑 BGM 最烦的是重复劳动和画质缩水。这套配置只出音频、保留原画探测,同一主页反复跑不会重复下载:
link: - https://www.douyin.com/user/创作者主页链接 path: ./素材/{author}/ # 按人分文件夹 mode: [music] # 只跑音频 video_quality: original # 保留原画 increase: post: true # 跳过已下载 number: post: 0 # 0=全部跑完你会得到按创作者分好的 MP3 文件夹,重复运行只补新的。
给做内容的
运营要的是量大、要快。多主页链接列进link就能一次跑完,thread拉高并发,封面和元数据一起抓,做选题表时直接筛:
link: - https://www.douyin.com/user/主页1 - https://www.douyin.com/user/主页2 - https://www.douyin.com/user/主页3 path: ./素材库/ # 统一目录 mode: [post, music] # 视频+原声 thread: 5 # 并发拉满 cover: true # 封面一起抓 json: true # 存元数据 number: post: 50 # 每人50条跑完你会得到按作者、按作品分好层的目录,标题和作者名都在 JSON 里,直接能筛。
按创作者列表批量下载
给研究 / 学习的
研究要的是全量和可回溯。json: true让每个文件都带元数据;链接换成https://live.douyin.com/直播间ID就能录直播,中断也会保留已录部分;再配合系统的定时任务(比如 crontab 每天跑一次同样的命令),库就自己长起来了:
link: - https://www.douyin.com/user/研究对象主页 mode: [post] # 全量作品 number: post: 0 # 0=不限 json: true # 元数据必备 comments: enabled: true # 顺带抓评论 max_comments: 200 # 每条约200条 live: max_duration_seconds: 0 # 直播录到结束跑完你会得到作品、封面、原声、_data.json和评论 JSON 一整套,做时间线或统计都够用。
翻车了?对照这里修
下载速度只有几十 KB/s
- 把
thread调到 3–5,别拉太高。 - 默认限速是每秒 2 个请求,属正常保护,耐心点。
- 避开晚高峰,或换网络再跑。
提示 Cookie 失效 / 拿不到数据
- 重跑抓取,把新 Cookie 写回配置:
python -m tools.cookie_fetcher --config config.yml- 抓取时确认浏览器里是已登录状态。
- 还是不行就把
browser_fallback.enabled保持为true,让它走浏览器兜底。
部分文件没下全 / 报错
- 确认
retry_times至少是 3,失败会自动按 1s、2s、5s 退避重试。 - 等几分钟重跑同一份配置,已完成的会自动跳过。
- 仍失败的条目看日志里的链接,单独换一条贴进去。
音质不如预期
- 音频模式出的是视频里的原声,别走"下载视频再转换"的老路。
- 原片本身音质有限,工具没法放大它。
- 下载视频素材时设
video_quality: original,探到原片就用原片。
任务中心可查成功与失败数
几个容易忽略的设置
去重是数据库+磁盘双保险。SQLite 记下每条作品的 ID,下次跑同一份配置时已存在的直接跳过;删掉本地文件、库里没记录,它才会重新下。
断点不用手动管。下载中断、网络断掉,直接重跑同一条命令即可,已完成的文件不会重复下,下了一半的残缺文件会被清掉重来。
分页被限频时自动切浏览器。API 翻页拿到一半被卡住,工具会弹出一个真实浏览器继续滚动加载,你在里面顺手完成一次验证就行,不用改配置。
下载完的目录长这样:
Downloaded/ └── 作者名/ ├── post/ │ └── 2026-09-01_标题_作品ID/ │ ├── 视频.mp4 │ ├── 原声.mp3 │ ├── 封面.jpg │ └── 数据.json └── music/ └── ...跑通一次之后,日常就是两件事:把链接贴进config.yml就能批量出音频;主页链接加number限制,定时跑就能持续更新素材库。更多配置项看 config.example.yml,核心下载逻辑在 core/ 目录。下载内容仅供个人学习研究。记得定期git pull保持最新,下次遇到想存的 BGM,一行命令的事。
【免费下载链接】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),仅供参考