企业官网建设流程全解析

douyin-downloader 快速上手指南：5 分钟批量下载抖音无水印视频、图集与直播回放

【免费下载链接】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 去重与失败重试，适合个人收藏与内容团队批量建库。

它能帮你做什么

• 个人收藏某位创作者：把作者主页链接丢进配置，mode: [post]即可拉取其全部已发布作品（视频+图集），配合number.post: 0不限量，一次跑完不用盯着。
• 内容团队整理素材库：批量抓取后按作者名/post/日期_标题_aweme_id/落盘，自动附带封面、音乐、元数据 JSON 与下载清单，方便入库检索。
• 定期增量同步新内容：开启increase.post: true后，只下载上次运行之后新增的作品，重复运行也不会白跑流量。

5 分钟跑起来

1. 克隆并安装依赖（浏览器兜底能力需要 Playwright）：

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

2. 获取抖音 Cookie：官方提供了自动获取工具，会拉起浏览器让你扫码登录，登录完回终端按回车，Cookie 自动写入配置，无需手动复制：

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

3. 写一份最小配置并跑第一次下载。新建config.yml：

link: [https://www.douyin.com/user/MS4wLjABAAAAxxxx] path: ./Downloaded/ mode: [post] number: {post: 10} thread: 5

保存后执行python run.py -c config.yml。默认 5 个线程并发，进度条会实时显示每个作品的下载状态。

一次真实下载的全过程

从粘贴链接到文件落盘，实际要碰到的配置项其实不多。

• 线程数：thread默认 5，普通家庭网络 3-5 足够，高速网络可提到 8。设太高容易触发抖音限流，得不偿失。
• 时间范围筛选：只想留某一年的素材时，加start_time: "2025-01-01"/end_time: "2025-12-31"，工具按作品发布时间过滤，跑完就是干净的年度精选。
• 增量下载：increase.post: true依赖数据库记录，下次运行只抓新作品，适合每周定时跑一次。
• 目录与命名：folderstyle: true时按作品维度建子目录，文件名带发布日期前缀（如2024-02-07_标题_aweme_id），同一作品多文件一目了然。

increase: {post: true} start_time: "2025-01-01" end_time: "2025-12-31"

跑完进Downloaded/作者名/post/看结果：视频、封面、音乐、_data.json元数据各归其位，根目录还有download_manifest.jsonl记录每批任务的来源与产物。

进阶玩法与二次开发

• 自定义下载策略：主页各模式（post/like/mix/music）由策略类驱动，继承基类即可插入新逻辑（如转码、加水印）：

from core.user_modes.base_strategy import BaseUserModeStrategy class MyStrategy(BaseUserModeStrategy): mode_name = "custom" async def collect_items(self, sec_uid, user_info): ...

• 以 Python 库方式集成：核心模块可直接 import，复用现成的下载器、限流与去重，而不是重造轮子：

from core.downloader_factory import DownloaderFactory # 按 url_type 分发下载器

• SQLite 去重机制：database: true时默认生成dy_downloader.db，记录aweme明细与download_history。程序用“数据库记录 + 本地文件名”双重判断是否跳过，想强制重下需同时清理文件与记录，查询历史也很直接：

import sqlite3; sqlite3.connect("dy_downloader.db").execute("SELECT aweme_id, author_name FROM aweme").fetchall()

踩坑与避坑

结尾

• 线程数按网络来：家宽 3-5，高速 8，别贪多。
• 每周重取一次 Cookie，定时任务里顺手跑增量下载最省心。
• 重下同一作品要“删文件 + 清库记录”双管齐下，缺一不可。

合规提示：请遵守相关法律法规与平台规定，尊重创作者版权，仅用于个人学习与技术交流。

功能以项目最新版本为准；使用时请遵守相关法律法规与平台规定，尊重创作者版权。

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