如何批量保存抖音创作者的作品:Douzy 无水印下载工具完整指南
【免费下载链接】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
想把某位抖音创作者主页的作品完整存下来?Douzy(douyin-downloader)是一个开源的抖音批量下载工具:视频、图文无水印下载,主页与合集批量保存,增量去重,元数据留存,命令行和桌面版两种形态。
工具速览:Douzy 的抖音批量下载能力清单
仓库提供两种形态:Python 命令行版,适合写脚本、挂定时任务;Douzy 桌面版(Windows / macOS),图形界面、粘贴链接即可发起任务。适合做创作者素材收集、内容研究或个人收藏归档的人。
核心能力:
- 抖音视频、图文无水印下载,默认取最高清晰度,可探测原画
- 用户主页作品、合集、喜欢、音乐(原声)、收藏多种入口
- SQLite 下载记录:自动去重,增量下载只取新内容
- 留存作品元数据 info.json,可选评论采集(支持楼中楼)
- 实时进度显示、失败自动重试、日期范围过滤
- 接口受限时 Playwright 浏览器兜底
- 完成通知:bark、Telegram、webhook
- Douzy 桌面版另支持 TikTok、YouTube、Telegram、X
一点提醒:抖音接口风控目前较严,CLI 版部分入口(单个作品、合集、音乐、喜欢、收藏)可能被限制,主页作品有浏览器兜底但不保证成功,README 建议日常下载用 Douzy 桌面版。
桌面版在左侧栏可切换多个平台工作台:
抖音批量下载首次上手:从安装到第一次运行
先准备环境(Python 3.9+),克隆仓库并安装依赖,其中 Playwright 用于浏览器兜底:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt python -m pip install playwright python -m playwright install chromium装完后终端无报错,就可以接着配置了。
接下来把示例配置复制为config.yml,再运行内置的 Cookie 获取工具python -m tools.cookie_fetcher --config config.yml(源码见 tools/cookie_fetcher.py)。浏览器会弹出抖音登录页,登录完成回到终端按 Enter 保存;Windows PowerShell 下用Copy-Item代替cp。
最后把配置里的link换成目标创作者主页,其余字段保持示例即可:
link: - https://www.douyin.com/user/YOUR_SEC_UID path: ./Downloaded/ mode: [post] number: post: 10 # 0 表示不限数量 increase: post: true # 跳过已下载作品执行python run.py -c config.yml,看到进度条、./Downloaded/下出现无水印视频,就完成了一次抖音批量下载。运行时还可以用-u追加链接、-t调整并发、-v查看详细日志。
配置要点:文件命名与文件夹怎么配
最常用的参数就这 6 个,默认值见 config/default_config.py:
path— 下载根目录,默认./Downloaded/,任务量大建议放外置硬盘filename_template/folder_template— 作品文件与文件夹命名模板,默认{date}_{title}_{id};可用变量含{author}、{type}、{mode}等,见 utils/naming.pyfolderstyle— 是否每个作品建独立文件夹,默认trueauthor_dir— 作者目录层命名:nickname直观,nickname_uid直观且唯一,sec_uid最稳定music/cover/json— 背景音乐、封面、元数据保存开关,默认全关,按需打开increase— 按模式的增量开关,true跳过已下载作品,定期运行时最省心
命名模板里务必保留{id},避免重名互相覆盖;作者改名或重名时,把author_dir换成nickname_uid或sec_uid。
进阶玩法:浏览器兜底、语音转写、完成通知
- 浏览器兜底(browser_fallback):接口取数受限时自动改用 Playwright 浏览器滚动主页取作品。什么时候用得上:主页只取到少量作品、或接口被风控时,保持
enabled: true、headless: false,在浏览器窗口里手动完成验证。 - 语音转写(transcript):下载后调用转写 API,为作品生成 txt / json 文本。什么时候用得上:要做内容摘要、关键词提取或字幕素材时;默认先用 ffmpeg 抽音频再上传,省流量。
- 完成通知(notifications):任务成功或失败时经 bark、Telegram、webhook 推送。什么时候用得上:定时任务跑批时,不用守着终端也能第一时间知道结果。
排障速查:常见报错怎么处理
- 登录态失效、拉取作品失败:多半是 Cookie 过期。重新运行
python -m tools.cookie_fetcher --config config.yml,登录并保存即可。 - 主页只取到少量作品:抖音风控生效。保持
browser_fallback.enabled: true、headless: false,在浏览器里手动完成验证;仍受限就换 Douzy 桌面版。 - 不同作品互相覆盖:命名模板缺
{id}。在filename_template中补回,如{date}_{title}_{id}。 - 失败多、速度不稳:并发过高或网络不稳。调低
thread(如 3)、加大retry_times,必要时配置proxy。 - 定位不了原因:用
python run.py -c config.yml -v跑一遍,看详细日志输出。
结尾:适用场景与合规提醒
Douzy 适合创作者素材归档、内容研究、个人收藏备份等场景:CLI 跑定时批量任务,桌面版应对日常即下即得。请仅用于学习、个人研究与数据备份,尊重创作者版权与平台规则,使用责任自行承担。先从下载一位创作者的 10 个作品开始,跑通整个流程。
【免费下载链接】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),仅供参考