一条命令搞定抖音无水印下载：3 步跑通、4 个场景批量备份、1 张速查表收藏-平芜编程栈

一条命令搞定抖音无水印下载：3 步跑通、4 个场景批量备份、1 张速查表收藏

【免费下载链接】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 的路子完全不同——它不走网页操作，直接调用抖音接口拿无水印源，把解析、下载、去重、重试串成一条流水线。架构上 API 和浏览器是双策略，一个通道受阻会自动切到另一个，成功率比单通道方案稳得多。

一张表看清差异：

方案	画质	批量能力	费用	隐私风险	附加能力
在线解析站	中	差	部分免费	高	几乎没有
手机/电脑录屏	低	差	免费	低	无
浏览器插件	中	一般	部分	中	单一
douyin-downloader	无水印、自动挑最高码率	强，主页/合集/音乐整包	完全免费开源	低，本地运行	直播录制、评论采集、热搜导出、完成通知

看最后一列就明白了，它干的活远不止"下载"两个字。下面花三分钟把它跑起来。

二、首次跑通：3 步下出第一条无水印视频

第 1 步：克隆仓库并安装依赖

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

它做了什么：把源码拉下来，装齐全部第三方依赖，通常一两分钟。注意项目里有个同名子目录，真正的 V2 版工具在里面。

第 2 步：一键自动获取 Cookie

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

它做了什么：复制一份可改的配置模板，然后自动弹出浏览器——你正常登录一次抖音，回终端按回车，Cookie 就自动写进config.yml，全程不用手抄一串乱码。这是唯一的"硬门槛"，过一次基本就不用管了。

第 3 步：填链接，跑起来

link: - https://www.douyin.com/video/7604129988555574538

python run.py -c config.yml

它做了什么：按配置开始下载，终端实时显示进度条，完成后自动汇总成功数和用时。成品默认落在Downloaded/目录，按"作者 → 作品类型 → 日期_标题"三层归档，还顺带存了封面和元数据 JSON。

三、四个场景实战：从单条视频到直播录制

场景 1：备份某博主的全部作品

追更的博主哪天删号你受不了？把link换成主页链接，number设 0 表示不限数量：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0

它做了什么：遍历该博主的所有发布作品逐个下载，视频、图集通吃，post写 0 就是不限量全量抓取。跑完整个主页就是一份本地档案。

场景 2：只下新增内容，怎么配

全量备份过之后，第二次运行肯定不想重下。开增量模式：

increase: post: true database: true

它做了什么：工具用本地 SQLite 数据库比对历史记录，只下载上次之后的新作品。database: true是增量模式的前提，两个条件缺一不可。以后每周追更，成本几乎为零。

场景 3：把收藏夹搬回家

刷到过、点过赞的内容，平台一改推荐算法就可能找不回来。本地化它：

link: - https://www.douyin.com/user/self?showTab=favorite_collection mode: - collect number: collect: 0

它做了什么：拉取当前登录账号收藏夹里的全部内容。记住一条铁律：collect只能单独使用，不能和post、like等模式混排，想同时下两种就分两次运行。

场景 4：录制直播，下播自动收工

主播正开直播？直接录，连下播都帮你盯住：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0

它做了什么：解析直播流地址并录制，0表示一直录到主播下播。中途断流或你手动 Ctrl+C，已经录下的字节都会完整保留，不会白录。录好的 FLV 会存进Downloaded/{作者}/live/下。

四、新手卡住的 4 个问题，问完就通

Q1：翻页好像被限制了，只抓到二十条左右作品？

八成是 API 翻页触发了风控。开启浏览器兜底，让真浏览器替你滚动加载：

browser_fallback: enabled: true headless: false

它做了什么：API 翻页受限时自动弹出浏览器继续抓取，遇到验证码手动过一下即可。headless记得保持false，有界面的浏览器才方便你人工介入。

Q2：Cookie 失效了，下载突然大面积报错？

别手抄 Cookie 续命，直接重跑一次自动获取：

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

它做了什么：重新登录一次，把新鲜 Cookie 写回配置，三十秒解决。

Q3：想重新下载某个视频，为什么总被"跳过"？

工具是"数据库记录 + 本地文件"双重去重，只删一边没用。两边都清：

sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '<aweme_id>';"

它做了什么：删掉该作品的数据库记录。再手动删掉本地同名文件夹，下次运行就会重新下载。

Q4：进度条疯狂刷日志，屏幕看花了？

配置里加一行就安静：

progress: quiet_logs: true

它做了什么：关掉冗余日志，只保留关键进度信息，批量任务跑起来不刷屏。

五、进阶一句话 + 速查表，收藏这篇就够了

还有几个能力点到为止，用到的时候翻配置注释就能找到：comments.enabled: true可给每个作品附带评论 JSON；--hot-board 30和--search "关键词"两条命令能把热搜榜和搜索结果导出成 JSONL 做数据分析；--serve起一个 REST 服务，提交 URL 异步排队下载；notifications配 Bark / Telegram / Webhook，批量任务跑完手机直接收到推送。完全不想碰终端的，项目还有配套桌面客户端 Douzy，粘贴链接就能下。

功能	命令 / 配置	一句话说明
单视频下载	`link: 视频链接`	自动去水印、挑最高清源
主页全量备份	`mode: post`+`number.post: 0`	不限数量下完整个主页
增量追更	`increase.post: true`+`database: true`	只下新增内容
收藏下载	`mode: collect`	本地化你的收藏夹（须单独用）
合集 / 音乐	`/collection/`、`/music/`链接	整包拉取，音乐优先原声
直播录制	`live.douyin.com/xxx`+`live.*`	下播自动保留已录数据
热搜 / 搜索	`--hot-board N`/`--search 词`	结果导出 JSONL
Cookie 刷新	`python -m tools.cookie_fetcher`	一键自动获取
REST 服务	`python run.py --serve`	服务化集成