企业官网建设流程全解析

抖音无水印批量下载完整指南：从单个视频到主页合集

【免费下载链接】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 是面向这类场景的 Python 命令行工具：无水印源解析、主页批量下载、SQLite 去重、浏览器兜底，并按作品输出 MP4、封面、MP3、元数据等一整套文件。

🎯 它解决什么问题

场景一：某个作者更新频繁，你在 App 里逐条转发保存，容易漏、文件还带水印；攒到一定数量后，你希望同一作者的作品归在一个目录里，下一次运行只取新增的。

场景二：你要的不是一两条视频，而是一组素材——某个合集、同一首背景音乐的全部作品、某条作品的完整评论列表。手动复制链接逐条解析，效率很低。

douyin-downloader 的定位是“配置文件驱动 + 命令行执行”：把链接和规则写进 config.yml，程序负责翻页、去重、重试和文件归档，你只需要确认结果。

🚀 最快上手路径

环境要求 Python 3.8+，步骤如下：

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，先装 Playwright：

pip install playwright python -m playwright install chromium

用自动方式拿 Cookie（会弹出浏览器窗口，登录抖音后回终端按 Enter，配置自动写入）：

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

把 config.yml 改成最小可用配置：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 作者主页链接 path: ./Downloaded/ mode: - post number: post: 5 # 条数，0 表示全量 thread: 5

运行：

python run.py -c config.yml

如何判断跑成功了：Downloaded/作者名/post/ 下出现形如 2024-02-07_作品标题_aweme_id/ 的子目录且包含 .mp4，同层生成 download_manifest.jsonl 清单；终端进度条走完且没有失败项。另外，命令行参数可以临时覆盖配置，例如python run.py -c config.yml -t 8 -p ./Downloaded（-t并发数、-p输出目录、-u追加链接）。

版本提示：项目分 V1.0 稳定版与 V2.0 增强版，当前仓库为 V2.0；只下载单个视频用 V1.0 即可，主页批量下载建议用 V2.0。

📦 核心能力详解

批量下载作者主页（最高频）

粘贴作者主页链接，用mode选择要抓的内容：

mode: - post # 发布作品 - like # 作者点赞过 - mix # 作者发布的合集 - music # 作者用过的同一背景音乐的作品

• 每个模式各用number控制条数，0 为全量；
• 跨模式自动去重：同一个 aweme_id 在不同模式下不会重复下载；
• 收藏夹（collect）与收藏合集（collectmix）仅支持当前登录 Cookie 对应账号，链接用https://www.douyin.com/user/self?showTab=favorite_collection，且必须单独使用，不能与 post/like/mix/music 混用；
• 时间过滤：start_time/end_time（格式 YYYY-MM-DD），只取区间内作品。

不习惯命令行的话，同一套后端还做了桌面版 Douzy（目前内测）：粘贴链接下载、多链接任务队列、关注与收藏同步、本地下载档案。

单个作品、合集与音乐

链接本身决定类型，无需 mode：

• 视频：/video/{aweme_id}
• 图文：/note/{note_id}或/gallery/{note_id}
• 合集：/collection/{mix_id}或/mix/{mix_id}
• 音乐：/music/{music_id}，优先取原声文件，缺失时回退到该音乐下的首条作品
• v.douyin.com、v.iesdouyin.com短链自动解析

每条作品可附带的产物：封面（JPG）、背景音乐（MP3）、作者头像、作品 JSON 元数据。默认只存视频本体，其余按需开启，避免文件膨胀。

进阶：直播录制、评论采集与通知

• 直播：填入live.douyin.com/{room_id}链接即开始录制，FLV/HLS 源均可；max_duration_seconds: 0表示录到主播下播。主播下播、网络空闲或 Ctrl+C 中断时，已录制的字节会保留（.tmp 自动提升为正式文件），保存在作者目录下 live/ 子目录，并附带 *_room.json 直播间元数据。
• 评论：comments.enabled: true后按作品抓评论（include_replies可含二级回复），生成{date}_{title}_{aweme_id}_comments.json；max_comments限制条数，0 为不限。
• 通知：notifications配置后，下载完成可并发推送 Bark / Telegram / Webhook（企业微信、飞书、钉钉机器人 URL 通用）；单个渠道失败不阻塞下载。
• 稳健性内置：失败按指数退避重试（1s、2s、5s，默认 3 次），全程默认限速 2 请求/秒，媒体下载有 Content-Length 完整性校验，不完整文件自动清理并重下。

去重与增量：只下新内容

database: true（默认）启用 SQLite 记录 + 本地文件名双重去重。配合increase.post: true这类增量开关，同一作者主页反复运行时只拉新增作品，已下载的直接跳过。

⚙️ 关键参数与配置调优

配置项很多，真正影响体验的主要是这 5 个：

❓ 常见问题

为什么只能抓到 20 条作品？这是翻页风控的常见现象。确认browser_fallback.enabled: true且headless: false，浏览器窗口弹出后手动完成验证、不要立即关闭，程序会借页面自身的请求继续翻页。

Cookie 失效了怎么办？重新执行python -m tools.cookie_fetcher --config config.yml，登录后配置会自动重写，不需要手动逐字段复制。

作品已下载过，如何强制重新下载？程序按“数据库记录 + 本地文件”双重检查判断跳过，所以要把含 aweme_id 的本地目录和 dy_downloader.db 里的对应记录一起删掉。只删数据库不会触发重下；只删文件则会。

终端刷屏、进度条重复输出？progress.quiet_logs默认 true，进度阶段本就静默日志；确需排查时临时加--show-warnings或-v参数查看详细日志即可。

如果你的目标是“周期性采集一批作者、只取新增、完成后自动通知”，配置文件 + 增量开关 + 通知推送这条链路已经够用；更完整的参数表和限制说明见 README.zh-CN.md 与仓库内的 docs/。

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