3 步跑通：用 douyin-downloader 把抖音视频无水印批量下载到本地-平芜编程栈

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

douyin-downloader 是一个开源的抖音批量下载工具：给它一条作品或主页链接，它自动选无水印源、挑最高画质、并发下载，并把文件按作者和作品分好类存到本地。下面按「克隆 → 配置 → 运行」的顺序走一遍，跟着做就能跑通。

手动存视频的三个麻烦

手机 App 里一条一条「分享 → 另存」，十几条作品就要耗掉大半天，还带着水印；文件散在相册里，想找哪一条只能靠翻；下载中途断了，已存的部分全得重来。这三件事，douyin-downloader 一次解决：一条链接丢进去，批量拉取、自动去重、按目录归档。

手动方式 vs 用它（核心能力对比）

你手动做	用它
逐条点「分享 → 另存」，量大就劝退	默认 5 路并发（`thread: 5`），一条主页链接批量拉取全部作品
存下来的视频带抖音水印	自动优先选无水印视频源，并在多个码率里挑最高的（码率越高画质越好）
文件散在手机相册，找不到	存成`Downloaded/作者名/作品类型/日期_标题_id/`结构，视频、封面、音乐、JSON 元数据一个文件夹放齐
断网重下，重复劳动	SQLite（项目内置的本地数据库）+ 本地文件名双重去重，重跑自动跳过已下载的作品

最短上手路径：克隆、配置、运行

把仓库拉下来，装依赖，复制一份配置文件，登录一次抖音拿 Cookie，然后运行，一共 5 行命令：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt && cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml python run.py -c config.yml

Cookie 是浏览器登录抖音后留下的一串凭证，抖音接口靠它确认「你登录过」，所以首次必须先跑第 4 行。它会弹出一个浏览器窗口，你扫码登录、回终端按回车，Cookie 就自动写进config.yml。这一步依赖 Playwright（微软的自动化浏览器库），需要提前装一次：pip install playwright && python -m playwright install chromium。

配置文件里只动两个必填项就够：link填你要下载的作品或主页链接，path填存放目录（默认./Downloaded/）。其余项（并发数、重试次数、封面/音乐/JSON 开关等）保持默认即可，全部可选项在config.example.yml里都有中文注释。

下载完成后，每个作品是一个独立文件夹：无水印 MP4 视频、_cover.jpg封面、_music.mp3原声、_data.json元数据（标题、发布时间、互动数据）。

进阶：三个高频问题

只想存某段时间的作品？

在config.yml里加两行就行，格式是YYYY-MM-DD，窗口外的作品直接不拉：

start_time: "2025-01-01" end_time: "2025-06-30"

中断重跑，会不会重复下载？

不会。database: true（默认开启）时，每下载完一条作品就记进 SQLite，同时程序还会扫描本地文件名里的作品 ID；两条路都查过，已存在的直接跳过。如果你只想每次增量拉新作品、老作品完全不碰，把increase.post设为true即可。

能录直播吗？

可以（官方标注为实验性功能）。把link指向直播间地址，再用live配置控制录制时长：

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

录好的 FLV 视频保存在Downloaded/作者名/live/下，主播下播、网络空闲或你按 Ctrl+C 中断时，已录到的部分都会保留。

谁会用得上

内容创作者：批量收藏同领域作品做参考，或备份自己的全部作品，省掉逐条手动保存。
研究与数据分析：批量拉取指定账号的作品，配合_data.json元数据和可选的评论采集（comments.enabled: true）快速攒数据集。
重度收藏用户：把关注的几个博主的主页链接都写进link，定期跑一次增量模式，本地库自动跟上更新。

卡在这了？常见卡点速查

只能拉到 20 条左右就不再翻页——这是平台翻页风控，确认browser_fallback.enabled: true且headless: false，弹出浏览器后手动完成验证再关窗口。
提示登录态失效、拉不到作品——Cookie 过期了，重跑一次python -m tools.cookie_fetcher --config config.yml刷新。
进度条刷屏看不清关键信息——默认progress.quiet_logs: true已静默日志，调试时才加-v或--show-warnings参数。