3步跑通抖音批量下载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 就是冲着这两件事做的一个用 YAML 配置驱动的抖音批量下载工具单条视频、图集、合集、音乐、作者主页都能下默认 5 线程并发、指数退避重试、SQLite 记录去重翻页被风控时还能自动拉起浏览器兜底。它能覆盖哪些下载场景先把边界说清楚免得你拿到手发现差一块单条内容视频/video/{id}、图文/note/{id}、合集/collection/{id}、音乐/music/{id}都能直接粘贴下载v.douyin.com短链会自动解析主页批量/user/{sec_uid}链接配合mode: [post, like, mix, music]一次拉整个主页的发布作品、点赞、合集或音乐列表当前登录账号的收藏夹collect/collectmix也支持画质与附加资源默认无水印源 按video.bit_rate自动挑最高码率可选原画探测封面、音乐、头像、JSON 元数据按需开关工程化能力Rich 进度条、下载完整性校验Content-Length 比对残缺自动清理重试、速率限制默认 2 请求/秒、download_manifest.jsonl清单、可选评论采集与完成通知推送下面是桌面版与 CLI 同一套后端的链接下载工作台粘一个链接点下载即可开跑桌面版工作台粘贴视频、主页或合集链接即可开始批量下载3步拿到第一个下载结果装依赖并复制一份配置要求 Python 3.8克隆后装依赖再把示例配置复制成正式配置git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.ymlconfig.example.yml 里每个字段都有注释你只需要改link和path。扫码登录拿Cookie抖音接口需要 Cookie。先装上 playwright浏览器兜底也依赖它再跑自动获取脚本pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml脚本会弹出浏览器扫码登录后回终端按 EnterCookie 自动写入config.yml全程不用手动复制。粘贴链接跑起来在 config.yml 里填一个链接先下 10 条试试水link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 10 # ...其余字段保持默认python run.py -c config.yml跑完终端会显示每条作品的进度与整体统计文件落在Downloaded/作者名/post/日期_标题_aweme_id/下旁边还有一份download_manifest.jsonl记录本次任务。用法A把一位博主的全部作品搬回本地你遇到的情况关注了一个美食博主三年想把他全部视频存档手动点保存不现实。怎么配number置 0 表示不限量其余不用动link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0 # 0 全量 thread: 5跑完看到什么Downloaded/作者名/post/下按「作品发布日期_标题_aweme_id」逐条建目录每条含视频本体可选_cover.jpg、_music.mp3、_data.json。若中途翻页被风控卡住工具会按browser_fallback配置拉起浏览器你人工过一下验证码任务继续。桌面版里这类任务会以列表形式呈现状态与成功/失败计数任务中心每条批量下载任务的状态、成功与失败数一目了然用法B每周只抓新发布的增量作品你遇到的情况几个常关注的账号每周更新你只想把新东西拿下来不想重复下载几百条旧视频。怎么配增量靠数据库 本地文件双重判断跳过已下载内容关键就两行increase: post: true database: true # 增量依赖 dy_downloader.db 的记录跑完看到什么第二次起已存在的作品直接跳过只有新发布的会出现在进度条里。把它放进 crontab 每周跑一次就是一个无人值守的新作品同步器。注意一个反直觉的坑只删数据库不删文件不会触发重下工具会扫本地文件名里的 aweme_id 去重想强制重下某条文件记录和数据库记录要一起清下一节会讲。4个最值得动的配置项其余几十个字段保持默认即可真正影响体验的是这几个线程数默认5别贪多thread默认 5。配合内置的 2 请求/秒限速家庭宽带下 3-5 已经跑满瓶颈调到 8 以上收益有限反而更容易触发风控。网络不稳时先动retry_times默认 3 次退避 1s/2s/5s而不是加线程。去重数据库 本地文件双保险database: true时生成dy_downloader.db记录每条作品的作者、发布时间、保存路径。跳过判断是数据库记录 本地文件双重校验且跨模式去重——同一条 aweme 在post和mix里不会下载两遍。这也是增量模式的地基。画质与附加文件按需取舍video_quality默认highest只从转码档里挑最高想要原片设original代价是每条多一次探测请求。video/music/cover/avatar/json五个开关控制产物只留视频本体可以把磁盘占用砍到最低。时间窗口只下指定区间整理2025 年度精选这类需求用start_time/end_timeYYYY-MM-DD框住范围即可与number限制叠加生效工具会按作品发布时间过滤。卡住了看这里只抓到20条就停现象主页作品明明有几百条任务却只拿到第一页 20 条多半原因API 翻页被风控抖音直接掐断了后续分页怎么处理确认browser_fallback.enabled: true且headless: false弹窗出现后手动完成验证、别急着关窗口采集会接管继续Cookie 过期现象开始批量请求后大面积 403/登录失效单条也下不动多半原因抖音 Cookie 有效期通常只有 1-2 周怎么处理重跑python -m tools.cookie_fetcher --config config.yml重新扫码几秒搞定想强制重新下载某条作品却无效现象删了文件重跑工具却说已下载跳过多半原因去重是双重的只清文件不清数据库不会触发重下怎么处理两条一起清——rm -rf Downloaded/作者名/post/*_aweme_id/ sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;往深了走给下载器加一种新模式主页下载的各模式post/like/mix/music/collect都是策略模式实现的core/user_modes/ 下每种模式一个策略类继承BaseUserModeStrategy自己实现collect_items负责翻页采集落盘、去重、重试全部复用基类core/user_mode_registry.py 用注册表把mode字符串映射到策略类。想加一个下载某作者置顶作品之类的模式大致这样from core.user_modes.base_strategy import BaseUserModeStrategy from core.user_mode_registry import UserModeRegistry class PinnedUserModeStrategy(BaseUserModeStrategy): mode_name pinned api_method_name fetch_pinned_aweme # 对应 api_client 上的方法名 UserModeRegistry().register(pinned, PinnedUserModeStrategy)然后在config.yml里mode: [pinned]就能跑。想做成服务化接入自己的流程也可以直接python run.py --serve --serve-port 8000起 REST 模式POST /api/v1/download提交链接、GET /api/v1/jobs/{job_id}查进度。最后一句版本说明与提醒本文基于 2.0.0 版本编写抖音接口策略经常变动跑不动时先看上游更新下载内容请仅用于个人研究与数据管理尊重创作者版权与平台规则。【免费下载链接】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），仅供参考 3步跑通抖音批量下载：douyin-downloader
3步跑通抖音批量下载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 就是冲着这两件事做的一个用 YAML 配置驱动的抖音批量下载工具单条视频、图集、合集、音乐、作者主页都能下默认 5 线程并发、指数退避重试、SQLite 记录去重翻页被风控时还能自动拉起浏览器兜底。它能覆盖哪些下载场景先把边界说清楚免得你拿到手发现差一块单条内容视频/video/{id}、图文/note/{id}、合集/collection/{id}、音乐/music/{id}都能直接粘贴下载v.douyin.com短链会自动解析主页批量/user/{sec_uid}链接配合mode: [post, like, mix, music]一次拉整个主页的发布作品、点赞、合集或音乐列表当前登录账号的收藏夹collect/collectmix也支持画质与附加资源默认无水印源 按video.bit_rate自动挑最高码率可选原画探测封面、音乐、头像、JSON 元数据按需开关工程化能力Rich 进度条、下载完整性校验Content-Length 比对残缺自动清理重试、速率限制默认 2 请求/秒、download_manifest.jsonl清单、可选评论采集与完成通知推送下面是桌面版与 CLI 同一套后端的链接下载工作台粘一个链接点下载即可开跑桌面版工作台粘贴视频、主页或合集链接即可开始批量下载3步拿到第一个下载结果装依赖并复制一份配置要求 Python 3.8克隆后装依赖再把示例配置复制成正式配置git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.ymlconfig.example.yml 里每个字段都有注释你只需要改link和path。扫码登录拿Cookie抖音接口需要 Cookie。先装上 playwright浏览器兜底也依赖它再跑自动获取脚本pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml脚本会弹出浏览器扫码登录后回终端按 EnterCookie 自动写入config.yml全程不用手动复制。粘贴链接跑起来在 config.yml 里填一个链接先下 10 条试试水link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 10 # ...其余字段保持默认python run.py -c config.yml跑完终端会显示每条作品的进度与整体统计文件落在Downloaded/作者名/post/日期_标题_aweme_id/下旁边还有一份download_manifest.jsonl记录本次任务。用法A把一位博主的全部作品搬回本地你遇到的情况关注了一个美食博主三年想把他全部视频存档手动点保存不现实。怎么配number置 0 表示不限量其余不用动link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0 # 0 全量 thread: 5跑完看到什么Downloaded/作者名/post/下按「作品发布日期_标题_aweme_id」逐条建目录每条含视频本体可选_cover.jpg、_music.mp3、_data.json。若中途翻页被风控卡住工具会按browser_fallback配置拉起浏览器你人工过一下验证码任务继续。桌面版里这类任务会以列表形式呈现状态与成功/失败计数任务中心每条批量下载任务的状态、成功与失败数一目了然用法B每周只抓新发布的增量作品你遇到的情况几个常关注的账号每周更新你只想把新东西拿下来不想重复下载几百条旧视频。怎么配增量靠数据库 本地文件双重判断跳过已下载内容关键就两行increase: post: true database: true # 增量依赖 dy_downloader.db 的记录跑完看到什么第二次起已存在的作品直接跳过只有新发布的会出现在进度条里。把它放进 crontab 每周跑一次就是一个无人值守的新作品同步器。注意一个反直觉的坑只删数据库不删文件不会触发重下工具会扫本地文件名里的 aweme_id 去重想强制重下某条文件记录和数据库记录要一起清下一节会讲。4个最值得动的配置项其余几十个字段保持默认即可真正影响体验的是这几个线程数默认5别贪多thread默认 5。配合内置的 2 请求/秒限速家庭宽带下 3-5 已经跑满瓶颈调到 8 以上收益有限反而更容易触发风控。网络不稳时先动retry_times默认 3 次退避 1s/2s/5s而不是加线程。去重数据库 本地文件双保险database: true时生成dy_downloader.db记录每条作品的作者、发布时间、保存路径。跳过判断是数据库记录 本地文件双重校验且跨模式去重——同一条 aweme 在post和mix里不会下载两遍。这也是增量模式的地基。画质与附加文件按需取舍video_quality默认highest只从转码档里挑最高想要原片设original代价是每条多一次探测请求。video/music/cover/avatar/json五个开关控制产物只留视频本体可以把磁盘占用砍到最低。时间窗口只下指定区间整理2025 年度精选这类需求用start_time/end_timeYYYY-MM-DD框住范围即可与number限制叠加生效工具会按作品发布时间过滤。卡住了看这里只抓到20条就停现象主页作品明明有几百条任务却只拿到第一页 20 条多半原因API 翻页被风控抖音直接掐断了后续分页怎么处理确认browser_fallback.enabled: true且headless: false弹窗出现后手动完成验证、别急着关窗口采集会接管继续Cookie 过期现象开始批量请求后大面积 403/登录失效单条也下不动多半原因抖音 Cookie 有效期通常只有 1-2 周怎么处理重跑python -m tools.cookie_fetcher --config config.yml重新扫码几秒搞定想强制重新下载某条作品却无效现象删了文件重跑工具却说已下载跳过多半原因去重是双重的只清文件不清数据库不会触发重下怎么处理两条一起清——rm -rf Downloaded/作者名/post/*_aweme_id/ sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;往深了走给下载器加一种新模式主页下载的各模式post/like/mix/music/collect都是策略模式实现的core/user_modes/ 下每种模式一个策略类继承BaseUserModeStrategy自己实现collect_items负责翻页采集落盘、去重、重试全部复用基类core/user_mode_registry.py 用注册表把mode字符串映射到策略类。想加一个下载某作者置顶作品之类的模式大致这样from core.user_modes.base_strategy import BaseUserModeStrategy from core.user_mode_registry import UserModeRegistry class PinnedUserModeStrategy(BaseUserModeStrategy): mode_name pinned api_method_name fetch_pinned_aweme # 对应 api_client 上的方法名 UserModeRegistry().register(pinned, PinnedUserModeStrategy)然后在config.yml里mode: [pinned]就能跑。想做成服务化接入自己的流程也可以直接python run.py --serve --serve-port 8000起 REST 模式POST /api/v1/download提交链接、GET /api/v1/jobs/{job_id}查进度。最后一句版本说明与提醒本文基于 2.0.0 版本编写抖音接口策略经常变动跑不动时先看上游更新下载内容请仅用于个人研究与数据管理尊重创作者版权与平台规则。【免费下载链接】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），仅供参考