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 是一款免费开源的抖音批量下载工具：丢给它一条链接，它把无水印视频、图文和原声音乐存到本地，下载记录写进本地数据库，重跑不重复。对普通用户来说，这意味着不用打开任何付费站点，就能整批保存一位作者的作品。
什么场景下会需要抖音批量下载工具
它面向的是关注了几个创作者、想把对方作品在本地留一份的人。一条条手动保存，视频底部带着水印；在线解析站一次只能解一条，链接还得交给陌生服务器；录屏又自带黑边和画质压缩。这类「批量 + 无水印 + 存进自己硬盘」的需求，douyin-downloader 一次接住。
从零跑通第一条无水印下载
工具是 Python 命令行程序，需要 Python 3.9 及以上，Windows、macOS、Linux 都能跑。整个环境准备就一块命令：
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 chromium后两行装的是登录流程和风控兜底会用到的浏览器。
抖音内容需要登录态。先把模板配置复制成可编辑的config.yml（Windows PowerShell 里用Copy-Item config.example.yml config.yml），再跑一次登录命令：
cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml会弹出一个浏览器，用手机抖音扫码登录，回终端按 Enter，Cookie 就自动写进config.yml，之后基本不用管。
配置只保留这几行，把link换成目标作者的主页地址：
link: - https://www.douyin.com/user/XXXXXXXX path: ./Downloaded/ mode: [post] number: post: 3 # 先试 3 条，0 表示不限量运行python run.py -c config.yml，进度条会实时刷新每个作品的状态。跑完后文件落在Downloaded/里，每个作品一个文件夹，命名自带发布日期和标题；默认只存视频本体，封面、原声、元数据 JSON 用cover/music/json开关按需打开。
无水印直链、自动挑画质、增量去重：五个实用功能
| 功能 | 你得到的好处 |
|---|---|
| 无水印直链 | 直接取平台的无水印地址，不是二次转码版，文件底部没有水印 |
| 自动挑画质 | 同一作品多档码率时默认选最高档，video_quality: original可再尝试原片 |
| 批量并发下载 | 默认 5 线程并行（thread: 5），进度条实时刷新，失败自动重试 |
| 增量去重 | increase默认开启且记录写本地 SQLite，换条链接重跑只补新作品，不费流量 |
| 风控兜底 | 翻页被限流时弹出浏览器让你过验证，登录态失效会自动引导重新登录再试 |
同一套内容类型开关（post/like/mix/music）在项目的 Douzy 桌面版里被做成了可视化选项，可以勾选并给每种类型单独设数量上限：
🔧 抖音批量下载报错或停住：常见症状速查
| 症状 | 处理办法 |
|---|---|
| 反复提示「请先登录 / Cookie 无效」 | 重新扫码更新 Cookie，再确认config.yml里cookies字段不是空值 |
| 批量任务中途停住、进度不动 | 多半是风控验证码：在弹出的浏览器里完成验证后任务会自行继续；确实卡死就 Ctrl+C 退出，已完成文件保留，重跑时数据库自动跳过、从断点继续 |
| 没下过的作品却显示「跳过」 | 该作品已登记在本地下载数据库（之前用别的链接下过同一视频），去重跳过属正常行为；要强制重下就把increase.post设为false |
| 主页只获取到少量作品 | 保持browser_fallback.enabled: true且headless: false，在浏览器中手动完成验证；当前风控仍可能限制 |
想排查细节时，加-v打开详细日志即可，例如python run.py -c config.yml -v。
⚠️ 使用前的合规与风控提醒
- 工具定位是学习与个人数据管理，只保存自己有权保留的内容，别拿它做商业搬运或侵权传播；许可条款见 LICENSE。
- 平台风控有波动：严格时期部分接口会受限，主页作品可尝试浏览器兜底但不保证成功，卡住时反复重启进程只会更糟。
- 时间过滤（
start_time/end_time）、评论采集、直播录制、完成通知、REST API 服务等都是进阶项，现成模板在 config.example.yml 里直接改。 - 更多参数与常用配置说明见 README.zh-CN.md。
【免费下载链接】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），仅供参考
到O(n))
