DouK-Downloader：3 步免转码提取抖音音频，作品原声采集实操指南
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
晚上十点，剪视频前发现想要的 BGM 藏在一个抖音作品里。长按保存只能拿到带画面的完整视频，再丢进 ffmpeg 拆音轨又多一道转码损耗。DouK-Downloader（原 TikTokDownloader）做抖音音频提取不需要这一步——它向平台接口请求作品数据，直接下载作品挂载的原声文件，免转码、免二次压缩，拿到手就是原始音源。一句话定位：它拿的是音频原声，不是从视频里二次分离的音轨——music_url为空的作品就下不到音乐，这不是程序毛病。
它是什么，不是什么
基于 Python（要求 3.12+）的开源命令行工具，请求抖音 / TikTok 平台接口，把作品、图集、原声、封面直接落盘。支持终端交互和 Web API 两种形态，采集结果可导出 csv / xlsx。
边界说清楚：
- 它不从视频文件里二次分离音频——下载的是音源本身，
music_url为空的作品没有音乐可下 - 它不做转码——平台返回什么格式就落盘什么格式
- 音频提取用不到FFmpeg——FFmpeg 只服务于直播拉流场景，见 src/module/ffmpeg.py
最小路径：从 0 到第一个抖音音频文件
| 步骤 | 操作 | 你应看到什么 |
|---|---|---|
| 1 | git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader并进入目录 | 目录里能看到main.py、requirements.txt |
| 2 | pip install -r requirements.txt | 终端无报错退出 |
| 3 | python main.py | 项目根目录生成settings.json，提示设置 Cookie |
| 4 | 按 Cookie 获取教程 把 Cookie 填入settings.json的 cookie 字段，music改true | 配置文件里 cookie、music 两处改动已保存 |
| 5 | 重跑程序，选「终端交互模式」→「批量下载链接作品(抖音)」→「手动输入待采集的作品链接」，粘贴v.douyin.com短链，输Q结束 | 打印「抖音参数更新完毕！」，Download/下出现同名 mp4、mp3 |
settings.json里只需动这几个字段，其余保持默认：
{ "cookie": "你的抖音Cookie", "music": true, "download": true, "name_format": "create_time nickname desc" }如果选功能后终端直接报「抖音平台功能可能无法正常使用」，大概率是 Cookie 没生效，见后文故障定位第 1 条。
音频提取只动这几项配置
| 参数 | 默认值 | 什么时候需要改它 |
|---|---|---|
music | false | 音频提取必开，决定 download_music 是否下载原声 |
download | true | 只采数据、不落盘文件时设为false |
name_format | create_time type nickname desc | 想按账号、描述重排文件名时 |
folder_name | Download | 想和旧数据分目录存放时 |
storage_format | 空（不存储） | 需要把作品数据导出为 csv / xlsx 时 |
ffmpeg | 空（自动探测系统） | 直播拉流提示找不到 ffmpeg 时填绝对路径 |
最小可用配置，其他项都不动也够跑通：
{ "cookie": "你的抖音Cookie", "music": true }三种玩法，各适合谁
单条提取——适合偶尔找一首 BGM 的创作者。就是最小路径第 5 步：粘贴短链、回车、等进度条走完。跑通标志：Download/目录下出现与作品同名的 mp3，和 mp4 平级存放。默认是平铺结构，想让每个作品单独建文件夹就打开folder_mode。
定时批量——适合长期追踪若干音乐人账号的运营。把账号写进accounts_urls，earliest/latest可限定日期范围，空则不限：
"accounts_urls": [ { "mark": "关注的音乐人", "url": "https://www.douyin.com/user/xxxx", "tab": "post", "earliest": "", "latest": "", "enable": true } ]运行后选「批量下载账号作品(抖音)」→「使用 accounts_urls 参数的账号链接(推荐)」。跑通标志：终端输出「程序共处理 X 个账号，成功 Y 个，失败 Z 个」。程序对已下载的作品做记录并跳过，新发布的作品下次运行自动增量补齐，不会重复下载。
API 集成——适合把下载能力嵌进自己工作流的开发者。主菜单选「Web API 模式」启动服务，监听 5555 端口（端口定义见 src/custom/static.py），浏览器打开http://127.0.0.1:5555/docs看自动生成的接口文档，挑链接 / 账号下载相关接口发请求即可。跑通标志：/docs页面能打开，接口返回成功后Download/下出现对应文件。
故障定位
提示「配置文件 cookie 参数未设置，抖音平台功能可能无法正常使用」
- 可能原因：①
settings.json的 cookie 参数为空 ② 复制成了别家站点的 Cookie - 验证动作：看启动后终端是否打印「正在更新抖音参数，请稍等...」
- 修复：按 Cookie 获取教程 重新复制一份完整 Cookie 写入 cookie 字段，重启程序
提示「当前抖音 Cookie 未登录」或功能报不可用
- 可能原因：① Cookie 缺
msToken等关键键值 ② Cookie 已过期登录态失效 - 验证动作：看启动后是否打印「抖音参数更新完毕！」
- 修复：按教程重取一份完整 Cookie 覆盖写入，重启程序
music 开了却没有音乐文件
- 可能原因：① 作品本身无原声
music_url为空 ②download被设为false - 验证动作：换一条明确挂着 BGM 的作品重跑
- 修复：无原声的作品会被程序直接跳过，换有 BGM 的作品即可，不是程序故障
直播拉流找不到 ffmpeg
- 可能原因：① 系统没装 ffmpeg ② 装了但不在 PATH 里
- 验证动作：终端执行
ffmpeg -version - 修复：可用则把绝对路径写进
ffmpeg参数，不可用就先安装 ffmpeg
选型参考
| 维度 | DouK-Downloader | 在线解析网站 | ffmpeg 拆音轨 |
|---|---|---|---|
| 音频来源 | 作品挂载原声文件，零转码 | 多经过二次处理 | 视频内音轨，有压缩损失 |
| 批量 / 账号追踪 | 支持，可配日期范围 | 基本不支持 | 不支持 |
| 数据导出 | csv / xlsx / sql | 无 | 无 |
| 成本 | 开源免费 | 有广告、次数受限 | 免费但纯手工 |
快问快答：
- 拿到的是什么格式？原声文件原样落盘，平台给什么就是什么。
- 能只采数据不下文件吗？能，
download设false再开storage_format。 - 抖音和 TikTok 能同时跑吗？能，两平台各有独立的 cookie、proxy 参数。
- Cookie 会过期吗？会，出现未登录提示就按教程重取一份。
- 已下载的作品会重复下吗？不会，下载记录和文件存在检查会自动跳过。
从这里起步
那条 BGM 现在一条链接、几分钟就能躺在你的Download/素材目录里。稳妥的顺序是先按最小路径把单条提取跑顺，确认name_format出的文件名符合剪辑习惯，再把要追踪的账号填进accounts_urls，让批量模式替你把活干完。
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
