一次搞懂抖音批量下载：从主页归档到直播录制的完整避坑指南

一次搞懂抖音批量下载从主页归档到直播录制的完整避坑指南【免费下载链接】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 是一个 Python 命令行工具专门做抖音批量下载给它一个主页、合集或直播间链接它就并发抓取、自动挑无水印的高码率源并把每件作品写进本地 SQLite 数据库一种零配置的轻量数据库文件下次运行自动跳过已下载的内容。它适合谁解决什么问题目标用户典型痛点本项目怎么接住短视频创作者竞品主页更新快手动截图截视频根本追不上mode: post整主页批量归档按「作者/日期_标题_作品ID」自动建目录每次只补新作品课程运营一场直播两小时录屏软件吃不住回放又随时下架直播间链接写入配置即录制存档下播自动落盘 flv一种直播流封装格式 房间元数据快照数据分析师舆情分析缺原始料评论区数据拿不到comments开关让每个作品旁多出一份评论 JSON--search/--hot-board把搜索结果、热搜榜写成 JSONL逐行 JSON 数据文件同一个后端还有桌面端 Douzy内测中两者分工不同按需挑形态定位入口CLI本仓库主页批量、直播录制、评论与搜索数据采集python run.py桌面版 Douzy单条作品下载、可视化任务管理项目 Releases 页获取一次装好跑起来整条链路按顺序走完即可每步都交代了你会看到什么、该做什么。① 拉代码装依赖。克隆仓库后安装依赖顺带把浏览器兜底用的 Playwright 组件装上git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt pip install playwright python -m playwright install chromiumPython 3.9 以上即可。② 复制配置并登录拿 Cookie。这一步是新手最常卡住的地方先单独拎出来⚠️ 没有有效 Cookie 时作品列表往往翻到 20 条就停。别手动去浏览器里拷字符串直接用自带脚本扫码cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml会弹出 Chromium 窗口扫码登录抖音后回到终端按 EnterCookie 自动写回 config.yml。之后失效就重跑这条命令。③ 填链接、起任务。把 config.yml 里的link换成目标主页然后python run.py -c config.yml终端会显示 Rich 进度条。不想改文件也可以临时追链接-u加链接、-t调并发、-p指定下载目录例如python run.py -u https://www.douyin.com/user/xxx -t 5 -p ./Downloaded。完整走一遍整站主页归档以「把某博主主页的 50 条作品搬进本地素材库」为例配置里只需要这几行link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50 increase: post: true # 已下载的作品直接跳过执行python run.py -c config.yml跑完后本地目录长这样Downloaded/ └── 作者名/ └── post/ └── 2026-09-01_作品标题_aweme_id/ ├── video.mp4 # 无水印、自动挑最高码率 ├── cover.* # 封面config 中 cover: true 时 ├── music.mp3 # 原声music: true 时 └── data.json # 点赞数、发布时间等json: true 时aweme_id 是每件作品的唯一编号目录名里带上它天然避免重名覆盖。increase.post: true意味着这套流程可以常驻今天跑 50 条下周再跑只捞新增作品——去重靠 SQLite 下载记录加本地文件名里的 aweme_id 双重比对。如果 API 翻页中途被风控截断比如只出 20 条工具会自动拉起一个浏览器窗口你在窗口里手动完成一次验证就能继续别急着关。再补几行配置还能扩展什么主页归档只是默认路径以下能力都藏在 config.yml 对应开关里直播存档link指向live.douyin.com/{room_id}时自动录制live.max_duration_seconds: 0表示录到主播下播产物是 flv 加*_room.json快照。评论落盘comments.enabled: truemax_comments限量每个作品旁生成*_comments.json。热搜与搜索python run.py --hot-board 30或python run.py --search 关键词 --search-max 100结果写进search/下的 jsonl 文件。日期筛选start_time/end_time限定YYYY-MM-DD范围只下区间内的作品。常见问题自查现象可能原因一行修复作品只抓到 20 条就停API 翻页被风控截断确认browser_fallback.enabled: true窗口弹出后手动过验证单条视频/合集/音乐链接报 403Blocked by ArgusSecurityPlugin平台接口加了风控门禁非浏览器请求被拒主页作品走 post 模式 浏览器兜底单条改用桌面版 Douzy删了本地文件重跑仍跳过该作品数据库里记录还在去重照常生效sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_idid;列表抓空、下载全失败config.yml 中 Cookie 过期重跑python -m tools.cookie_fetcher --config config.yml想排查卡在哪一步默认日志太安静python run.py -c config.yml -v开详细日志深入一点参数与代码入口调优集中在四个地方thread默认 5并发下载数家庭网络 5~8 比较稳再高容易撞限流、retry_times默认 3 次失败按 1s/2s/5s 递增间隔重试、proxy填代理后 API 与媒体流都会走它、path与folderstyle根目录与三级归档结构关闭folderstyle可拍平。内部请求还有 2 请求/秒的限流降低触发风控的概率。下载历史全部存在dy_downloader.db可用 sqlite3 直接查询。想改代码的话入口都很明确链接解析短链、主页、直播间core/url_parser.py下载模式策略目录post / like / mix / music 各一个策略类新增模式加一个并注册即可core/user_modes/Cookie 生命周期管理auth/cookie_manager.pyREST 服务--serve --serve-port 8000起服务POST/api/v1/download提交任务server/app.py画质挑选逻辑bit_rate 多档中按目标选 play_addrcore/downloader_base.py一句话总结把主页链接扔进 config.yml剩下的选源、去重、重试、归档都交给它。现在就去把想留存的那个主页填进配置跑第一次python run.py -c config.yml你的素材库从下一条新视频开始自动增长。【免费下载链接】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），仅供参考