抖音视频下载终极指南：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 开发的命令行工具，底层拆成两层：外层是面向用户的下载入口（DouYinCommand.py/downloader.py），内层是模块化的apiproxy核心库，包含请求、去重、限速、重试、策略切换等组件。这种分层设计让它在"功能丰富"和"稳定可靠"之间找到了很好的平衡。

我把它的核心能力整理成一张表，看完你就知道它值不值得折腾：

划重点：它最打动人的不是"能下载"，而是"下载得聪明"——自动去重、自动重试、自动选最高清源，这些细节让批量任务可以放心丢给它跑。

五分钟跑通：装环境、配 Cookie、下载第一条视频

第一步：安装依赖

要求 Python 3.8+，然后拉取代码并安装依赖：

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

如果你后面要用浏览器兜底或自动获取 Cookie，再补一条：

pip install playwright python -m playwright install chromium

第二步：配置 Cookie（最关键的步骤）

Cookie 是访问抖音服务器的"通行证"，没有它工具无法正常工作。好在项目提供了自动获取脚本：

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

运行后会自动打开浏览器，你登录一次抖音，回到终端按回车，Cookie 就会自动写进配置文件，全程傻瓜式。

踩坑提醒①：不要直接复制浏览器地址栏里的 Cookie 串去填，容易漏掉关键字段。优先用项目自带的cookie_fetcher；手动粘贴时，格式必须是msToken=xxx; ttwid=yyy; odin_tt=zzz; ...这种用分号分隔的完整字符串。

第三步：下载你的第一条视频

复制配置模板，然后在config.yml里填上链接：

link: - https://v.douyin.com/你的分享链接/ path: ./Downloaded/

运行命令：

python run.py -c config.yml

稍等片刻，视频就会以日期_标题命名的文件夹形式出现在Downloaded/目录下，视频、封面、音乐、元数据 JSON 一应俱全。

命令行模式同样支持，一条命令搞定：

python run.py -u "https://www.douyin.com/video/7604129988555574538" -t 8 -p ./Downloaded

玩出花样：把整个创作者主页搬回家

单个下载只是开胃菜，douyin-downloader 真正的重头戏是批量下载作者主页。想备份某位博主全部作品？把链接换成他的主页地址就行：

link: - https://www.douyin.com/user/这里是作者的sec_uid mode: - post # 发布的作品 - like # 点赞的作品 - mix # 合集 - music # 用过的原声 number: post: 50 # 只下最近50个，填0表示全量

同时开多个模式也没问题，工具会自动跨模式去重——同一个视频在"发布"和"原声"里都出现时，只下载一次。

小贴士：想长期跟踪某个博主的新作品？开启增量模式，它会把下载记录存进 SQLite 数据库，下次运行只抓新增的：

increase: post: true database: true

配合定时任务（比如 crontab 或 Windows 计划任务），就能实现"每天自动备份最新作品"的全托管流程。

下载后的文件会自动组织成清晰的目录结构，按"作者 → 模式 → 单作品文件夹"层层归档，找东西非常方便：

进阶玩法：直播、评论、热搜，一个工具全包

批量下载之外，douyin-downloader 还有几个容易被忽略但很实用的能力。

录制直播：遇到正在直播的优质内容，把直播间链接丢给它，它会先提取直播间标题、在线人数等信息，让你选择清晰度，再生成 FLV/HLS 流地址进行录制。主播下播时已录制的部分会自动保留：

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

采集评论：做内容研究或竞品分析时，可以按作品抓取评论（含二级回复），输出为*_comments.json，方便后续统计。

拉热搜榜、按关键词搜索：想快速了解当下热点，或围绕某个主题做选题？

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

结果会以 JSONL 格式导出，直接就能喂给数据分析流程。

避坑指南：这 4 个问题 90% 的人都会遇到

1. 只能抓到 20 条作品怎么办？

这是典型的翻页风控。打开browser_fallback兜底，让工具在 API 翻页受限时自动拉起浏览器：

browser_fallback: enabled: true headless: false # 必须为 false，才能看到验证码弹窗

踩坑提醒②：浏览器弹窗出现后，一定要手动完成验证再等它继续跑，不要一看到窗口就关掉，否则永远只能抓到前 20 条。

2. 为什么删了数据库记录，文件还是不重新下载？

因为它是"数据库 + 本地文件"双重去重——本地文件名里带有 aweme_id，只要文件还在就会被跳过。想强制重下，两个都得清：

rm -rf Downloaded/作者名/post/*_<aweme_id>/ sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '<aweme_id>';"

3. Cookie 失效、下载报错怎么办？

抖音的 Cookie 有效期不长，失效后重新跑一次python -m tools.cookie_fetcher --config config.yml即可。另外，首次安装后如果没装brotli库，可能遇到"响应为空"的怪问题，工具默认已把accept-encoding降级为 gzip/deflate 来规避，遇到异常时先确认依赖装全。

4. 进度条疯狂刷屏？

默认配置已开启progress.quiet_logs: true静默模式，正常使用不刷屏；调试时才建议临时加-v或--show-warnings查看详细日志。

最后一步：把它变成你的日常工具

到这里，你已经能用 douyin-downloader 完成从单视频保存到主页批量备份、再到直播录制的全部操作了。送你一张速查表，收藏起来随时查：

下一步行动建议：

1. 先跑通"安装 → 配 Cookie → 下载一条视频"的完整流程，确认环境没问题；
2. 挑一个你最喜欢的创作者，配置批量 + 增量模式，体验"全自动备份"；
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