douyin-downloader 完整实践指南：抖音去水印批量下载与主页采集，一次跑通

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 是一款免费的抖音去水印批量下载工具既能保存单条视频图文也能按作者主页整页采集。下面从入口选型、安装配置到调参排错带你把它跑成一套可复用的抖音视频下载工具工作流。先想清楚用哪个入口同一套代码两种长相。命令行版只覆盖抖音适合写脚本和挂任务Douzy 桌面版Windows/macOS覆盖抖音、TikTok、YouTube、Telegram、X适合不想碰终端的日常使用。先对照下表再决定维度命令行版 CLIDouzy 桌面版覆盖平台仅抖音抖音 TikTok/YouTube/Telegram/X单条作品/图文当前受抖音风控限制稳定支持主页批量采集支持依赖浏览器兜底支持时间窗/数量上限/增量跳过支持支持评论 / 转写 / 完成通知可配置bark·telegram·webhook文档未强调典型人群写脚本、挂定时任务粘贴链接、日常保存结论先说批量拉主页、做结构化采集走 CLI日常保存单条或跨平台走 Douzy。原因是抖音接口风控目前拦住了 CLI 对单条视频/图文、合集、喜欢、音乐的直接下载——反复刷新 Cookie 也解决不了这不是配置问题。相关实现集中在 core/浏览器兜底由 Playwright 提供。十分钟跑通第一条下载环境只要 Python 3.9Windows、macOS、Linux 都行。整条安装链路三步拉代码、装依赖、登录。装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt python -m pip install playwright python -m playwright install chromium前一行装运行依赖后两行装取 Cookie 与浏览器兜底用的 Chromium。登录拿 Cookie复制示例配置再跑登录脚本cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml它会打开浏览器登录抖音后回终端按 Enter 即保存 CookiePowerShell 用Copy-Item复制文件。取 Cookie 的逻辑在 tools/。最小配置与首跑把 config.example.yml 里的示例link换成目标主页最小字段如下link: - https://www.douyin.com/user/YOUR_SEC_UID path: ./Downloaded/ mode: [post] number: post: 10 # 0 表示不限 increase: post: true # 跳过已下载作品然后一条命令启动python run.py -c config.yml常用开关-u追加链接、-p换下载目录、-t调并发、-v看详细日志全量见python run.py --help。三种场景把工作流搭起来主页素材库增量只增不重把作者主页写进linkmode: [post]拉发布作品保持increase.post: true。重复跑同一配置时已下载作品自动跳过目录日期前缀取自发布时间无需手工整理。把它交给 crontab 或系统计划任务定期执行素材库只增不重。时间窗采集 结构化落盘研究者用start_time/end_time圈定发布日期窗口开启comments.enabled导出评论 JSONjson: true保留原始元数据按话题采集还能直接跑热搜与关键词搜索结果以 JSONL 落盘python run.py --hot-board 30 python run.py --search 美食教程 --search-max 50媒体文件、评论、download_manifest.jsonl清单和 SQLite 历史库一起落盘可直接接分析脚本。日常单条交给桌面版 只想存几条视频时装好 Douzy 后粘贴链接在界面勾选作品/喜欢/合集/音乐与数量上限即可开始还能从抖音账号同步关注列表批量选作者并用本地 SQLite 档案检索历史。这几个参数最该调下表只挑最影响结果的几个完整字段以 config.example.yml 为准。参数作用modepost/like/mix/music可组合number各模式数量上限0不限increasetrue跳过已下载false重下并覆盖start_time/end_time发布日期窗口含结束当天video_quality默认highestoriginal探测原片失败自动回退redownload_missing_files默认true主文件缺失或为空时补下thread/retry_times并发数默认 5/ 重试次数默认 3author_dir作者目录命名nickname/sec_uid/nickname_uidfilename_template命名模板须含{id}避免重名覆盖一段可直接改用的片段path: ./Downloaded/ start_time: 2025-01-01 end_time: 2025-06-30 video_quality: original thread: 5 mode: [post]需要走代理时改proxy字段下载历史默认落在dy_downloader.db存储逻辑在 storage/。报错时按这几步查Cookie 失效、下载报错重跑python -m tools.cookie_fetcher --config config.yml取新 Cookie实现见 tools/。主页只抓到几屏保持browser_fallback.enabled: true和headless: false在弹出的浏览器里自行完成验证仍抓不全多半是当前风控拦截。单条/合集/喜欢/音乐直接失败这是接口风控不是配置问题反复刷新 Cookie 无效日常单条改用 Douzy排查时给命令加-v看日志。想重下旧作品或删了文件不想补下把对应模式increase设false即可重下覆盖无需清库删文件后不想补下则关闭redownload_missing_files。收尾建议先用number.post: 10小规模跑通一个主页确认目录结构与去水印效果符合预期再改0放开数量。工具定位是个人学习与数据管理请留意抖音风控变化合理控制下载频率。【免费下载链接】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），仅供参考