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想把某个创作者的作品整套存下来时在 App 里逐条另存、再手动处理水印几十条作品就要折腾很久。douyin-downloader 是一个免费开源的抖音下载器贴一条链接就能直接下载视频、图文、合集或原声把作者主页链接交给它它会自动翻页、批量下载并自带进度展示、失败重试和 SQLite 去重。能力与边界先弄清它下什么能力说明单条下载视频/video/{id}、图文/note/{id}、合集/collection/{id}、原声/music/{id}v.douyin.com短链也能识别主页批量下载/user/{sec_uid}链接配合mode选 post作品/like点赞/mix合集/music原声跨模式自动去重当前账号收藏夹collect/collectmix仅支持 Cookie 对应的登录账号且必须单独使用直播录制live.douyin.com/{room_id}录制 FLV主播下播时已录数据保留实验性不覆盖的场景不支持付费内容和其他平台浏览器兜底目前只对 post 模式完整验证过快速上手从克隆到首次跑通准备 Python 3.8 环境然后获取项目并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如果需要浏览器兜底或自动获取 Cookie再补装 Playwrightpip install playwright python -m playwright install chromium复制示例配置文件到本地新文件后再修改cp config.example.yml config.yml抖音要求登录状态所以下一步获取 Cookie。推荐自动方式python -m tools.cookie_fetcher --config config.yml按提示在浏览器登录抖音回到终端按 EnterCookie 会自动写入config.yml。Cookie 等同于账号凭证只放在自己的目录里不要外传或提交到任何仓库。编辑config.yml最小配置长这样这里用一个主页链接、只取 20 条作品同时保存原声和 JSON 元数据link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 20 thread: 5 retry_times: 3 video: true music: true json: true database: true运行python run.py -c config.yml跑完后文件按Downloaded/{作者}/post/{日期}_{标题}_{id}/的层级存放同名目录下会带上视频、封面、_music.mp3和_data.json。除了命令行项目还基于同一套后端提供了内测中的桌面客户端 Douzy下面是它的工作台截图功能拆解围绕链接类型组织主页批量下载mode 与 number 怎么配mode支持 post / like / mix / music 四种分别对应作品、点赞、合集、原声可以写多个同一个aweme_id跨模式不会重复下载。每种模式各配一个数量上限写在number.*里0 表示不限量mode: - post - music number: post: 50 music: 0只想收集背景音乐时把mode单独设为music即可它优先取原声直链文件缺失时回退到使用该音乐的首条作品。增量下载与去重第二次运行只拉新作品database: true会启用 SQLite 记录下载历史和去重increase.*则基于磁盘检查某作品的主媒体文件已存在且非空就跳过文件被删掉则重新下载。所以定期把某个创作者的新作品拉下来只需把increase.post设为true之后反复执行同一条命令不用维护任何名单。浏览器兜底翻页被限时的后手主页翻页被风控限制时通常停在 20 条左右工具可以自动拉起浏览器继续滚动并支持人工过验证码browser_fallback: enabled: true headless: false注意该能力只对 post 模式做过完整验证like / mix / music 主要依赖 API 正常翻页。配置速查高频字段一张表字段作用建议值mode下载模式collect/collectmix仅登录账号可用且单独使用postnumber.*各模式数量上限0 为不限先 20~50 试跑thread并发下载数3~5retry_times失败重试次数指数退避 1s/2s/5s3increase.*增量下载跳过磁盘上已存在的作品truestart_time/end_time时间过滤格式YYYY-MM-DD空为不限video_quality画质original / highest / lowest 或指定分辨率highestdatabase启用 SQLite 去重与历史记录truebrowser_fallback.enabled翻页受限时启用浏览器兜底trueproxyHTTP/HTTPS 代理无需求留空故障排查下载不顺先查这四处只存到 20 条左右可能原因主页翻页触发风控。 处理动作确认browser_fallback.enabled: true且headless: false弹窗出现后手动完成验证别急着关窗口。全部下载失败或请求被拒可能原因Cookie 过期。 处理动作重新执行python -m tools.cookie_fetcher --config config.yml拿到新 Cookie 后妥善保管不要外传。重新运行却什么都不下载可能原因去重生效本地文件与数据库都判定为已下载。 处理动作确需重下时删除Downloaded/下对应文件并清理数据库记录或把对应模式的increase设为false会在当前筛选范围内强制重下并覆盖。下载慢或频繁中断可能原因并发过高触发限流默认速率 2 请求/秒或网络不稳定。 处理动作先把thread降到 3网络环境差时配置proxy切换通道。下一步拉取新版在你的项目目录里执行git pull完整字段与输出目录结构见 README.zh-CN.md翻页、去重与重试的实现位于 core/想改行为前先读这里按最小配置先跑通一条主页链接再逐步加 mode 和增量开关是这个工具最省时间的用法。【免费下载链接】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），仅供参考