抖音无水印视频批量下载从 0 到 1：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 是一个用 Python 写的抖音内容下载工具。它既能凭单条作品链接拉取无水印视频，也能把整个用户主页的作品、喜欢、合集、音乐按模式批量抓下来。运行方式是命令行加一份配置文件，适合收藏管理、账号备份、数据分析这几类需要成批保存抖音素材的人。
最快跑通路径
整条链路只有三步。下面这条命令把代码仓库克隆到本地，地址用的是 gitcode 镜像：
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt装完依赖后，登录凭据是下载的前提。运行 cookie 抓取器，它会唤起浏览器，你在页面里登录一次抖音，回到终端按回车，凭据就被保存进配置文件，后续请求自动携带：
python cookie_extractor.py如果不想走浏览器，也可以手动配置：浏览器登录抖音网页版，按 F12 进 Network 标签，刷新页面后从任意请求头里复制 Cookie，粘到配置里即可。拿到凭据后，把链接写进配置的link字段，然后执行：
python run.py -c config.yml跑完第一次，./Downloaded/里就会出现按日期归好文件夹的作品。
核心能力拆解
批量下载用户主页适用场景：想一次性存下某个账号的全部发布内容。做法是把主页链接放进link，mode选post，number.post设 0 表示不限条数。坑：平台验证有时会拦主页抓取，工具会启用浏览器回退，此时headless保持false，在弹出的窗口里手动过验证。
基于历史记录跳过已下载文件适用场景：长期跟踪同一个账号，只想要新增内容。开启database: true后，SQLite 数据库会记下每条作品的下载状态，重跑同一条命令只补新作品。坑：redownload_missing_files默认为true，本地文件被删掉再重跑会当作缺失重新下载；想完全按数据库判断就改成false。
直播录制（实验性）适用场景：把link指向 live.douyin.com 的房间地址，工具进入直播录制，live.max_duration_seconds设 0 表示录到主播下播。坑：这项功能仍标注为实验，HLS 源只会存下播放列表文件，不是能直接播放的视频，先用短时长试跑更稳妥。
配置与调优
所有参数集中在 config.example.yml 这一份模板里，复制成config.yml后按需改即可，核心项如下：
link: - https://www.douyin.com/user/某主页地址 path: ./Downloaded/ mode: [post] number: {post: 0} # 0 表示不限数量 thread: 5 retry_times: 3 start_time: "2026-01-01" end_time: "2026-12-31"thread是并发线程数，家庭宽带建议 3 到 5，企业网络可给 8 到 12，高速专线能上 15 到 20；retry_times控制单次失败后的重试次数，默认 3 次。start_time与end_time按日期圈定范围，结尾日期整天都算在内。命令行还能用-t临时覆盖线程数、-p改保存目录、-u追加链接，不必动文件。项目入口是 CLI 的run.py，桌面端则是 Douzy 应用，界面里能直接勾选作品、喜欢、合集、音乐四种内容，两者共享同一套参数体系。
避坑与合规
- 现象：整体速度缓慢。解法：把线程数压回 3 到 5，先排除网络波动。
- 现象：请求被要求重新登录。解法：Cookie 过期了，重跑一次 cookie 抓取命令即可。
- 现象：同一作品重复落盘。解法：保持
database: true，历史库会自动跳过已抓的条目。 - 现象：找不到产物文件。解法：默认落在
./Downloaded/，改path就能挪位置。 - 现象：某类链接解析失败。解法：工具支持视频、用户主页、合集、音乐和直播几类地址，排错时加
-v输出详细日志。
合规只有两句：内容仅限个人收藏、学习与数据管理，请遵守平台条款与版权规定；Cookie 属于个人凭据，含它的配置文件不要外发。
从单条链接到整页主页，再到直播录制，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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
