douyin-downloader 完整指南：抖音无水印批量下载、直播回放与增量去重

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 是开源的抖音无水印批量下载工具：贴一条链接，它就把源文件解析出来存到本地，重跑还会自动跳过已保存的内容。

先把结果跑出来

一条命令跑起来

配置完成后，跑这一行就会在./Downloaded/里按作者、日期分好文件夹存下视频：

python run.py -c config.yml

临时追加链接用-u "链接"，并发数用-t控制，全部参数看python run.py --help。

环境准备

需要 Python 3.9+，支持 Windows、macOS、Linux。克隆仓库并安装依赖，浏览器兜底与取 Cookie 依赖 Playwright，最后两行要一起装：

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

配置登录 Cookie

把示例配置复制一份，再运行取 Cookie 的工具。它会弹出浏览器，登录抖音后回到终端按 Enter，Cookie 就写进了config.yml：

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

它到底能做什么

• 直播回放下载：解析回放链接取最高清视频流与音频流，用 ffmpeg 合并成单个.mp4。
• 无水印批量下载：覆盖单个作品、图文、合集、音乐（原声）。
• 增量去重：SQLite 记录下载历史，磁盘已有文件自动跳过，重跑只补新内容。
• 灵活过滤：按start_time/end_time时间窗与number数量限定，缺文件可补下。
• 进度与容错：实时进度条、失败自动重试、限速控制并发。

需要说明：命令行版受抖音接口风控影响，单条视频、合集、音乐、点赞/收藏的下载可能被拦截，日常下载更推荐同作者的 Douzy 桌面版。

幕后是怎么实现的

回放下载分三步走：先用 core/url_parser.py 从链接提取回放 ID 与房间号；再带登录态向接口查回放播放信息，从候选码流里挑出分辨率最高的视频流和对应音频流；最后分轨下载、用 ffmpeg 合并成单个.mp4，核心逻辑在 core/live_replay_downloader.py。整个过程像一位档案管理员，先查到档案编号，再直接取走原件，不用手动拼请求。

两到三个进阶玩法

批量收藏主播主页并增量去重

把主播主页链接写进配置的link，mode设为[post]，increase.post: true保持增量。每次运行只补新发布的作品，跑上几次就攒下该主播的完整本地档案，数量上限由number.post控制，0表示不限。

用时间窗口只下特定时段

只想存某段时间的内容，就在配置里填start_time和end_time（格式YYYY-MM-DD，含结束当天）。比如把范围设成一个月，就只会下载该月内发布的作品与回放，不占旧内容的空间。

⏰ 定时任务自动归档新回放

把python run.py -c config.yml写进系统定时任务（cron 或任务计划程序），每天固定时间自动跑。增量去重保证每天只收新出现的回放，不用手动盯着。

同一套操作在 Douzy 桌面版里有图形界面：贴链接、勾选内容类型、设数量上限，直接提交任务即可，还能切到 TikTok、YouTube 等平台。

出问题时怎么自查

下载失败，或主页作品只抓到几条？保持browser_fallback.enabled: true和headless: false，在浏览器里自行完成验证。若仍是风控拦截接口，刷新 Cookie 或反复重试都解决不了，日常下载改用 Douzy 桌面版。

提示"回放信息未找到"？说明该回放已过期或被删除，回放受平台时效限制，过期无法找回。直播结束后尽快抓取，别等太久。

下载速度怎么调？用-t提高并发数；单条回放速度主要受网络与平台码率限制。加-v输出详细日志，便于定位卡点。

Cookie 失效，登录态报错？重跑python -m tools.cookie_fetcher --config config.yml刷新登录态。仍失败就检查config.yml里cookies段的msToken、ttwid是否完整。

使用边界

• 仅用于个人学习与个人存档，勿二次传播或商用。
• 尊重主播版权，下载内容不重新上传。
• 遵守抖音平台协议与相关法律法规。
• 并发保持克制，thread别拉太高，不给平台服务器添负担。

回放是时效的，而档案是长留的。

【免费下载链接】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