企业官网建设流程全解析

douyin-downloader 抖音作品批量下载指南：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

想把某位博主发布的视频、图文整批存下来做档案，靠手动保存根本追不上更新速度。douyin-downloader 是一个面向命令行用户的抖音批量下载工具：单条无水印视频、图文、合集、原声音乐都能收，把博主主页链接填进配置就能整页拉取，重复运行还会自动跳过已存的内容。下面按"装环境 → 跑通一条 → 整页归档 → 长期维护"四个任务走一遍，每个环节都告诉你看到什么才算对。

🛠️ 抖音批量下载环境搭建与 Cookie 扫码登录

先确认本机有 Python 3.8 以上版本，然后把代码取下来装依赖：

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

装完再跑程序时终端没有ModuleNotFoundError就是对的。Playwright 那两行额外装的是一个真实的 Chromium 浏览器，后面两处依赖它：Cookie 的自动获取，以及翻页被风控拦下时的兜底验证。

登录凭证是必需的。Cookie 就是浏览器里的一串登录凭证，工具拿它向抖音接口换数据。项目自带获取脚本：把仓库里的config.example.yml复制成你自己的config.yml，其余字段保持默认即可，然后运行

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

它会弹出一个浏览器窗口，你扫码登录抖音，回到终端按 Enter，Cookie 就直接写进了config.yml。判断成功的标志：配置里cookies段不再显示YOUR_xxx占位值。不习惯自动获取的话，也可以手动把浏览器里复制的 Cookie 填进这一段。Cookie 只存在你本地这份文件里，不会上传。

🎬 抖音单条视频无水印下载：最短验证路径

先拿一条作品验证环境是否真的通了。不改动配置文件，直接用-u把链接追到命令后面，可以重复传多次：

python run.py -u "https://v.douyin.com/xxx/" -c config.yml

v.douyin.com这类分享短链工具会自动解析成真实地址，直接粘分享文本里的短链就行。-u是追加链接而不是替换配置里的链接，参数全留在命令行上，跑完不留痕，适合临时存一两条。下载时工具会从多个码率里挑无水印源，默认选最高转码档；想存原片或指定分辨率，把config.yml的video_quality改成original或1080p这类值即可。跑完你应该在汇总里看到"成功 1"，并且./Downloaded/下多出一个没有水印的 mp4——到这里环境就算通了。

不想碰命令行的话，同一套后端还打包成了 Douzy 桌面端，粘链接即可开始：

📥 抖音博主主页作品全量批量保存配置

最常用的场景：把某位博主主页的作品整页拉下来。改config.yml里的link、number两段即可，其他字段保持默认：

link: - https://www.douyin.com/user/xxx mode: - post number: post: 0

mode的post表示"发布页作品"，number.post的 0 表示不限数量。这里有个容易踩的坑：模板文件里post默认是 1，不改的话只下一条。

运行：

python run.py -c config.yml -t 2

-t指定并发线程数，默认是 5。主页作品往往上百条，并发越大越容易触发风控，把线程压到 2 让节奏慢一点更稳；带宽好、机器强的用默认 5 也没问题。下载被限速器控制在每秒 2 个请求以内，单条失败会自动按 3 次指数退避重试。如果翻页只拿到二十条左右就停了，说明接口翻页被风控拦下——此时确认config.yml里browser_fallback.enabled: true且headless: false，工具会打开一个真实浏览器窗口，你手动完成里面的验证动作，然后让它继续翻页，别急着关窗口。

⏱️ 发布时间过滤与原声、封面等附带产物

全量归档之前，可以先想清楚要哪个时间段的。start_time/end_time填YYYY-MM-DD格式，比如只留某个月发布的作品，结束日期当天也会包含在内：

start_time: "2026-09-01" end_time: "2026-09-30"

空字符串表示不设边界，两个字段平时都留空即可。

封面、原声音乐、作品 JSON 这类附带产物默认全是关的——全开会多出几倍文件和请求。确认要某条作品的原声时，把music: true打开再跑一次；封面同理开cover。完成后的推送通知（Bark/Telegram/Webhook）也默认关闭，需要再开notifications.enabled。

♻️ 增量下载与 SQLite 去重：断了不用从头来

长期归档靠的是增量机制。database: true和increase.post: true默认都已开启，无需改动：工具把每条已下作品记进dy_downloader.db，再跑同一条命令时会跳过存量、只补新增。判断"已下载"是双重依据——数据库有记录，且磁盘上存在非空的主文件，文件丢了也会自动补下；下载中断的坏文件会比对 Content-Length 后清理重下。所以任务跑到一半断了，直接重跑命令就行，不用从头来。

想强制重下某一条，要同时清掉文件和本地记录：删掉本地 mp4，再执行sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = 'xxx';"。

默认的归档目录结构（folderstyle: true）：

Downloaded/ └── 博主昵称/ └── post/ └── 2026-09-14_作品标题_作品ID/ ├── 作品.mp4 └── （开启后）_cover.jpg / _music.mp3 / _data.json

想看默认开关的完整取值，读config/default_config.py；具体的下载与翻页逻辑在core/目录下。

📚 抖音收藏夹与合集批量下载

collect模式对应的是当前 Cookie 所属账号自己的收藏夹，链接固定填一个特殊地址user/self：

link: - https://www.douyin.com/user/self?showTab=favorite_collection mode: - collect

它拉取的是这份 Cookie 登录的那个账号收藏了什么，所以 Cookie 是哪个账号，存的就是哪个账号的收藏。collect/collectmix必须单独跑，不能和post、like混在同一份mode列表里。想收博主自己建的合集，把mode换成mix并填该博主主页链接，number.mix填 0 即不限。

🩺 抖音批量下载故障排查对照表

安全与版权提醒：Cookie 等同于登录凭证，带它的config.yml不要外发；下载的作品建议仅用于个人存档与研究，不做二次商用或搬运。

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