企业官网建设流程全解析

如何批量下载抖音无水印视频：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 是一个面向实用场景的抖音批量下载工具：无水印视频、图文、合集、音乐原声都能下载，默认带进度展示、失败重试、SQLite 去重、下载完整性校验和浏览器兜底。你既可以只保存单个视频，也可以系统性地归档某个账号的作品、点赞、收藏与合集，一份配置文件就能跑完。本文按"先跑起来、再配任务、后避坑"的顺序讲清它的用法，适合个人备份、素材整理和内容研究三类人。

五分钟跑起来：安装、拿 Cookie、下载第一个视频

环境要求只有 Python 3.8+，Windows、macOS、Linux 都支持。拉取代码并安装依赖：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt # 使用浏览器兜底或自动获取 Cookie 时再装 pip install playwright python -m playwright install chromium

批量类功能需要登录 Cookie。用内置的 Cookie 工具会弹出抖音登录页，登录后回到终端按 Enter，Cookie 自动写入配置文件：

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

然后启动下载。-c指定配置文件，-u追加一次性链接，-t调并发数：

python run.py -c config.yml python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538" -t 8

命令行参数与 CLI 入口 中的定义一一对应，需要服务化时加--serve即可转为 REST API 模式。

配置 config.yml：一份文件覆盖视频、图文、合集、音乐

配置文件是整个工具的核心，最小形态只有两个字段：link放链接、path放落盘目录。链接类型会被自动识别——/video/是单个视频，/note/是图文，/collection/是合集，/music/是音乐原声，v.douyin.com这类短链也会自动解析。以"下载某作者主页最近 50 个作品"为例：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 50 # 0 表示不限数量 thread: 5 # 并发数 database: true # 启用 SQLite 去重与历史 progress: quiet_logs: true

三个约定值得记住：

• mode支持post（作品）、like（点赞）、mix（合集）、music（原声）四个值，可多模式同写，同一作品跨模式不会重复下载。
• folderstyle: true时每个作品独立成文件夹，内含视频本体、_cover.jpg封面、_music.mp3原声、_data.json元数据，文件名以作品发布日期开头。
• 加start_time/end_time（格式YYYY-MM-DD）可按发布时间圈定范围，避免一次拉太多。

批量下载作者主页：增量模式与双重去重，重复运行不重复下载

批量下载是这个工具的主战场。默认 5 并发、指数退避重试（1s/2s/5s）、限速 2 请求/秒，下载完成还会比对 Content-Length，发现文件不完整就自动清理重来。

真正省时间的是去重机制。开启database: true后会生成dy_downloader.db，工具用"数据库记录 + 本地文件"双重信号判断是否跳过某个作品；再打开增量开关，就只剩新作品会被下载：

increase: post: true database: true

之后把它挂到定时任务里反复跑即可，不用管哪些已经下过。想看下载历史，直接查库：sqlite3 dy_downloader.db "SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;"。

浏览器兜底与进阶配置：翻页被限制、想收评论时怎么办

如果 API 翻页被风控（典型症状是"只能抓到 20 条作品"），打开浏览器兜底。它会自动启动浏览器继续滚动加载，弹出页面时手动过一次验证码即可：

browser_fallback: enabled: true headless: false max_scrolls: 240 wait_timeout_seconds: 600

其他常用的进阶项：

• proxy：为 API 请求和媒体下载设置代理，如http://127.0.0.1:7890，弱网环境建议配上。
• comments：按作品采集评论（可含二级回复），在视频旁生成*_comments.json，做内容分析时很实用。
• transcript：调用 OpenAI 语音转写 API，把视频里的口播转成 txt/json，需要设置OPENAI_API_KEY，仅对视频作品生效。
• notifications：任务完成后通过 Bark / Telegram / Webhook 推送到手机，单个渠道失败不阻塞主流程。
• --hot-board/--search：命令行直接拉热搜榜或关键词搜索结果，落盘为 JSONL 快照。

桌面版 Douzy：粘贴链接就开始，任务可视化跟踪

同一套后端还有一个处于内测期的桌面客户端 Douzy，可从项目的 Releases 页面获取。粘贴视频、图文、主页或合集链接即可开始下载，还能同步当前账号的关注、收藏与喜欢列表，筛出哪位博主有新作品并直接发起下载。

收藏与喜欢页可管理自己账号的收藏视频、收藏合集和喜欢作品，支持整集合一键下载：

任务中心展示每个任务的进度、成功/失败计数与失败原因，可以重试失败项、直接打开输出目录：

避坑指南：Cookie 失效、重新下载与翻页受限怎么处理

• Cookie 失效：重新执行python -m tools.cookie_fetcher --config config.yml，建议每周检查一次有效性。
• 想重新下载某个作品：只删本地文件不够，工具还会扫描文件名里的 aweme_id 去重，必须同时删除数据库中对应记录，表结构见 存储模块。
• 进度条刷屏：保持quiet_logs: true，调试时再临时加-v查看细节。
• collect/collectmix模式：用于下载自己账号收藏夹里的作品，只支持当前登录 Cookie 对应的账号，且必须单独使用，不能与post等模式混写。
• 直播录制是实验性能力：live.douyin.com房间链接支持 FLV 录制，主播下播或中断前已录的字节会保留。

从python run.py -c 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