抖音去水印批量下载教程:4步跑通 douyin-downloader
2026/9/16 19:57:02 网站建设 项目流程

抖音去水印批量下载教程:4步跑通 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 去重、增量下载与浏览器验证兜底,默认 5 线程。完整流程 4 步,一次就能跑通,唯一的硬前提是一份 Cookie。

🚀 跑通一次

准备环境

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

你会看到:依赖逐个安装完成,没有红色报错,目录里出现 run.py、config.example.yml 等文件。要求 Python 3.8+;若打算用浏览器验证兜底,再执行:

pip install playwright python -m playwright install chromium

获取 Cookie

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

你会看到:弹出浏览器窗口,用抖音 App 扫码登录后,回到终端按回车,msToken、ttwid 等 Cookie 被写进 config.yml。实现见 tools/cookie_fetcher.py,Cookie 只保存在本地。

最小配置

打开 config.yml,最简单的情况只改两处:

link: - https://v.douyin.com/XXXX/ path: ./Downloaded/

link 可以是视频、图集、合集或主页链接,完整模板在 config.example.yml。

首次运行

python run.py -c config.yml

你会看到:终端出现进度条,结束后 Downloaded/ 目录里多出无水印 mp4、封面、原声音频和一份 JSON 元数据。完整中文文档见 README.zh-CN.md。

📦 它能做什么

以下截图来自共用同一后端的 Douzy 桌面版(目前封闭测试),每项能力在 CLI 里都有对应命令或配置。

用户主页整批导出

粘贴博主主页链接即可整批导出,视频会自动从码率阶梯里挑最高的无水印源。

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

实用细节:number.post 写 0 表示不限量。批量几百条时若 API 翻页触发风控卡住,browser_fallback 会自动打开浏览器继续抓取。

增量下载与去重

对同一博主反复运行,只拉取新发布的作品,不重复占空间。

increase: post: true database: true

易踩的坑:跳过与否的判断依据是本地主媒体文件是否存在,而不是数据库记录。手动删掉某个视频,下次就会重下;想强制重下某条作品,还需同步删除 dy_downloader.db 里对应记录。

任务中心实时监控

查看哪些任务成功、哪些失败、具体缺了哪几条,失败项可以单独重试。

python run.py -c config.yml --show-warnings

实用细节:--show-warnings 会显示警告日志,失败时先确认 Cookie 是否过期,再核对日志里的接口报错。

收藏与喜欢备份

把自己账号的收藏、喜欢批量导出,适合账号迁移或归档整理。

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

易踩的坑:collect / collectmix 只对当前登录 Cookie 对应的账号生效,且不能与 post、like 等模式同时使用,配置时把其他模式删掉。

🎬 放在真实场景里

如果你是创作者在收集素材,可以这样用:粘贴优质博主的主页链接,number.post 设 0 整批导出;用 start_time / end_time 只保留某个月的作品;folderstyle: true 让每条作品单独建子目录;同目录下的 music.mp3 就是原声,可直接拖进剪辑工程。

如果你想定期备份账号,可以这样用:mode 同时写 post、like、mix、music,一次导出全部内容;increase 打开,后续运行只补增量;comments.enabled: true 后每条评论会另存为 JSON 文件;每周重跑一次同一条命令即可追新增。

如果你想录直播,可以这样用:粘贴 live.douyin.com 房间链接,max_duration_seconds 设 0 表示录到主播下播;文件以 FLV 存到 Downloaded/作者/live/ 下;即使中断或断网,已录部分会自动保留。

🛠️ 遇到问题先看这里

只下到约 20 条作品:现象是 500 条作品只下到二十来条就结束;原因是抖音翻页风控;解法是设置 browser_fallback.enabled: true、headless: false,在弹出的浏览器里手动完成验证,完成后别马上关窗口。

请求失败或列表为空:现象是大量 403 或抓不到作品;原因是 Cookie 过期;解法是重跑 python -m tools.cookie_fetcher --config config.yml 重新扫码,Cookie 有效期有限,隔一段时间重取属于正常维护。

重复下载已下过的内容:现象是二次运行又抓了一遍旧作品;原因是 increase 未启用或主媒体文件被删过;解法是设置 increase.post: true,并确认 path 指向的目录里文件完整。

想查下载历史:现象是记不清哪些已下过;原因是历史存在 SQLite 数据库而非终端输出;解法是直接查 aweme 表:

sqlite3 dy_downloader.db "SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;"

先下单个视频确认 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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询