抖音批量下载实战指南：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 都能做到：抖音批量下载全靠它，贴链接、配好登录态，无水印视频、图文、合集和音乐会成批落到本地磁盘。

⏱ 最短路径：抖音无水印下载，从装好到第一条视频落盘

四小步，全程在终端里完成。

克隆代码并安装依赖

Python 3.8+ 即可，macOS、Linux、Windows 都支持，终端没有红色报错就算通过：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt

Cookie 登录态怎么配

Cookie 是证明你"已登录"的凭证，没配好大部分内容都打不开。别手动复制，用 tools/ 目录里的自动抓取脚本：

cp config.example.yml config.yml pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml

浏览器会弹出让你扫码登录，登录后回到终端按 Enter，Cookie 就自动写进配置文件了。如果弹出浏览器后卡住，先确认上一条playwright install chromium是否执行成功。

跑第一条抖音无水印下载，产物落在哪

把一条视频链接填进 config.yml 的link（字段含义可对照 config.example.yml），然后：

python run.py -c config.yml

跑完打开Downloaded/目录：里面是以作者名命名的文件夹，其中是按日期和标题命名的无水印 mp4。想顺带存封面或原声，把cover/music改为true；要原画质就设video_quality: original，它会探测上传原片，失败时退回最高转码档。以后想下什么，改链接重跑即可。

注意：2026 年 9 月起抖音风控封禁了部分接口直连，单条下载失败时先看最后一节的"被 403 拦"。

抖音批量下载的大招：主页、直播与热搜

单条是入口，批量才是重点。图文笔记（/note/xxx链接）同样支持，图片会按顺序归档。顺带一提：项目还有一套基于同一后端的桌面客户端 Douzy（内测中），本节截图来自它，功能可作参考。

抖音主页备份：博主作品怎么一次归档

你想做的：把某位博主的作品和合集收进本地，数量可控。主页链接填进link，mode勾选要抓的类型，number给每种模式设上限（0表示不限）：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - mix number: post: 50 mix: 20

产物按Downloaded/{作者}/post/和Downloaded/{作者}/mix/分层归档，同一个作品跨模式不会重复下载。顺手把comments.enabled设为true，每个作品旁会多出一份_comments.json，抖音评论采集一次到位。

容易踩的坑：收藏夹模式collect/collectmix只能单独使用，不能和上面四种混写；主页能抓多少条受翻页限制，只出 20 条左右时去看最后一节。

抖音直播录制时长怎么设：录一整场

你想做的：不开录屏软件，把直播间完整录下来。直播间链接直接填link，max_duration_seconds控制上限，0就是录到主播下播：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 = 录到主播下播

产物是 FLV（可直接播放的视频文件）加一份*_room.json房间信息，放在Downloaded/{作者}/live/下；下播、超时或你按 Ctrl+C，已录的字节都会保留。

容易踩的坑：这个接口官方标注为实验性，重要场次建议同时人工备份一份。

抖音热搜与关键词搜索结果导出：只收数据不下文件

你想做的：拿一份热搜榜单或关键词作品的快照，留待二次筛选。两条命令就够：

python run.py --hot-board 30 -p ./Downloaded python run.py --search "猫咪" --search-max 100 -p ./Downloaded

产物分别是Downloaded/hot_board/和Downloaded/search/下的 JSONL 文件（每行一条 JSON 记录），pandas 或 jq 都能直接处理。

容易踩的坑：这一步只导出元数据，不会生成视频文件，别去输出目录里找 mp4。

长任务不翻车：遇到什么问题改哪个配置

批量任务跑一晚上，最怕中途崩掉白跑，或者硬盘堆出重复文件。不用背配置，记住几种情况各改哪里：

• 重复文件越堆越多：开database: true，把每次下载写进 SQLite（内置的小型数据库文件），再配合increase增量开关，本地已有的媒体直接跳过。判断靠"数据库记录 + 本地文件"双重检查：只删库不会触发重下，两者都清了才会重新下载。
• 网络抖动、偶发失败：retry_times: 3，内置 1s/2s/5s 退避，不会留下缺口；下载还有文件大小完整性校验，不完整文件会自动清理重试。
• 速度慢：thread从 5 起步，网络稳定再提到 8，一上来拉满容易触发风控，反而更慢。
• 想重下某条被跳过的作品：把本地对应文件夹和库里记录一起清掉再跑，具体 sqlite3 命令见 README.zh-CN.md 的"重新下载"一节。

想让长任务有可视化追踪，桌面版 Douzy 的任务中心可按完成/失败筛选、一键打开输出目录、对失败项重试：

🛟 卡住了先看这里

问题：主页只抓到 20 条左右？ 处理：翻页触发风控了。确认browser_fallback.enabled: true且headless: false，浏览器弹窗出现后手动过完验证码再关；也可以用start_time/end_time按日期分段抓。

问题：突然大面积失败？ 处理：Cookie 过期了。重跑python -m tools.cookie_fetcher --config config.yml更新登录态。过期是常态，把它当周期性维护，而不是故障。

问题：单条下载被 403 拦？ 处理：抖音对新开的部分接口启用了风控门禁，CLI 直连不再放行。保持浏览器兜底开启，让浏览器代读页面自己的请求；或用桌面版 Douzy（它经内置登录窗口代发请求）完成下载。

问题：已下载过的条目想重新下？ 处理：去重同时看"库里记录 + 本地文件"，只删库不够。把该条目的本地文件夹和数据库记录都删掉再跑，参考 README.zh-CN.md。

问题：进度输出太吵？ 处理：确认progress.quiet_logs: true；排查问题时临时加-v看详细日志。

今天就可以先拿一条视频链接跑python run.py -c config.yml，确认Downloaded/下出现无水印 mp4，再把link换成主页链接开始归档。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