如何用 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 是一个免费开源的抖音批量下载工具给它一个链接加一份 YAML 配置就能得到归档到本地的无水印下载结果——视频、封面、原声并内置重试、SQLite 去重和浏览器兜底。想长期存档自己或他人抖音内容的个人用户正适合用它做配一次、长期跑的下载管线。开始之前先说清现状下面的分流表会直接把你导向对应小节。先坦白风控现状2026 年 89 月起抖音 Argus 门禁拦截了 CLI 的大部分直连下载接口单个视频/图文、合集、音乐、点赞/收藏类请求都会返回 403。以 2026-09-14 的实测为准直播间、热搜榜、关键词搜索、评论列表与用户资料仍可直连主页作品翻页只剩浏览器兜底一条路是否生效尚未经该门禁实测以 README.zh-CN.md 为准。桌面版 Douzy 通过内置登录窗口代发请求不受影响。所以以单条下载为主的用户优先看桌面版要录直播、导热搜数据、或长期抓主页的继续看 CLI。先看分流表找到你需求对应的小节这张表回答我现在想干的事该看哪一节、结果落在哪里。你的需求看哪一节结果落在只存几条视频 / 图文 / 合集跑通单条作品的下载Downloaded/作者名/下的无水印文件长期归档某个博主主页把博主主页变成本地档案库Downloaded/作者名/post/录制一整场直播把整场直播存成 FLV 文件Downloaded/作者名/live/只要数据、不要文件把环境装好冒烟测试命令Downloaded/hot_board/、Downloaded/search/的 JSONL如果你只是想存几条内容装好环境、跑通单条就够了要做长期存档主页那一节的去重和增量才是重点。把环境和登录态一次装好这一节解决从一台干净的机器到第一次运行成功。环境要求只有 Python 3.8macOS / Linux / Windows 都支持。先克隆代码并装依赖装完终端无红色报错即就绪git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt pip install playwright python -m playwright install chromium最后一行多装了浏览器内核是浏览器兜底和自动抓 Cookie 用的别省。登录态是跑通前的关键抖音大量内容只对登录用户开放Cookie 没配好请求基本都会失败。项目自带抓取脚本不需要手动复制任何字符串python -m tools.cookie_fetcher --config config.yml浏览器会弹出扫码登录抖音回到终端按 EnterCookie 自动写进配置文件。如果弹出后卡住先确认python -m playwright install chromium是否执行成功。装好后用热搜导出做一次冒烟测试——这个接口目前可直连是确认网络和 Cookie 都正常的好办法python run.py --hot-board 30 -p ./Downloaded成功标志Downloaded/hot_board/下出现一个带时间戳命名的 JSONL 文件内容就是热搜词条。想按关键词搜作品的话python run.py --search 猫咪 --search-max 100 -p ./Downloaded也能跑结果落在Downloaded/search/可直接用 pandas 或 jq 处理。跑通单条作品的下载这一节解决一条视频、图文、合集或音乐如何一次落到本地。先把带注释的模板 config.example.yml 拷成config.yml每个字段都有中文注释然后只改linklink: - https://www.douyin.com/video/7604123456789012345 path: ./Downloaded/运行python run.py -c config.yml。成功标志终端出现完成统计Downloaded/下多出以作者名命名的目录里面是无水印 mp4。命令行参数可以临时覆盖配置比如python run.py -c config.yml -u 链接 -t 8-u追加链接、-t调并发不用改文件。但要直说自 2026-09-14 起单视频/图文的直连接口已被风控拦截这条路径在 CLI 里大概率失败。这一节留给你了解配置方式——风控策略一旦松动它是最先恢复的路径当前以单条下载为主建议直接用桌面版 Douzy。把博主主页变成本地档案库这一节解决如何把一个博主的主页抓全并且重跑不产生重复文件。这是抖音批量下载里最重、也最值钱的用法link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50 # 只抓 50 条作品0 不限 increase: post: true # 重跑时跳过已下载的作品 database: true # 去重依赖数据库记录跑完后该博主的作品会按作者名/post/归档。重跑判断是数据库记录 本地文件双重检查只删文件会触发重下只删库记录则跳过两者都清才会从零来。想重下某一条删掉对应文件夹再用 sqlite3 删掉库中记录命令见 README.zh-CN.md 的重新下载一节。注意post、like、mix、music四种模式可以混写跨模式按 aweme_id 自动去重collect/collectmix自己账号的收藏必须单独使用不能和前面四种混写且相关接口 2026-08 起已被风控拦截收藏类内容目前更适合用桌面版处理。翻页被风控截断是这个场景最常见的坑保持browser_fallback.enabled: true、headless: false浏览器弹窗出现后手动过一遍验证码别急着关窗口也可以用start_time/end_time按YYYY-MM-DD分段抓取绕过单次翻页上限。把整场直播存成 FLV 文件这一节解决不开录屏软件如何把一整场直播留下来。直播接口webcast在可直连名单里但官方标注 experimental极端场景可能有兼容问题重要场次建议同时人工备份一份。直播间链接直接填进linklink: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 录到主播下播录制的 FLV 存在Downloaded/作者名/live/下附带一份*_room.json房间元数据快照。录满时长、主播下播或你手动 CtrlC 时已录下的字节都会保留.tmp文件自动提升为正式文件不会白跑。行为对照改哪个字段会发生什么这张表只列你真的会去动的项其余保持默认即可。改动的字段会发生什么什么时候调number.post等每种模式的数量上限0 不限测试阶段设 15跑通后放开到 0databaseincrease重跑自动跳过已下载内容长期存档保持开启这是去重双保险thread并发下载数从 5 起步稳定后再提到 8retry_times失败重试次数按 1s/2s/5s 退避给 3配合限速应对网络抖动video_quality默认取最高转码档original额外探测原画追求最高画质且能接受每条多一次探测请求start_time/end_time按发布时间过滤YYYY-MM-DD翻页被风控截断时用来分段抓browser_fallback.headlessfalse时弹窗可手动过验证码主页翻页被截断时必开下载还有 Content-Length 完整性校验半截文件会自动清理重试这点不用操心。出问题先查这张表这张表收的是 4 类高频故障按现象对号入座。现象可能原因处理办法单视频/图文请求 403提示 Blocked by Argus风控门禁切断 CLI 直连2026-09-14 起不是配置问题以 README 为准单条下载改用桌面版 Douzy主页只抓到 20 条左右翻页触发风控browser_fallback保持开启、headless: false弹窗里手动过验证码或用start_time/end_time分段突然大面积失败Cookie 过期重跑python -m tools.cookie_fetcher --config config.yml更新登录态硬盘堆出重复文件没开去重和增量database: trueincrease: true重跑即按本地文件跳过进度输出很吵日志未静默progress.quiet_logs: true排查时临时加-v或--show-warnings桌面版 Douzy 基于同一套后端目前处于内测期。它用内置登录窗口代发请求上面第一行的风控拦截对它不适用粘贴链接即可开始支持关注同步、收藏夹同步与任务中心。任务中心可以直接重试失败项并打开输出目录长任务跑完后收尾很省事收藏与喜欢界面可同步当前账号的收藏合集并整批下载正是 CLI 收藏接口被拦截期间的替代方案开始前的五个省心事先用单条链接或热搜导出验证 Cookie 和网络再上主页批量测试阶段把number.post设成 15跑通后再放开到 0。database和increase保持常开删了文件就预期会重下这不是 bug。并发从 5 起步网络稳定再提到 8。一上来拉满容易触发风控反而比慢一点更慢。登录态失效是常态把它当成定期维护项而不是故障大面积失败时重跑一次 cookie_fetcher 即可。不同任务分配置config_test.yml、config_daily.yml别共用一份长任务加上notifications推 Bark / Telegram / Webhook跑完手机就能收到。本项目仅供技术学习与个人数据管理使用请合法合规使用尊重内容版权与创作者权益。【免费下载链接】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），仅供参考