douyin-downloader 完整实战：批量下载抖音去水印，极简配置 3 步归档整个创作者主页-育师

douyin-downloader 完整实战：批量下载抖音去水印，极简配置 3 步归档整个创作者主页

【免费下载链接】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 一次解决：一份配置文件，无水印视频、图集、合集、音乐原声全部归档到本地，进度条、自动重试、去重都内置。

30 秒判断：这工具接不接得住你的需求

先别动手，确认它接得住你的需求。支持矩阵很直接：

链接类型：单视频（/video/）、图文笔记（/note/、/gallery/）、合集（/collection/、/mix/）、音乐（/music/）、用户主页（/user/）、分享短链v.douyin.com、直播间live.douyin.com
平台：抖音为主；同后端桌面应用 Douzy（beta）另覆盖 TikTok 与 YouTube，详见 README.md
系统：Windows、macOS、Linux 全支持
环境：Python 3.8+，pip 依赖仅 9 个，一条命令装完；浏览器兜底功能需额外pip install playwright

另外项目自带 Dockerfile，想丢到服务器里跑直接构建镜像即可。如果你要的是"存一条去水印视频"或"打包整个创作者主页"，直接往下看；找其他短视频平台的工具，它接不住。

🚀 端到端实操：5 分钟看到第一条无水印文件

1. 克隆仓库并安装依赖

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

预期你会看到：安装输出滚完，结尾没有红色报错。

2. 一键获取登录态，成败关键的一步

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

脚本会弹出一个浏览器窗口，扫码登录抖音，回到终端按回车。预期你会看到：终端提示写入成功，配置文件cookies段不再是占位符。这步为什么最要紧：主页内容大多只在登录态下开放，跳过它后面全白搭。如果浏览器拉不起来，先pip install playwright再执行python -m playwright install chromium装好浏览器内核。

3. 只留一份最小配置练手

config.example.yml 有几十个开关，第一次跑只看这几行，其余保持模板默认即可：

link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ mode: - post number: post: 1

先用一条单视频试，跑通再放开主页抓取。

4. 启动下载

python run.py -c config.yml

预期你会看到：进度条滚动推进，结束后打印成功数统计，项目目录下出现Downloaded/，按"作者 → 模式 → 日期_标题"归好档，里面是无水印 mp4 和元数据。多条任务并行时每条作品各有进度条，中途失败会按配置次数自动重试。不想改配置也能临时加链接，直接传-u "链接"就行。

不习惯终端？同后端桌面版 Douzy 粘贴链接即可识别并一键开始：

⚙️ 只碰这 7 个配置

跑通之后，日常你只需要碰这几项：

配置项	一句话作用	新手建议值
`link`	要下载的链接列表，支持多条	按需填写
`path`	文件保存根目录	`./Downloaded/`
`mode`	主页链接抓哪类：post/like/mix/music	起步`post`
`number`	各模式数量上限，`0`不限	先`post: 1`，再`0`
`increase`	增量下载，跳过已下过的作品	`true`
`thread`	并发下载数	`5`，别急着拉满
`retry_times`	单条失败自动重试次数	`3`

决定长期可用性的是increase。打开后，下载器每次运行都做"数据库记录 + 本地文件"双重校验：作品主文件在本地存在且非空就直接跳过。这意味着你可以配个定时任务每天跑一遍，只拿新内容，不重复下载、不重复占盘。关掉它则会重新下载并覆盖当前筛选范围内的作品，覆盖前想清楚。另外只存视频本体时video: true其余保持关闭即可，想留封面、音乐、元数据再开对应开关。

场景实战：挑一个用起来

批量打包一整个创作者主页

改什么：link填主页链接，mode同时列上post、like、mix，number全0（不限）。你会得到：按"作者 → 模式 → 日期_标题"归位的文件，跨模式去重保证同一作品不存两次，每个作品文件夹里视频、封面、音乐、JSON 元数据俱全。作品多的作者建议拆成两次跑，post 先跑，再跑 like/mix，限流风险明显更低。桌面版任务中心能更直观地盯住每个批量任务的成败状态：

每日增量：跑一次只拿新内容

改什么：number: post: 0配increase: post: true，保持database: true（默认开）。你会得到：第二次起运行自动跳过本地已有文件的作品，进度条只推进新发布的部分；桌面版关注页每个创作者的"新作品 +N"角标一目了然，先看谁更新再安排下载：

收藏夹整包带走

改什么：link填https://www.douyin.com/user/self?showTab=favorite_collection，mode用collect（自己收藏夹）或collectmix（收藏的合集）。注意这两个模式只能单独使用，不能和 post/like 混写。你会得到：收藏夹里的作品逐条完整落盘，和桌面版"收藏与喜欢"页的合集卡片一一对应：

故障速查：3 秒定位

突然大面积失败或提示需要登录→ 根因：Cookie 过期 → 操作：重跑python -m tools.cookie_fetcher --config config.yml刷新登录态，这是长期使用的生命线。
主页作品只抓到 20 条左右就停→ 根因：翻页触发限流 → 操作：确认browser_fallback.enabled: true且headless: false，在弹出的浏览器窗口里手动完成验证，别急着关。
想重下某条作品却被跳过→ 根因：双重校验判定已下载 → 操作：删掉本地作品文件夹（文件夹名含 aweme_id），同时删dy_downloader.db里对应记录，再重跑。
下载中断、文件不完整→ 根因：网络波动 → 操作：不用手动修，工具按 Content-Length 校验并自动清理残缺文件，重跑后重试机制会补上。
进度输出刷屏、互相覆盖→ 根因：静默模式没开 → 操作：progress.quiet_logs: true；排查时临时加--show-warnings看告警。