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 值得试试。它直接获取无水印的原始视频文件，并自动按码率挑出最高清晰度保存；既能下载单条视频、图文和合集，也能把一位作者主页的作品整批拉下来，支持增量更新和历史去重。
🧰 它能做什么：能力总览
- 支持对象广：单个视频、图文（note）、合集（mix）、原声音乐（music），以及作者主页、自己账号的收藏夹
- 输入方式简单：
v.douyin.com短链、/video/完整链接、主页链接都能识别，不用手动找原始地址 - 输出有条理：视频、封面、音频、元数据 JSON 一起保存，默认按作者和类型归档
- 过程可控：实时进度条、失败自动退避重试、下载后校验文件大小，半截文件会自动清掉重下
- 不重复劳动：SQLite 数据库加本地文件双重去重，重跑任务不会重复下载
- 可选扩展：直播录制、评论采集、热搜与关键词搜索、完成通知、REST API、Docker 部署
📦 安装依赖并准备登录凭证
环境要求不高：Python 3.8 及以上，Windows、macOS、Linux 都可以。仓库克隆下来后，核心程序位于douyin-downloader子目录（仓库根目录的脚本是早期版本），进入它完成安装和配置复制：
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抖音的内容需要登录状态才能访问，所以还需要一份 Cookie（可以理解成"已登录"的凭证）。项目内置了自动获取脚本，先装好 Playwright 浏览器组件，再运行它：
pip install playwright && python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml在打开的浏览器里扫码登录，回到终端按回车，Cookie 就会自动写入config.yml。如果不想装 Playwright，也可以从浏览器里复制 Cookie 字符串手动填进配置。
▶️ 完成一次无水印下载
最小配置只需要两项：要下载的链接和保存目录。
link: - https://v.douyin.com/你的短链/ path: ./Downloaded/保存后执行一条命令即可：
python run.py -c config.yml运行过程中你会看到清晰的进度展示；某条请求失败时按 1 秒、2 秒、5 秒的间隔自动重试，下载结束后还会比对文件长度，发现不完整就删除重下，避免留下半截文件。视频源会自动优先选无水印的那一份，再按码率挑最清晰的版本，这些都不需要你干预。
📚 批量拉取作者主页，支持增量更新
想收藏一位博主的全部内容，把链接换成主页地址，用mode声明要哪几类内容即可：
link: - https://www.douyin.com/user/作者主页链接 mode: - post - like number: post: 0 like: 0 increase: post: true几个关键字段的含义：
mode：post发布作品、like点赞内容、mix合集、music原声音乐；collect/collectmix用于自己账号的收藏夹，且需单独使用number：填 0 表示不限制数量increase：打开后再次运行只拉新增作品，适合长期追更start_time/end_time：按日期区间过滤，比如只整理某博主去年的内容
同一个作品即使在多个分类里出现，也只会被下载一次，跨模式自动去重。
🗂️ 文件与下载历史如何管理
默认开启folderstyle，每个作品单独一个文件夹，挂在作者名下，结构大致是：
Downloaded/作者名/post/2024-02-07_作品标题_作品ID/- 无水印视频、封面、原声音乐、
data.json元数据、作者头像
- 无水印视频、封面、原声音乐、
like/、mix/、music/、live/（直播录制时生成）
命名规则也可以改：配置里的filename_template和folder_template支持{date}、{title}、{id}、{author}等变量，改成你习惯的格式即可。
所有下载记录存进本地 SQLite 数据库（默认dy_downloader.db），想翻查历史时用一条查询看最近 20 条：
sqlite3 dy_downloader.db "SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;"桌面版客户端还提供作品档案界面，可按作者、关键词、时间筛选，方便确认"某位博主我存过多少条、最新一条是什么"。
🚀 进阶可选功能
基础流程跑通后，下面这些能力可以按需开启：
- 直播录制：链接指向
live.douyin.com/房间号即可按选择的清晰度录制，主播下播或断网时已录部分会完整保留，文件存在作者名/live/下并附房间信息快照 - 评论采集：打开
comments.enabled后，每个作品旁生成一份*_comments.json，含评论内容与点赞数，适合做内容分析 - 热搜与关键词搜索：
python run.py --hot-board 30 -p ./Downloaded或python run.py --search "关键词"，结果以 JSONL 格式落盘 - 完成通知：配置 Bark、Telegram 或 Webhook，长任务跑完自动推送到手机
- REST API 服务：
python run.py --serve --serve-port 8000启动后，可通过接口提交下载任务、查询任务状态，便于接入自己的自动化流程 - Docker 部署：项目自带 Dockerfile，适合长期挂机运行
- 视频转写：可选调用 OpenAI 转写 API，把视频语音生成 txt/json 文稿（仅对视频作品生效）
❓ 几个常见问题
| 问题 | 处理办法 |
|---|---|
| 主页明明有几百条，只拉到 20 条 | 这是翻页风控的正常现象。把browser_fallback的enabled设为true、headless设为false，API 受限时会自动切到浏览器翻页，弹窗出现后手动完成一次验证即可 |
| Cookie 失效、下载报错 | 重新运行 Cookie 获取命令，扫码后自动刷新配置 |
| 想重新下载某个作品 | 工具做了双重去重：先删掉本地对应文件夹，再用 sqlite3 删掉数据库里同 ID 的记录，两处都清掉才会重新拉取 |
| 没有生成转写文件 | 转写只对视频作品生效，检查transcript.enabled是否为true、API 密钥是否有效 |
⚖️ 适用边界与使用提醒
这个项目适合个人学习、技术研究和整理自己的收藏内容：单条收藏、追更喜欢的创作者、按时间段整理素材，都是它擅长的场景。批量能力和接口调用量较大，不建议长时间高频运行，遇到风控时优先走浏览器兜底而不是加压重试。
项目本身免费开源，但请把它用在合法合规的范围内：尊重原创作者的版权，不用于侵犯隐私或任何违规用途；平台规则或接口策略变化导致功能失效，属于正常的技术风险。现在就可以复制上面的安装命令，先用一条你最想保存的短链跑通第一个下载，再慢慢尝试整站主页和进阶玩法。
【免费下载链接】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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
