douyin-downloader 抖音批量下载实操指南50 条作品一次跑完配置、风控与去重全讲清【免费下载链接】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归档一个抖音博主的 200 条作品手动路线是逐条打开、保存、重命名耗时以小时计。douyin-downloader 把这件事压缩成一条命令Python 实现的抖音批量下载工具MIT 协议Python 3.9粘贴主页链接后自动抓取作品列表并发下载无水印视频可附存封面、音乐、头像和原始 JSON并用本地 SQLite 数据库加文件名双重去重。它适合个人收藏归档、素材收集和内容分析三类用户。本文以批量下载某位博主最近 50 条作品为主线从安装讲到跑完顺带讲清风控应对和它做不到的事。能力总览哪些抖音内容能落到本地先给一张清单看你要的东西在不在范围内内容类型交给它的方式关键配置单个视频 / 图文link写作品链接v.douyin.com短链自动解析—主页全部作品link写主页链接mode: [post]点赞作品同上mode: [like]合集主页或合集链接mode: [mix]音乐原声同上mode: [music]收藏夹 / 收藏合集同上仅登录账号生效需单独使用mode: [collect]/[collectmix]直播录制直播间链接实验性功能命令行侧还能导出数据而不是媒体python run.py --hot-board 30和python run.py --search 关键词 --search-max 50会把热搜榜和搜索结果写成 JSONL直接进分析流程。同一个后端还衍生了桌面客户端 Douzy内测中粘贴链接即开始下载任务中心里看进度、重试失败项。清单之外先说结论CLI 只支持抖音国内版其余平台要走 Douzy。下面从装环境开始。安装与 Cookie 获取唯一需要碰浏览器的环节要求 Python 3.9Windows、macOS、Linux 均可。克隆仓库并装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt登录态是最关键的一步但不用手动从浏览器复制。项目自带获取脚本cookie_fetcherpip install playwright python -m playwright install chromium cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml会弹出一个浏览器窗口正常登录抖音回到终端按 EnterCookie 就写进config.yml了。playwright 依赖同时服务于后文的浏览器兜底翻页建议一并装上。批量下载博主作品config.yml 里改三处把 config.example.yml 复制成config.yml后只需关注这几行link: - https://www.douyin.com/user/YOUR_SEC_UID mode: [post] number: post: 50 # 0 表示全量 increase: post: true # 跳过已下载作品运行python run.py -c config.yml文件落在path指定的目录默认./Downloaded/结构如下Downloaded/ ├── download_manifest.jsonl └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 2024-02-07_作品标题_aweme_id.mp4 └── ..._data.json三个命名细节值得留意日期前缀取作品发布时间create_time而非下载时间按目录名排序就是按发布时间排序文件名尾部带aweme_id两条作品不会重名覆盖默认命名模板是{date}_{title}_{id}可在filename_template中改但必须保留{id}。Downloaded/根目录还有一份 append-only 的download_manifest.jsonl每个作品追加一行含date、tags、file_paths等字段想建索引直接读它。同后端逻辑在 Douzy 桌面版里长这样选中内容类型、填数量上限、提交任务右侧任务中心看进度。时间范围筛选只捞 2024 年的作品配置里加两行日期YYYY-MM-DD含结束日期当天start_time: 2024-01-01 end_time: 2024-12-31配合increase.post: true就是标准的增量姿势每周跑一次只拉新发布、未下载过的作品不用全量重拉。需要强制重下时把increase.post设为false即可覆盖当前筛选范围内的文件不必删数据库。可选产物封面、音乐、评论、原始 JSON默认只下视频本体其余产物按需打开。在config.yml中把music、cover、avatar、json设为true对应的_music.mp3、_cover.jpg、_avatar.jpg、_data.json会存进与视频同一目录video_quality默认highest最高转码档改original会多一次探测请求去尝试上传原片失败自动回退。想连数据一起采打开评论开关comments: enabled: true include_replies: true max_comments: 0 # 0 表示不限每个作品额外生成一份*_comments.json含二级回复。转写transcript、完成通知notifications也是同风格的可选开关完整字段都在 config.example.yml 里。稳定性机制默认值已经替你调好上百条作品时逐条手动下和并发自动下的耗时差距是几倍量级差别来自这几个默认值thread: 55 个作品并发可用-t覆盖、限速默认 2 请求/秒单条失败按 1s、2s、5s 退避自动重试 3 次retry_handler下载完成后用 Content-Length 核对文件大小不完整的文件会被清掉重下配合redownload_missing_files: true的默认行为你不需要翻找 0 字节坏文件。去重则是SQLite 记录 文件名 aweme_id双重判断默认database: true库文件为dy_downloader.db同一任务跑第二遍基本整批跳过这个任务可以放心挂着当定期任务。默认值讲完了接下来是跑不顺时的两件事风控和常见问题。风控与常见问题的处理先说必须知道的现状README 原文立场抖音接口风控目前会拦截 CLI 下载单个视频/图文、合集、音乐、点赞和收藏主页作品可尝试 Playwright 浏览器兜底但不保证成功。所以遇到只抓到 20 条左右就停多半是翻页被风控保持browser_fallback.enabled: true且headless: false两者默认如此弹出浏览器窗口时手动完成验证别急着关。其余三件小事Cookie 失效、请求频繁失败重跑一次python -m tools.cookie_fetcher --config config.yml两分钟解决速度不满意先把thread降到 2-3其次换非高峰时段用了代理先确认代理本身稳定想排查就加-v看详细日志平时quiet_logs: true默认已静默进度刷屏。边界CLI 不做什么明确不支持的CLI 直接下载其他平台那是 Douzy 内测中工作台的事浏览器兜底目前只完整支持post模式like/mix/music主要依赖接口分页正常直播录制属实验功能HLS 源保存的是播放列表而非可直接播放的视频。合规上项目声明用途限于技术研究、学习交流与个人数据管理——下载他人作品二次发布、采集隐私内容、绕过限制做商业用途都不合适平台接口变动导致功能失效也属正常技术风险。跑通首单只需三步克隆仓库并装依赖运行python -m tools.cookie_fetcher --config config.yml完成登录把主页链接和mode: [post]写进config.yml然后python run.py -c config.yml。剩下的事交给 5 个并发和自动重试。【免费下载链接】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），仅供参考