抖音去水印批量下载教程:4步跑通 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 是免费的开源抖音去水印批量下载工具:支持视频、图集、合集、音乐原声,也能把用户主页的作品整批导出。内置 SQLite 去重、增量下载与浏览器验证兜底,默认 5 线程。完整流程 4 步,一次就能跑通,唯一的硬前提是一份 Cookie。
🚀 跑通一次
准备环境
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt你会看到:依赖逐个安装完成,没有红色报错,目录里出现 run.py、config.example.yml 等文件。要求 Python 3.8+;若打算用浏览器验证兜底,再执行:
pip install playwright python -m playwright install chromium获取 Cookie
cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml你会看到:弹出浏览器窗口,用抖音 App 扫码登录后,回到终端按回车,msToken、ttwid 等 Cookie 被写进 config.yml。实现见 tools/cookie_fetcher.py,Cookie 只保存在本地。
最小配置
打开 config.yml,最简单的情况只改两处:
link: - https://v.douyin.com/XXXX/ path: ./Downloaded/link 可以是视频、图集、合集或主页链接,完整模板在 config.example.yml。
首次运行
python run.py -c config.yml你会看到:终端出现进度条,结束后 Downloaded/ 目录里多出无水印 mp4、封面、原声音频和一份 JSON 元数据。完整中文文档见 README.zh-CN.md。
📦 它能做什么
以下截图来自共用同一后端的 Douzy 桌面版(目前封闭测试),每项能力在 CLI 里都有对应命令或配置。
用户主页整批导出
粘贴博主主页链接即可整批导出,视频会自动从码率阶梯里挑最高的无水印源。
link: - https://www.douyin.com/user/xxxx mode: - post number: post: 0实用细节:number.post 写 0 表示不限量。批量几百条时若 API 翻页触发风控卡住,browser_fallback 会自动打开浏览器继续抓取。
增量下载与去重
对同一博主反复运行,只拉取新发布的作品,不重复占空间。
increase: post: true database: true易踩的坑:跳过与否的判断依据是本地主媒体文件是否存在,而不是数据库记录。手动删掉某个视频,下次就会重下;想强制重下某条作品,还需同步删除 dy_downloader.db 里对应记录。
任务中心实时监控
查看哪些任务成功、哪些失败、具体缺了哪几条,失败项可以单独重试。
python run.py -c config.yml --show-warnings实用细节:--show-warnings 会显示警告日志,失败时先确认 Cookie 是否过期,再核对日志里的接口报错。
收藏与喜欢备份
把自己账号的收藏、喜欢批量导出,适合账号迁移或归档整理。
link: - https://www.douyin.com/user/self?showTab=favorite_collection mode: - collect易踩的坑:collect / collectmix 只对当前登录 Cookie 对应的账号生效,且不能与 post、like 等模式同时使用,配置时把其他模式删掉。
🎬 放在真实场景里
如果你是创作者在收集素材,可以这样用:粘贴优质博主的主页链接,number.post 设 0 整批导出;用 start_time / end_time 只保留某个月的作品;folderstyle: true 让每条作品单独建子目录;同目录下的 music.mp3 就是原声,可直接拖进剪辑工程。
如果你想定期备份账号,可以这样用:mode 同时写 post、like、mix、music,一次导出全部内容;increase 打开,后续运行只补增量;comments.enabled: true 后每条评论会另存为 JSON 文件;每周重跑一次同一条命令即可追新增。
如果你想录直播,可以这样用:粘贴 live.douyin.com 房间链接,max_duration_seconds 设 0 表示录到主播下播;文件以 FLV 存到 Downloaded/作者/live/ 下;即使中断或断网,已录部分会自动保留。
🛠️ 遇到问题先看这里
只下到约 20 条作品:现象是 500 条作品只下到二十来条就结束;原因是抖音翻页风控;解法是设置 browser_fallback.enabled: true、headless: false,在弹出的浏览器里手动完成验证,完成后别马上关窗口。
请求失败或列表为空:现象是大量 403 或抓不到作品;原因是 Cookie 过期;解法是重跑 python -m tools.cookie_fetcher --config config.yml 重新扫码,Cookie 有效期有限,隔一段时间重取属于正常维护。
重复下载已下过的内容:现象是二次运行又抓了一遍旧作品;原因是 increase 未启用或主媒体文件被删过;解法是设置 increase.post: true,并确认 path 指向的目录里文件完整。
想查下载历史:现象是记不清哪些已下过;原因是历史存在 SQLite 数据库而非终端输出;解法是直接查 aweme 表:
sqlite3 dy_downloader.db "SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;"先下单个视频确认 Cookie 可用,再尝试整批导出一个博主的主页。仅将内容用于个人学习与备份,尊重创作者版权。
【免费下载链接】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),仅供参考