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-downloaderdouyin-downloader 是一个基于 Python 命令行运行的抖音下载工具输入链接加一份 YAML 配置即可批量下载无水印视频、图文、合集与原声音乐内置重试、SQLite 去重和浏览器兜底适合需要长期归档个人抖音内容的普通用户和脚本爱好者。能力速览先看这张表再决定要不要读下去能力入口方式适合场景注意事项单条视频/图文去水印下载配置文件里的link或命令行-u保存某一条作品必须配好 Cookie主页作品、喜欢、合集、原声批量下载mode勾选模式 number限数备份整个博主各模式可混跑收藏类collect只能单独用直播录制link填live.douyin.com房间链接录整场直播官方标注 experimental热搜榜 / 关键词搜索导出 JSONL--hot-board/--search参数只要数据不要文件结果落盘为 JSONL可直接用 jq/pandas 筛选失败重试 SQLite 去重retry_times/database配置长任务断点续跑默认已开启保持默认即可下载完成通知notifications.providers挂机跑任务支持 bark / telegram / webhook想跳过安装细节直接看场景场景一单条去水印、场景二主页批量。场景一下载一条无水印视频 解决的问题把一条别人分享的抖音作品存成无水印 mp4落到本地固定目录。前置准备登录态 Cookie 是最关键的一项抖音大量接口只认登录用户。把 config.example.yml 复制为config.yml后运行自带的 Cookie 抓取脚本它会弹出浏览器你扫码登录、回终端按 EnterCookie 就自动写回配置文件cp config.example.yml config.yml pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml然后把config.yml里的link换成目标作品链接保留path与cookies区块不动直接运行python run.py -c config.yml成功长什么样终端出现完成统计path指定的目录默认./Downloaded/下出现以作者名命名的文件夹里面是无水印 mp4若配置里开了music、cover、json原声、封面和元数据也会一并进作品文件夹。高频翻车点请求大面积失败、刚装好时单条都下不动 → 多半是 Cookie 没生效或已过期重跑一次python -m tools.cookie_fetcher --config config.yml。进度和日志太安静不知道卡在哪 → 加-v参数查看详细日志。场景二把博主的作品和合集一次备份解决的问题归档一个博主的存量内容而不是每次手动贴单条链接。前置准备link填博主主页链接douyin.com/user/...形式mode勾选要抓的类型number给每种模式设上限0表示不限。测试阶段先把post设成 15跑通后再放开link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - mix number: post: 5 mix: 20python run.py -c config.yml成功长什么样内容按Downloaded/{作者}/post/与Downloaded/{作者}/mix/分目录归档再跑同一份配置时increase增量为true的已下载作品会被自动跳过不会在硬盘上堆重复文件。注意collect/collectmix收藏类只能单独使用不能与post/mix等混写在同一份mode里。高频翻车点主页只抓到 20 条左右就停了 → 翻页触发风控确认browser_fallback.enabled: true且headless: false在弹出的浏览器里手动过验证仍不行就用start_time/end_time分段抓。想让某博主重下一批 → 把对应的increase.post改为false即可重下并覆盖当前筛选范围无需清空数据库。目录按作者昵称建遇到重名博主会合并 → 重度用户把author_dir改为nickname_uid切换只影响后续下载。场景三只导出数据不下载文件解决的问题拿到热搜榜或关键词搜索结果做二次筛选不产生任何媒体文件。前置准备Cookie 有效即可下载目录参数-p指定 JSONL 落盘位置。两条命令各跑一次python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded成功长什么样Downloaded/hot_board/{时间戳}.jsonl里是热搜条目Downloaded/search/猫咪_{时间戳}.jsonl里是搜索命中的作品元数据一行一条 JSONjq、pandas 可直接读挑出感兴趣的链接再丢回下载器即可。高频翻车点搜索结果条数不够 →--search-max默认 50按需调大。导出失败而单条下载正常 → 检查 Cookie 是否过期抓取脚本重跑一遍。参数速查正文出现过的旋钮都在这里字段默认值什么时候调调成什么number.post等0不限测试阶段限量15跑通后放回0increase.post等true想重下某批作品false重下并覆盖筛选范围内文件video_qualityhighest要原画 / 省流量original额外探测原片或lowest、指定720p等thread5网速稳定想提速8别一上来拉满retry_times3网络抖动多35配合内置指数退避database/database_pathtrue/dy_downloader.db几乎不用动保持true它是去重主开关start_time/end_time空风控截断、分段抓取YYYY-MM-DD含结束日当天browser_fallback.headlessfalse翻页被风控截断保持false留出手动过验证的机会comments.enabledfalse想要作品评论true每作品旁多一个*_comments.jsonnotifications.enabledfalse挂机跑长任务trueproviders填 bark / telegram / webhooklive.max_duration_seconds0录到下播只想录固定时长3600之类-t命令行同thread临时改并发python run.py -c config.yml -t 8完整字段注释见 config.example.yml全部命令行参数用python run.py --help查看。故障排查一张表对号入座现象最可能原因一行解法预防方法大面积请求失败Cookie 过期python -m tools.cookie_fetcher --config config.yml刷新把 Cookie 刷新当周期性维护主页只抓到少量作品翻页触发风控保持browser_fallback.enabled: true且headless: false手动过验证用start_time/end_time分段硬盘堆出重复文件去重开关被关database: true并保持increase为true增量任务常开增量某条被跳过想重下增量机制判重对应increase.post改为false再运行用number.post圈定重下范围速度慢并发偏保守-t 8临时提并发retry_times给3逐步上调而非直接拉满输出太吵或太安静日志级别问题排查时加-v或--show-warnings常态设progress.quiet_logs: true直播录出来是 FLV 而非 mp4直播接口为 experimental重要场次人工再备份一份重要活动设max_duration_seconds留余量落地前检查清单先装依赖pip install -r requirements.txt再用单条作品链接验证 Cookie 与网络确认无水印 mp4 落盘后再上主页批量。测试阶段number.post设 15跑通后才放开为 0不同任务分开用config_test.yml、config_daily.yml别共用一份。长任务开启notifications推送跑完手机先收到结果再翻终端。Cookie 失效是常态每次大面积失败先重跑 tools/cookie_fetcher.py再怀疑别的环节。更细的行为说明以仓库 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考