抖音批量下载:把创作者主页无水印视频一次存到本地
【免费下载链接】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 是一个命令行抖音批量下载工具:给它一个创作者主页链接,它会把主页上的作品逐个拉下来,存成无水印 mp4,封面和元数据 JSON 也能一起落盘,文件夹按作者自动分好。
🚀 快速跑通抖音批量下载
把下面五条命令依次敲进终端:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml- 第一行把项目克隆到本地,第二行进项目目录
- 第三行装 Python 依赖,需要 Python 3.8 及以上
- 第四行把示例配置复制成要用的
config.yml - 第五行会弹出浏览器引导你登录抖音,登录完回到终端按回车,Cookie 就写进
config.yml了,之后可以长期用。工具靠这份登录态去拉作品列表,所以这一步别跳过
如果终端提示缺浏览器组件,先跑pip install playwright和python -m playwright install chromium,再回到第五行。
Cookie 就位后,跑下载:
python run.py -c config.yml终端里每个作品一条进度条,能看到速度和剩余数量;示例配置只下 1 条作品,跑完后去./Downloaded/里找作者名的文件夹,第一个 mp4 已经在里面了。
项目还带一个同后端的桌面版 Douzy,不习惯终端的话,可以贴链接直接开始,它的链接入口界面:
核心能力速览
| 能力 | 怎么触发 | 适合谁 |
|---|---|---|
| 主页作品批量下载 | link填创作者user/...链接,mode选post | 成套收集某创作者的作品 |
| 无水印高画质 | 默认挑无水印源,video_quality调画质 | 二次创作、长期存档 |
| 喜欢列表 / 合集 / 原声 | mode加like、mix、music | 研究创作者口味、建音乐素材库 |
| 直播录制 | link指向live.douyin.com房间链接,live控制时长 | 给直播留档 |
| 评论与元数据 | comments.enabled: true或json: true | 做数据分析 |
底下有几处值得一提:接口被风控拦下时,它会自动弹出一个可见的浏览器继续翻页,滑块可以手动过;用 SQLite 下载历史加本地文件双检查去重,已下过的作品直接跳过;每个文件下完会校验大小,不完整的文件自动清掉,重跑也不会有半截文件。
桌面版里的任务中心则是这个样子:每批下载任务的成功失败、作品数量一目了然,点"打开目录"直接落到本地下载位置:
📁 一条主线走完全流程:无水印批量下载实操
目标:把某创作者近半年的作品,连同封面和元数据,全部落到本地。
把config.yml改成这样:
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [post] number: post: 0 start_time: "2026-03-01" cover: true json: truepost: 0表示不限条数,start_time圈定时间下界,cover和json把封面、元数据 JSON 打开。然后还是跑python run.py -c config.yml,终端会依次刷过几十条作品的进度条,结束时打印一份统计。打开./Downloaded/,每个作品一个"日期_标题_作品id"命名的文件夹,里面有 mp4、封面 jpg 和data.json。
把同一条命令再跑一遍:已下载的作品会被逐个跳过,不产生重复文件——这就是增量下载,后面定期更新素材库靠的就是它。
如果你要换一种情况,比如下载一个合集或单个视频,把link换成合集/视频链接就行,其余流程不变。
配置项速查
| 配置键 | 作用 | 推荐值 |
|---|---|---|
link | 下载链接列表,每行一个,支持主页/合集/单个视频 | 按任务填 |
mode | 主页拉什么:post 作品 / like 喜欢 / mix 合集 / music 原声 | [post] |
number.post | 每次最多下多少条,0 为不限 | 0 |
start_time/end_time | 只下这个时间区间内的作品 | YYYY-MM-DD格式 |
path | 保存目录 | ./Downloaded/ |
thread | 并发下载数 | 5 |
video_quality | 画质:highest / original / 指定分辨率如1080p | highest |
cover/json/music | 是否连带保存封面 / 元数据 / 原声 | 按需 |
卡住了怎么办
- 作品停在 20 条左右就不动了——多半是分页被风控拦了。先试:确认
browser_fallback.enabled: true且headless: false,在弹出的浏览器里手动过一遍滑块,别提前关窗。还不行就等风控缓一重跑,已下的作品会跳过,不亏。 - 整批失败或列表拉不出来——最常见是 Cookie 过期。先试:重跑
python -m tools.cookie_fetcher --config config.yml重新登录获取。还不行,确认这个账号本身能正常刷主页,再看proxy是否指向了失效的代理。 - 速度不稳、有半截文件——把
thread降到 3 以下,retry_times保持默认 3,失败会指数退避自动重试。想每天自动更新素材库的话,Linux 加一条 cron、Windows 用任务计划程序即可。
另外说明:2026 年 9 月起平台对部分接口加了风控,喜欢列表、合集、音乐、单个视频这几类命令行可能拉不动,主页作品要依赖浏览器兜底,具体以 README 的 Current Limitations 一节为准。
接下来可以去看
- README:完整参数表、常见问题和当前平台限制说明都在这
- config.example.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),仅供参考