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 去重与浏览器兜底适合长期存档个人内容。一、先说结论它到底替你省掉哪些事挑源不用动手无水印源与最高码率档自动挑选短链自动解析你只负责粘链接。去重是常驻的不是每次跑才想起来SQLite 历史记录 本地文件双重检查下次运行自动跳过已下内容硬盘不堆重复文件。挂了也不白跑失败自动指数退避重试残文件自动清理重下直播已录下的字节照样保留。被风控卡住有退路主页翻页被截断时内置浏览器兜底自动启动弹窗里可以手动过验证码。顺手还能收数据热搜榜与关键词搜索结果直接落成 JSONLpandas、jq 二次筛选即用。二、第一关先拿下登录态 Cookie——为什么它是命门、怎么自动抓很多人卡住的第一步不是装环境而是登录态抖音大量内容只对登录用户开放Cookie 没配好请求基本都会失败。所以这一关放在最前面。登录态怎么自动抓先装上浏览器驱动再运行项目自带的 Cookie 抓取脚本pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml浏览器弹出后扫码登录回终端按 EnterCookie 会自动写进配置文件全程不用手动复制字符串。✅过关标志终端提示抓取完成config.yml的cookies区块已填上真实值msToken、ttwid、odin_tt 等。卡住或大面积失败怎么办浏览器弹出后卡住先确认python -m playwright install chromium是否执行成功。后面下载突然大面积失败多半是 Cookie 过期重跑python -m tools.cookie_fetcher --config config.yml刷新登录态即可。心态上把 Cookie 失效当周期性维护项而不是故障。三、第二关十分钟跑通第一条无水印视频把环境拉起来只需要 Python 3.8macOS / Linux / Windows 三平台通吃git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt终端无红色报错即环境就绪。配置怎么改拷一份每个字段都带中文注释的模板把link换成你想下的视频链接cp config.example.yml config.yml配置模板 里必填的只有三项link、path、cookies其余按需调整即可。首跑怎么启动python run.py -c config.yml不想动文件时命令行参数可以临时覆盖配置-u追加链接、-t调并发。python run.py -c config.yml -u https://www.douyin.com/video/760412345678901234567 -t 8成功的长什么样终端出现完成统计Downloaded/下多出一个以作者名命名的目录里面就是无水印 mp4如果同时开了music、cover、json原声、封面与元数据也会一并放进作品文件夹。想用图形界面的话桌面端 Douzy 基于同一套后端粘贴链接即下、任务中心跟进度内测阶段截图可作功能参考四、第三关从一条放大到一批按你想要什么挑路线。主页备份作品与合集一次跑完主页链接填进link在mode里勾选要抓的内容number给每种模式设上限0表示不限。post作品、like喜欢、mix合集、music音乐可以混着一次跑完跨模式自动去重link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - mix number: post: 50 # 只抓 50 条作品 mix: 20跑完后该博主的内容按作者/post/、作者/mix/分目录归档。收藏类collect/collectmix只能单独使用不能与上面四种模式混写link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect直播录制到主播下播直播间链接直接填进去程序自动拉流不用开录屏软件link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 录到主播下播录满时长、主播下播或你手动 CtrlC已录下的字节都会保留成 FLV 文件存在Downloaded/{作者}/live/下附带一份房间元数据 JSON。该接口官方标注为 experimental极端直播场景可能有兼容问题重要场次建议同时人工备份一份。热搜和关键词怎么导出只做数据收集、不下文件时两条命令搞定python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded结果分别落在Downloaded/hot_board/与Downloaded/search/下的 JSONL 文件里。顺手可开的侧挂评论与转写comments.enabled: true每条作品旁多一个*_comments.jsontranscript模块调用 OpenAI 接口把视频转写成 txt/json图文笔记不生成转写。五、第四关让它自己管去重、续跑、挂了能自愈长任务跑几十分钟最怕中途崩掉白跑或硬盘堆重复文件。把这组搭配记下来去重双保险database: true把每条下载记录写进 SQLite默认dy_downloader.dbincrease.post等按磁盘文件跳过已存在的媒体。判断逻辑是数据库记录 本地文件双重检查——只删库不清文件不会触发重下两者都清才会重新下载。重试兜底retry_times: 3配合内置 1s/2s/5s 指数退避与默认 2 请求/秒的限速网络抖动不会留下缺口下载还带 Content-Length 完整性校验残文件自动清理重试。并发循序渐进thread默认 5网络稳定再提到 8——一上来拉满容易触发风控反而比慢一点更慢。还有几个常调的旋钮start_time/end_time按YYYY-MM-DD过滤发布时间适合分段抓取browser_fallback在翻页被风控截断时自动开浏览器headless: false时你可以手动过验证码video_quality默认highest选最高转码档改original会额外探测原画notifications开启后下载完成推 Bark / Telegram / Webhook适合挂机跑长任务。想重新下载某一条已被跳过的作品把本地文件夹与库中记录一起清掉再运行即可README.zh-CN.md 里给出了对应的 sqlite3 命令。六、卡住了先查这张表现象原因解法主页只抓到 20 条左右翻页触发风控确认browser_fallback.enabled: true且headless: false弹窗里手动过验证或用start_time/end_time分段抓突然大面积失败Cookie 过期重跑python -m tools.cookie_fetcher --config config.yml刷新登录态硬盘堆出重复文件没开数据库去重database: true配合increase走增量想重下某一条被去重机制跳过删本地对应文件夹 删库中记录再运行进度输出很吵日志未静默progress.quiet_logs: true排查时临时加-v或--show-warnings速度慢并发与重试偏保守thread提到 8、retry_times给 3逐步上调七、上线前检查单分步上手别跳过先用单条视频链接验证 Cookie 和网络再上主页批量测试阶段把number.post设成 15跑通后再放开到 0不同任务分配置config_test.yml、config_daily.yml别共用一份Cookie 失效是常态把它当周期性维护项而不是故障长任务加notifications推送跑完手机就能收到。本项目仅供技术学习与个人数据管理使用请在合法合规的前提下使用尊重内容版权与创作者权益。【免费下载链接】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），仅供参考
