抖音批量下载实战单条到整站主页的完整上手指南【免费下载链接】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——一个基于 Python 的抖音批量下载工具配好一个 YAML 文件就能把视频、图集、原声音乐自动归档无水印、还能自动跳过已下载的内容。这篇把它的配置方法从头走一遍帮你把第一条命令跑通。项目速览定位面向命令行用户的抖音无水印下载与归档工具支持单条视频、图集note/gallery、合集mix、音乐、用户主页批量抓取技术栈Python 异步请求aiohttp SQLite 历史记录 Rich 进度条跨 macOS / Linux / Windows自带 Dockerfile附加能力评论区采集、热搜/关键词搜索导出 JSONL、直播录制实验性、REST API 服务模式同后端还有一个闭测中的桌面版 Douzy贴链接即可下载可看 桌面版下载界面环境准备与安装系统要求 Python 3.9。下面四步走完全流程git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml如果你需要浏览器兜底分页被风控时弹出浏览器手动过验证或自动抓 Cookie再补装一次浏览器内核pip install playwright python -m playwright install chromiumCookie 配置最容易翻车的一步所有下载都依赖config.yml里cookies块的ttwid、odin_tt等字段缺了它们多数接口会直接拒绝。推荐用自动方式获取这条命令会打开浏览器让你登录抖音登录完成后回终端按回车Cookie 会写回配置文件python -m tools.cookie_fetcher --config config.yml手动维护的话从浏览器开发者工具的 Cookie 列表里逐项抄进cookies块即可字段对应关系见 Cookie 管理器。按场景使用只抓一条视频把链接写进config.yml的link里就行分享短链https://v.douyin.com/...也能识别解析逻辑在 core/url_parser.pylink: - https://www.douyin.com/video/7604129988555574538不想动配置文件时命令行直接追加python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538预期结果Downloaded/{作者昵称}/post/下生成无水印 mp4目录名自带日期、标题和作品 ID。拉取整个主页主页链接用/user/{sec_uid}形式mode决定抓什么number里写0表示不限条数link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like number: post: 0 like: 0预期结果按post/like/mix/music分目录落盘同一作品跨模式只下一次。注意登录态下的收藏合集collect/collectmix必须单独使用不能和上面几种模式混写且只对 Cookie 对应的账号生效。图集、原声音乐与评论图集链接换成/note/{id}或/gallery/{id}产出多张 JPG音乐/music/{id}优先直连音轨失败时回退到相关作品评论把comments.enabled改成true每条作品旁会多一份*_comments.json直播链接指向live.douyin.com/{room_id}时自动切录制模式属实验性功能进阶配置与调优高频参数一览改完直接重跑python run.py -c config.yml生效参数作用推荐值thread并发下载数默认5网络稳定可提到 8~10retry_times失败重试次数指数退避 1s/2s/5s3increase按模式增量下载磁盘已有文件则跳过truedatabase/database_pathSQLite 历史与去重记录true/dy_downloader.dbvideo_quality画质档位original会探测原片一般highest要原画再上originalbrowser_fallback.enabled分页被风控时开浏览器兜底true且headless: falseprogress.quiet_logs进度阶段静默日志truestart_time/end_time按发布时间过滤格式YYYY-MM-DD按需调并发前先想清楚thread拉太高容易触发风控5左右通常是效率和稳定性的平衡点。增量下载只看磁盘文件是否存在SQLite 历史只负责记录两者分工别搞混。排错速查只抓了约 20 条就停→ 分页被风控 →browser_fallback.enabled设为true、headless设为false在弹出的浏览器里手动过验证别提前关掉。跑到一半提示 Cookie 失效→ttwid/odin_tt过期 → 重跑python -m tools.cookie_fetcher --config config.yml重新登录。想强制重下已有内容→ 增量模式下文件在磁盘就会被跳过 → 把对应模式的increase改成false重跑会重下并原子覆盖当前筛选范围。进度输出刷屏、日志巨大→ 默认应开静默 → 确认progress.quiet_logs: true调试时临时加--show-warnings或-v。合规与边界仅限学习研究和个人资料归档遵守抖音平台服务条款尊重创作者版权不要二次发布、商用或用于侵权平台接口变更导致功能失效属于正常技术风险那份竞品清单后来是这么收尾的主页链接一个个丢进config.yml挂着跑完第二天直接打开目录验收。你也可以从最小的一步开始——先跑python run.py -c config.yml -u 一条视频链接把第一条无水印视频存下来。【免费下载链接】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），仅供参考