当前位置：首页 > news >正文

3分钟学会抖音视频批量下载：douyin-downloader 完整上手指南

news 2026/8/14 22:44:50

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 是一款开源的抖音批量下载工具，支持视频、图文、合集、音乐及作者主页批量下载，去水印、自动去重、浏览器兜底，3 分钟即可完成首次下载。

傍晚六点，同事站在我身后，盯着满屏的浏览器标签页问："这个博主的 80 条视频，你打算一条条存到几点？"我算了一笔账：打开链接、等播放、右键另存、再手动去水印，单条视频要两分多钟，80 条就是三个小时起步，中途还躲不过重复下载、文件命名混乱这些坑。

后来我找到了一款开源工具，上面的问题一条命令全部解决。它就是douyin-downloader：一个专业的抖音批量下载工具，支持单个视频、图文、合集、音乐（原声）下载，也能一键拉取作者主页的全部作品；默认带实时进度条、失败自动重试、SQLite 去重，接口被限流时还会自动切换到浏览器兜底。接下来的内容，就是一篇"照着做就能跑通"的完整指南。

⚡ 三分钟快速上手：先跑通一次再说

最快的上手方式，是先让工具跑起来，再慢慢研究高级玩法。四步走：

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

前三步是标准的安装流程；第四步是把示例配置复制成自己的配置文件。接着获取 Cookie（只需一次）：

python -m tools.cookie_fetcher --config config.yml

它会自动打开浏览器，你登录抖音后回到终端按一下回车，Cookie 就被写进配置了——不用再去开发者工具里翻来翻去。然后把config.yml里的链接换成你想下载的内容：

link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ thread: 5 database: true

这段配置的意思是：下载这条视频到./Downloaded/，用 5 个并发线程，并开启 SQLite 去重记录。最后运行：

python run.py -c config.yml

看到进度条一条条走完，你的第一条无水印视频就躺在本地了。整个过程不超过3 分钟，成就感立刻拉满。

问题来了：一个博主几百条作品，怎么一次拉完？

单条下载只是开胃菜，这个工具真正厉害的是作者主页批量下载。以前你需要逐条打开、逐条保存，现在只需把链接换成博主主页，再声明模式：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like number: post: 0 # 0 表示不限数量，全量下载

mode支持四种主流模式：post（全部作品）、like（点赞过的）、mix（合集）、music（音乐原声），可以一次写多个。number用来限流：写0就是全量，写50就只取最新的 50 条。下载时还会按作品标题自动创建子目录，一个视频一个文件夹，找起来一目了然。

下载下来的视频总是带水印？这取决于源选择

很多在线解析工具靠"二次转码"去水印，画质损失肉眼可见。douyin-downloader 的思路完全不同：它直接解析官方接口，优先挑选无水印的视频源，并在video.bit_rate数组中自动匹配最高码率的那一档，视频和实况图都适用。也就是说，你拿到的是尽量接近原片的画质，而不是被压缩过的残次品。

顺带一提，它下载的不止是视频本体，还有封面图、原声音乐、作者头像，以及一份完整的 JSON 元数据（标题、点赞数、评论数、发布时间都有）。一个作品对应一个文件夹，等于把整个"数字资产"都归档了。

重复下载、磁盘爆满，谁来把关？

批量下载最怕两件事：重复拉取浪费流量，和历史记录无处可查。douyin-downloader 用双重去重解决：一是 SQLite 数据库（默认生成dy_downloader.db）记录所有下载历史；二是扫描本地文件名中的作品 ID 做二次判断。就算你今天跑post、明天跑like，同一作品也只下载一次。

更实用的是增量模式，适合长期跟踪某位博主：

increase: post: true database: true # 增量模式依赖数据库记录

开启后，每次运行只会拉取上次之后发布的新作品，配合定时任务就能实现"每天自动追更"。

翻到第 20 条就停了？这多半是风控，不是网络问题

作者主页批量下载时，如果你发现作品列表翻到 20 条左右就断掉，先别急着怀疑网络——这是抖音翻页风控的典型表现。工具内置的浏览器兜底策略就是为此准备的：

browser_fallback: enabled: true headless: false # 非无头模式，方便人工验证 max_scrolls: 240

开启后，当 API 分页受限，工具会自动启动浏览器模拟翻页；遇到验证码时窗口会弹出，你手动完成验证即可继续，不要急着关窗口。这也是它能保持高成功率的关键设计。

想要的从来不止是视频本身

除了下载，这个工具还能做不少"顺手的活"：

评论采集：对每个作品抓取评论（可含二级回复），输出独立的*_comments.json，做舆情分析很方便；
热搜榜与搜索：python run.py --hot-board 30拉取热搜榜，python run.py --search "关键词" --search-max 100按关键词搜索，结果导出 JSONL，配合数据分析正合适；
直播录制：填入live.douyin.com的房间链接，可录制 FLV 直播流，主播下播自动保留已录数据；
视频转写：接入 OpenAI Transcriptions API，下载后自动生成.txt和.json文字稿，适合做内容检索。

💡 进阶锦囊：5 个老手才用的配置

这些配置不在默认教程里，但用对了能明显提升体验：

自定义命名模板。默认是{date}_{title}_{id}，你也可以按需调整，比如{date}_{author}_{title}_{id}，并把作者目录改成author_dir: "nickname_uid"，直观且不重名。
直播定时录制。live.max_duration_seconds: 3600表示最多录1 小时，设成0则是录到主播下播。
下载完成通知。配置notifications，支持 Bark、Telegram、企业微信/飞书 Webhook，批量任务跑完自动推送到手机。
REST API 模式。pip install fastapi uvicorn后运行python run.py --serve --serve-port 8000，即可用 HTTP 接口提交下载任务，方便集成进自己的系统。
命令行直接追加参数。不一定要改配置，python run.py -c config.yml -u "视频链接" -t 8 -p ./Downloaded就能临时调整链接、并发和目录。