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 是一个命令行下载工具把抖音单条视频、图集、音乐原声以及整个创作者主页批量拉到本地自动挑选无水印源并带有并发进度条、SQLite 去重与失败重试。它能完成下完一个主页这类可以反复执行的任务而不只是保存眼前这一条。适用边界先说清楚直播录制属于实验性功能收藏夹采集模式collect / collectmix只对当前登录的账号生效且必须单独配置不能与 post、like、mix、music 混用。前置检查Python 环境与登录态安装依赖需要 Python 3.9 以上版本依赖很少装完即可运行git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt看到 Successfully installed 字样就表示环境就绪。获取登录态 Cookie批量任务能不能稳定翻页关键在 Cookie 这组凭据上。它是抖音用来识别请求身份与登录状态的字段失效后请求会被限流或者只返回很少的作品。自动获取先装 Playwright再运行抓取工具。它会弹出一个浏览器窗口你在窗口里登录抖音回到终端按回车Cookie 会直接写进配置文件的cookies块pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml手动获取在浏览器里登录抖音从开发者工具复制 Cookie粘贴到config.yml的cookies字段即可。自动抓取与 Cookie 的管理逻辑都在 tools/cookie_fetcher.py 和 auth/ 里想看实现可以直接翻源码。最小可运行路径从配置到下载完成复制一份示例配置只改几个字段cp config.example.yml config.ymlconfig.yml里最关键的是这几项link: - https://www.douyin.com/user/MS4wLjAB... path: ./Downloaded/ mode: - post # post 作品 / like 点赞 / mix 合集 / music 音乐 number: post: 0 # 0 表示全部也可以写 50 只取前 50 条 thread: 5 database: true cookies: ttwid: YOUR_TTWIDlink是主页链接mode决定采集什么number控制数量上限thread是并发线程数。运行入口是run.pypython run.py -c config.yml运行后程序先给出作品总数再按线程数逐条下载进度条实时刷新已经下过的作品直接标记跳过。结尾汇总成功、失败与跳过数量失败项可以从日志里单独拎出来重跑。下载完成后目录按Downloaded/作者名/post/日期_标题_aweme_id/组织视频、封面、原声与 JSON 元数据都放在同一个作品文件夹里。只想留视频本体的话把music、cover都设为 false目录会干净很多。画质默认取最高转码档想探测上传原片可以把video_quality改为original。常用增强按任务改配置多主页批量归档把多个主页链接都写进link列表一次运行遍历全部创作者link: - https://www.douyin.com/user/MS4wLjAB...A - https://www.douyin.com/user/MS4wLjAB...B number: post: 0每个创作者各自一个目录互不干扰。mode也可以同时列出post、like、mix、music同一作品跨模式不会重复下载。让新发布的作品自动补下持续跟踪固定创作者的素材库把增量开关打开increase: post: true database: true跳过与否以磁盘上主文件是否存在为准SQLite 数据库负责记录下载历史方便回查进度。把这份配置挂进 crontab 定期执行每次只会补下新发布的作品旧文件保持不动。获取直播间流并录制link里填直播间地址即可触发录制link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 表示录到主播下播FLV 文件与*_room.json房间元数据会保存在Downloaded/{作者}/live/下主播下播、断流或手动停止时已录到的分片会合并保留。注意 HLS 源目前只保存播放列表想要可播放文件需要再交给 ffmpeg 处理一次。故障定位现象—原因—处理大量请求报错、提示未登录。最常见原因是 Cookie 过期。重新运行python -m tools.cookie_fetcher --config config.yml或手动更新cookies块再重跑任务。批量任务只拉到 20 条左右就停了。这是翻页被风控截断的典型表现。确认browser_fallback.enabled为 true 且headless为 false程序会弹出真实浏览器窗口在窗口里手动完成验证后继续采集验证期间别提前关窗。批量任务频繁中断。多半是触发限流。把thread降到 3 左右保持retry_times: 3自动重试高峰时段并发请求更容易被拦改到凌晨或清晨执行会更稳。想让某个作品重新下载。需要同时清理本地文件和数据库记录rm -rf Downloaded/作者名/post/*_aweme_id/ sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;只删文件会触发补下只删数据库记录则会跳过两者要一起处理。延伸资料使用说明README.md、README.zh-CN.md带注释的配置样例字段含义以此为准config.example.yml架构说明PROJECT_SUMMARY.md核心下载器core/配置加载逻辑config/config_loader.py按时间范围提前停止的设计文档docs/superpowers/specs/【免费下载链接】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），仅供参考