一份配置搞定抖音批量下载与内容管理：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-downloader你刷到一位博主每一条视频都值得收藏。你开始截图、录屏、点收藏三个月后再想找某条视频翻遍相册和稍后再看却一无所获——更别提你还想要无水印原片、背景音乐和高清封面。这种时候你会意识到手动保存从一开始就是一场低效的持久战而douyin-downloader正是为结束这场持久战而生的抖音批量下载与内容管理工具丢进一条链接视频、图文、合集、音乐都能去水印保存丢进一位作者的主页链接它能把作品、点赞、合集、原声一锅端。如果你只是偶尔存一两个视频它可能有点大材小用但如果你追更的博主超过一只手或者你想攒一个自己的素材库、研究某个领域的内容趋势——这篇文章正好为你写。它既是命令行工具也附带一个基于同一套后端的可视化桌面客户端Douzy内测中你可以先感受一下它的界面项目的桌面客户端界面粘贴链接即可选择内容类型开始批量下载三分钟跑通你的第一次下载 ⏱️先别管那些花哨功能我们把最小链路走通。前提只有一个电脑上装好了 Python 3.8。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml然后是认证。抖音的很多接口需要登录态项目内置了自动获取 Cookie 的工具它会引导你完成登录python -m tools.cookie_fetcher --config config.yml # 在弹出的浏览器里登录抖音回到终端按 Enter配置自动写入接着把 config.yml 精简成下面这样只需要改链接link: - https://www.douyin.com/video/7604129988555574538 # 换成你想下载的视频链接 path: ./Downloaded/ music: true # 顺带保存原声 cover: true # 顺带保存封面 folderstyle: true # 每个作品一个独立文件夹最后运行python run.py -c config.yml看到滚动起来的多条进度条和下载完成统计你的第一次下载就成功了。整个过程和命令行里的实时进度展示长这样命令行模式下的批量下载进度展示每个任务独立进度条换个角度盘点它到底替你省了什么 功能清单容易看得眼花我们换个角度——按它替你省下的东西来算账。帮你省时间作者主页一键批量丢一条/user/{sec_uid}链接mode里写上post、like、mix、music作品、点赞、合集、原声一次抓全不用逐条复制链接。增量追更打开increase: { post: true }下次运行只下载新增内容跑一次等于自动盯梢。短链自动解析v.douyin.com/...这类分享短链直接认连裸 host 也能解析。帮你省空间双重去重SQLite 数据库记录 本地文件扫描同一部作品无论来自哪个模式都不会重复下载磁盘不白烧。整洁的文件组织默认按作者名/作品模式/日期_标题_ID/归档一个作品一个文件夹视频、封面、音乐、元数据各归其位下载完成后自动按日期和标题归档的文件夹结构命名模板完全自定义{id} {title} {author} {date} {type}等变量随意组合只要保证带{id}就不会重名覆盖。帮你涨效率并发下载thread默认 5网络好可以拉高一般用户不用动。失败自动重试指数退避1s、2s、5s加上下载完整性校验——文件不完整会自动清理重来不会留一堆坏文件。进度可视化Rich 进度条随时掌握状态quiet_logs: true还能在批量场景下少刷屏。帮你降风险浏览器兜底API 翻页被风控时自动启动浏览器模拟滚动甚至给你弹出窗口手动过验证码的机会。代理与通知可配proxy走代理下载完成后推送到 Bark / Telegram / Webhook跑批任务不用干瞪眼守着。文件命名和作者目录怎么摆在设置里一目了然设置界面中的作者目录与文件命名模板满足个性化整理需求一个普通人的实战剧本从追更到调研 光看能力没感觉我们跟着一位叫阿澈的普通用户走一遍。阿澈是内容运营每天要看大量同行的作品。第一幕把对标账号变成资料库。他在 config.yml 里写下对标账号的主页链接开了增量link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 对标账号主页 mode: - post - mix number: post: 100 mix: 0 # 0 表示不限量 increase: post: true # 只下新增 mix: true配一个定时任务每周跑一次竞品的内容库就自动滚动更新了。第二幕做一次选题调研。阿澈想知道某个方向的评论区都在聊什么于是加了两段配置comments: enabled: true include_replies: false max_comments: 500 # 0 不限 transcript: enabled: true # 视频语音转写 model: gpt-4o-mini-transcribe每部作品旁会多出*_comments.json和转写文本配合命令行搜索功能把一批视频的文案和评论一次性导出来分析python run.py --search 猫咪 --search-max 100 -p ./Downloaded # 结果落到 ./Downloaded/search/猫咪_时间戳.jsonl第三幕把喜欢的都存下来。最后是私心环节——他把自己账号收藏夹里的作品全量归档link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect number: collect: 0三部曲走完阿澈手里有了一套会自己长大的竞品库、几份调研报告以及自己私藏的精华合集。任务跑起来时进度是实时可见的实时下载进度与逐任务事件日志随时知道卡在哪一步能力边界它擅长什么不擅长什么 ⚖️实话实说的工具更值得信赖。它擅长单条视频/图文/合集/音乐下载、作者主页四模式批量、收藏夹归档、直播录制、评论采集、热搜榜快照、关键词搜索、REST API 服务以及上面提到的去重、增量、兜底、通知这一整套工程化能力。它也有明确的边界使用前请知悉浏览器兜底目前只在post模式下做过完整验证like/mix/music主要依赖 API 正常分页collect/collectmix只支持当前登录的 Cookie 对应账号且必须单独使用不能和post等模式混用增量下载暂不支持收藏夹模式直播录制若走 HLS 源只保存 playlist 文件需要自己用 ffmpeg 做后处理FLV 源则可以直接播放抖音的接口策略随时可能调整遇到风控或失效属于正常技术风险。想要更稳可以这样调把thread从 5 降到 3 降低请求密度retry_times适当加大换取数据完整性如果频繁触发翻页风控务必保持browser_fallback.headless: false弹窗出现时手动完成验证再继续。避坑清单遇到问题先对号入座 与其列问题 1/2/3不如给你一套判断思路只抓到 20 条就停了多半是翻页被风控。确认browser_fallback.enabled: true且headless: false弹窗出现后手动过验证码别急着关窗口。日志里全是跳过已存在这是双重去重机制在工作不是故障。真想重下就删掉对应作品目录、并清掉数据库里那条记录sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id...;。突然所有请求都失败大概率是 Cookie 失效。重新跑一次python -m tools.cookie_fetcher --config config.yml即可。文件被覆盖或重名检查filename_template是否包含{id}这是避免冲突的最低要求。转写文件没生成转写只对视频生效图文不转再确认transcript.enabled、API Key 和response_formats是否齐全。直播只存了 playlist这是 HLS 源用 ffmpeg 转一下就能得到可播放文件。延伸玩法让下载器自己跑起来 工具的价值在于能托管。这几个玩法值得一试定时任务 增量 自动追更0 2 * * * cd /path/to/douyin-downloader/douyin-downloader python run.py -c config.ymlREST API 服务适合接到自己的自动化流程里pip install fastapi uvicorn python run.py --serve --serve-port 8000 # POST /api/v1/download {url: ...} → {job_id, status} # GET /api/v1/jobs/{job_id} 查询任务状态热搜榜快照python run.py --hot-board 30一键把当天热搜落成 JSONL做趋势观察很方便。下载历史也能在作品档案里按作者、关键词筛选还能顺手管理已下载的内容作品档案功能基于 SQLite 历史记录做筛选与回溯Docker 部署项目自带 Dockerfiledocker build后挂载配置与下载目录即可适合常驻服务器。想深入折腾源码下面这些路径值得翻一翻配置模板在 config.example.ymlCLI 入口在 cli/main.py下载主流程在 core/去重与数据库逻辑在 storage/database.pyCookie 管理在 auth/浏览器兜底与各模式策略在 core/user_modes/。写在最后从一次下载开始 建议你今晚就做三件小事克隆项目用单条链接完成第一次下载然后试着把一位经常看的作者主页丢进去体验一次批量最后把increase打开看看它下周会不会自动帮你追更。小贴士快问快答Q需要很懂技术吗A不需要。改配置就是复制粘贴命令就那两三条。Q下载会不会被发现或封号A工具内置了限速和重试机制但请保持合理频率勿用于侵犯他人权益的场景。Q桌面版和命令行版有什么区别A同一套后端桌面版Douzy更直观内测中命令行版功能完整、适合跑批和自动化。最后也是最重要的一句提醒请合理使用这类工具。它适用于个人学习、研究和数据备份请尊重内容创作者的劳动成果不要用于商业用途或任何侵权场景。合规使用工具才能长久陪着你。现在打开终端从第一条链接开始建一座属于自己的抖音内容档案馆吧。【免费下载链接】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），仅供参考