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是一个免费的抖音下载工具，给想长期保存视频、图集、合集和原声音乐的普通用户。它全程本地运行，无水印直链自动解析，填一个作者主页链接就能批量拉取，去重与断点续传都内置好了。
下面按"先跑通、再挑场景、后调参数"的顺序讲。
四步拉通第一条无水印视频
环境只要 Python 3.8 以上，Windows、macOS、Linux 都能跑。
第 1 步，拉代码装依赖。
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt终端刷完Successfully installed且没有红色报错，依赖就算装好了。
第 2 步，复制配置文件。模板 config.example.yml 每项都有中文注释，照抄即可。
cp config.example.yml config.yml命令无输出是正常的，ls能看到config.yml生成就对。
第 3 步，扫码取 Cookie。先装 playwright 供浏览器兜底，再跑抓取脚本。
pip install playwright && python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml会弹出浏览器窗口，扫码登录抖音后回终端按回车，Cookie 自动写进 config.yml，不经过任何在线服务。
第 4 步，下第一条视频。-u直传作品链接，-p指定落盘目录，不用改配置文件。
python run.py -u "https://www.douyin.com/video/7604129988555574538" -p ./Downloaded终端进度条走到 100%，去./Downloaded/看到无水印 mp4，就算跑通了。
跑通之后，剩下的是挑场景。
三个高频场景：全主页、时间窗、直播间
桌面版 Douzy 与命令行共用同一套后端，贴链接即下，任务结果随时可查。
图：Douzy 抖音工作区，贴入作品链接点"下载"即开始无水印下载
批量拉走一位作者的全部作品
这是用得最多的场景。link换作者主页地址，number.post填 0 表示全量。
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0文件按"作者/模式/作品"三级目录归档，跨post、like、mix模式同一作品不会下重。桌面版里每条任务的成功数、失败数在任务中心单独列。
图：任务中心逐条列出批量下载任务，成功与失败数量一眼可辨，失败项可单独重试
只收某段时间的作品
更新太勤的博主，只想留半年内的？加两个日期字段，格式YYYY-MM-DD。
start_time: "2024-06-01" end_time: "2024-06-30"跑完翻Downloaded/作者名/post/，目录全落在 6 月窗口内。
直播间实时录制
link指向直播间地址就进录制模式，FLV 存到Downloaded/{作者}/live/。
link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0填 0 表示录到主播下播；中途 Ctrl+C 或断网，已录的字节都会保留。
场景过完，默认参数未必合你意。
五个参数把下载节奏调成自己的
- thread：默认 5 线程。批量大时改成 8，或命令行
-t 8临时覆盖；网络一般别硬拉，撞限流反而更慢。 - retry_times：默认 3 次，失败按 1s、2s、5s 指数退避。网络抖动全靠它兜底，调 5 也不心疼。
- video_quality：默认
highest只在转码档里挑最高。要原片填original（每条多一次探测请求）；省流量填lowest或钉死1080p。 - increase：
increase.post: true时按磁盘判断，已有主文件的直接跳过，等于增量下载；想重下当前范围就设false。 - download_pinned：默认
false不下载作者主页的置顶作品。置顶内容也想归档时改成true。
thread: 8 retry_times: 5 video_quality: original increase: post: true download_pinned: true写进 config.yml 保存，下次python run.py -c config.yml直接生效。
参数调顺手了，再说翻车的时候怎么办。
高频报错速查：Cookie 过期、只翻 20 条、想重下
问：提示 403 或未登录？→ 答：最可能是 Cookie 过期，有效期一般 7~15 天。重跑python -m tools.cookie_fetcher --config config.yml刷新，建议每周更新一次。
问：只能抓到 20 条左右，后面没有了？→ 答：典型的翻页风控。确认browser_fallback.enabled: true且headless: false，弹窗出来后手动完成验证再让它继续翻，别急着关窗口。
问：想重新下载一个已存在的作品？→ 答：跳过逻辑是"数据库记录 + 本地文件"双重判断。先删本地对应目录（目录名含作品 ID），再删库内记录。
sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '<aweme_id>';"只删文件也会触发重下，但两边都清最干净。
问：进度输出太吵，分不清正常日志和报错？→ 答：默认progress.quiet_logs: true已压住刷屏。调试时临时加--show-warnings或-v，平时别开。
翻车基本就这几类，排掉就稳了。
全量归档：把追更博主存进本地硬盘 📺
一句话收束：填链接、等落盘，douyin-downloader 把"刷到就存"变成了体力活，文件与历史记录全留在你自己电脑上。
边界提醒：本工具仅限个人学习、备份与研究用途，不要二次分发或商用，尊重创作者的劳动成果；它依赖抖音公开接口，接口或风控策略调整可能导致个别功能暂时失效，属正常技术风险。
今天就挑一位你追更的博主，把number.post改成 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），仅供参考
