抖音批量下载与去水印：一条命令建库、批量归档、直播录制全搞定

抖音批量下载与去水印：一条命令建库、批量归档、直播录制全搞定

【免费下载链接】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是一个免费开源的抖音视频下载工具，支持单条去水印、抖音主页批量下载、合集归档、音乐提取与直播录制，自带进度展示、断点续传和 SQLite 去重。

快速上手：装依赖、取登录态

先克隆仓库并装好依赖：

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

抖音需要登录态才能取到资源，获取方式二选一：

# 自动方式：弹出浏览器，登录后回终端按回车，Cookie 自动写入配置 python -m tools.cookie_fetcher --config config.yml

进阶用户也可以直接在浏览器复制 Cookie 串，手动填进 config.yml 的cookies字段。登录态取好后，后续可长期复用。

一条命令下载无水印视频

存单个视频，一条命令就够，工具会自动挑无水印高清源：

python run.py -u "https://v.douyin.com/你的分享短链/"

支持v.douyin.com、v.iesdouyin.com等短链自动解析。注意点：

• 想要原声、封面、元数据时，在配置里打开music: true/cover: true/json: true。
• 默认并发数thread: 5、限速rate_limit: 2（请求/秒），可按宽带调整。

主页与合集：整站批量归档

想收藏某博主全部作品或整套合集，把主页或合集链接写进配置，指定模式即可批量下载：

link: - https://www.douyin.com/user/创作者主页链接 mode: - post # 也可填 like / mix / music number: post: 50 # 0 表示全量

工具会自动遍历发布内容与图文，并发下载、失败指数退避重试，Rich 进度条实时显示每个任务的完成度，已下载的自动跳过。

• 合集直接把/collection/{合集ID}或/mix/{mix_id}放进link即可整套拉取。
• 点赞列表等次要功能同样并入mode一句带过：mode: [like]。
• 用start_time/end_time（格式YYYY-MM-DD）可只拉某个时间段的作品，适合增量更新。

音乐素材提取：优先抓原声

做 BGM 素材库的创作者，用音乐模式优先抓取原声文件，缺失时回退到该音乐下首条作品：

link: - https://www.douyin.com/music/音乐ID mode: - music

• 原声优先于转码音轨，适合直接做素材。
• 也可对单条作品开启music: true顺带存下原声 mp3。

直播录制：下播也保留已录数据

把直播间链接放进link，自动获取直播流地址并录制：

link: - https://live.douyin.com/直播间ID live: max_duration_seconds: 0 # 0 = 录到主播下播

录制产物保存在Downloaded/{作者}/live/下，附带直播间元数据快照。主播下播、网络空闲或 Ctrl+C 中断时，已录制的字节会被保留（.tmp自动提升为正式文件）。

机制亮点：把"堆文件"变成"建库"

• 双重去重：SQLite 数据库 + 本地文件双重检查，已下载作品跨会话自动跳过，不重复占磁盘。
• 清晰归档：文件按"作者 → 模式 → 日期_标题_作品ID"自动建子目录，命名模板可在filename_template自定义。
• 双引擎兜底：日常走 API 引擎，翻页受限时自动切到 Playwright 模拟浏览器，可手动过验证码，长期任务成功率高。
• 断点与完整性校验：下载按 Content-Length 比对，不完整文件自动清理并重试；中断后已录/已下数据不丢。

常见问题与避坑

• 只能抓到 20 条作品：多为翻页风控。确认browser_fallback.enabled: true、headless: false，浏览器弹窗出来后手动完成验证，别急着关窗口。
• 下载报错、疑似未登录：登录态过期是常见原因。重跑python -m tools.cookie_fetcher --config config.yml刷新 Cookie 即可。
• 请求太快被限制：把thread调到 3~5、rate_limit保持 2 左右，避免高频请求触发风控。
• 想重新下载某作品：需同时删本地文件与数据库记录（只删库不删文件不会触发重下，反之会）。
• 磁盘占用增长：开启database: true后去重生效，避免重复文件；可用start_time限制拉取范围做增量更新。

自动化：定时增量更新

找到稳定更新的创作者后，可用系统定时任务每天自动增量拉取：

0 2 * * * cd /path/to/douyin-downloader && python run.py -c config.yml >> download.log 2>&1

配合increase.post: true与数据库去重，每次只补新作品，不覆盖旧内容。

资源与进一步阅读

更多配置项、场景示例与输出目录规范见 README.zh-CN.md 和 config.example.yml；接口与下载逻辑在 core/ 目录下，设计文档见 docs/。不想用命令行，也可以试试项目内测中的桌面版 Douzy，粘贴链接即可下载、可视化跟踪任务。去水印、挑高清、并发去重、断点续传都已内置，把链接交给它就行。

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