抖音下载器:单条无水印,整页主页批量
【免费下载链接】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 命令行工具:把链接丢给它,直接取无水印源,默认带进度条、失败重试、数据库去重,不用你点网页。
为什么选 douyin-downloader
- 无水印,且自动挑最高码率:从视频
bit_rate档位里自动选源,默认highest;想探原画就把video_quality改成original,每条作品多一次探测请求。 - 默认就去重,可以反复跑:
database: true时用 SQLite 记录加本地文件名双重检查,同一个任务重跑会直接跳过已下载的作品。 - 页面翻到墙时回落到真浏览器:主页翻页遇到风控,会自动拉起浏览器、读取页面自己发出的作品列表请求,你只需在弹窗里过一遍验证码。
- 一个配置覆盖多数场景:单条视频、主页作品、合集、音乐、直播录制、热搜榜导出,都是同一份
config.yml里改几行的事。
三步快速上手
- 拉代码装依赖:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader && pip install -r requirements.txt - 复制配置并获取 Cookie:
cp config.example.yml config.yml,再跑python -m tools.cookie_fetcher --config config.yml,在弹出的浏览器里登录、按回车,Cookie 自动写回配置(需先装 playwright)。 - 把链接写进
config.yml的link段,运行:python run.py -c config.yml
其余都有默认值:并发 5、失败重试 3 次、限速 2 请求/秒。可以先拿单条视频试水,再上批量。
主要能力
丢链接,去水印下载
视频、图文、合集、音乐链接写进link,或用-u参数临时追加。默认选无水印的最高码率源,文件按Downloaded/作者名/post/落到以日期、标题、作品 ID 命名的子目录;勾上cover、music、avatar会一并保存封面、BGM 和头像。
主页批量下载,任务可查
主页链接配mode: [post],number.post: 50只取最近 50 条,0表示不限;同时开多个模式时,同一aweme_id跨模式自动去重,不会重复下载。
截图来自仓库配套的桌面版 Douzy,与 CLI 共用同一套后端,粘贴链接即可下载。
进阶玩法:什么时候开什么 ⚙️
- 并发
thread:默认 5。网络不稳时压到 1~3 更不容易触发风控;带宽富余跑批量任务,加到 10 以上能明显提速。 - 增量
increase:默认已开(依赖database: true),适合长期跟踪某个博主,只下新作品;想整段强制重下,把对应模式设为false。 - 重试:失败按 1s、2s、5s 指数退避自动重试(
retry_times: 3),文件不完整会自动清理重拉,不用手动删半成品。 - 时间过滤:
start_time/end_time(格式YYYY-MM-DD)圈定区间只抓那段时间的作品,配number就能精确取量。
适合谁,不适合谁
适合:
- 个人保存喜欢的视频、归档素材,量级从单条到几十上百条
- 需要定期跟踪博主更新的人(增量模式,可加完成通知推送)
- 习惯命令行、想把任务写成脚本或挂定时任务的人
别在以下情况用它:
- 批量抓点赞 / 收藏夹:抖音风控自 2026-08 起封掉这些接口,CLI 已取不到,这类需求用桌面版
- 直连接口下单个视频 / 合集 / 音乐:2026-09 起这些接口要求浏览器端签名,CLI 无法直连,主页作品只能靠浏览器兜底
- 完全不想碰命令行:直接用仓库里的桌面版
- 直播录制属于实验性功能,HLS 源还需 ffmpeg 后处理
新手容易卡住的地方 💡
- 只抓到 20 条就停:这是翻页风控,确认
browser_fallback开着(默认开),浏览器弹出后手动过验证码,别急着关窗口。 - Cookie 失效取不到数据:重跑
python -m tools.cookie_fetcher --config config.yml重新登录,会自动写回配置。 - 想重下却提示跳过:去重靠数据库加本地文件双重判断,只删数据库不触发,要连文件和数据库记录一起清。
- 进度刷屏:默认
quiet_logs已静默日志,调试时再临时加-v参数。
单条无水印、整页批量、定期增量,多数个人归档场景够用,完整配置见 README.zh-CN.md。
【免费下载链接】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),仅供参考