抖音视频下载不再求人: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——一个开源的抖音批量下载工具。它把"收藏抖音内容"变成几分钟的简单操作:单条作品、图文、合集、音乐随手可下,主页作品能整页抓取,还自带去水印、增量更新和数据库去重。
先花 30 秒认识它
这个工具的核心能力可以一口气列完:
- 单条与批量一把抓:视频、图文、合集、音乐、收藏夹都能下载
- 去水印优先:自动选择无水印源,并挑最高码率的清晰度
- 双重去重:SQLite 数据库 + 本地文件双重检查,重复运行不白费流量
- 增量更新:开启后只下新增作品,适合长期跟踪喜欢的博主
- 进阶能力:直播录制、评论采集、热搜榜导出、REST API、完成通知推送
五分钟跑通第一条下载任务
第一步:装好运行环境
需要 Python 3.8+,macOS / Linux / Windows 均可。克隆仓库并安装依赖:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如果想用自动获取 Cookie 或浏览器兜底,再补装 Playwright:pip install playwright后执行python -m playwright install chromium。
第二步:准备 Cookie 认证
Cookie 是访问抖音接口的通行证。先复制配置模板,再一键自动获取:
cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml程序会自动打开浏览器,你登录抖音后回到终端按 Enter,Cookie 就写入配置文件了,全程无需手抄。
第三步:填入目标链接并运行
把要下载的链接写进配置,指定模式和数量:
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50 path: ./Downloaded/ thread: 5 database: true执行python run.py -c config.yml,很快就能看到进度条滚动、作品依次落盘。也可以临时追加参数:python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538" -t 8 -p ./Downloaded,不改配置就能单次任务。
三个值得细品的核心能力
主页批量下载:一次拿回创作者全部作品
在链接里粘贴用户主页地址(/user/{sec_uid}),mode支持post(作品)、like(喜欢)、mix(合集)、music(音乐)四种模式,可以同时开启。number设为 0 表示全量抓取,设置具体数字则限量下载。同一个作品在不同模式下出现时自动去重,不会重复占用磁盘。
增量更新:只下新增,不重复劳动
把increase.post: true(或 like / mix / music)打开,配合database: true,程序会对照数据库和本地文件,跳过已下载的内容,只抓取新增作品。配合时间过滤start_time/end_time,还能限定某段时间的作品,精准又省时。
直播录制与浏览器兜底
粘贴直播间链接https://live.douyin.com/{room_id},即可录制 FLV 直播流,主播下播或 Ctrl+C 中断时已录数据都会保留。翻页频繁受限时,开启browser_fallback会拉起浏览器人工过验证码,把采集坚持到底。
两个真实场景走一遍
场景一:保存一条心仪视频
复制视频分享链接(支持v.douyin.com短链),在link里粘贴后运行。默认会连带下载封面、背景音乐和原始 JSON 元数据,一条视频变成一套完整素材,目录清晰可溯源。
场景二:完整备份一位博主的作品库
粘贴其主页地址,mode设为post和music,number全设 0。首次跑全量,之后把increase.post打开定期运行,就是一套"追更备份"流水线。下载完成后,文件按作者和模式分门别类存放:
Downloaded/ └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── ...mp4 ├── ..._cover.jpg ├── ..._music.mp3 └── ..._data.json提效技巧与避坑提示
- 并发按网速调:
thread默认 5,网络不稳调到 1~3,高速环境可到 10+,但别贪多触发风控。 - 日志刷屏处理:
progress.quiet_logs: true会让进度阶段静默,调试时再加-v查看详情。 - 避免重复下载:想重下某个作品,需要同时删掉本地对应文件夹并清理数据库记录(
sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id='...';"),只删一边都会判断异常。 - Cookie 失效:工具访问不了数据时,重新运行
python -m tools.cookie_fetcher --config config.yml即可。
按需选择:这些用法怎么配
| 需求 | 推荐用法 |
|---|---|
| 下载单条视频/图文 | link填作品链接,mode: post |
| 备份博主全部作品 | 主页链接 +mode: [post, like, mix, music] |
| 定期追更新作品 | 主页链接 +increase.post: true |
| 录制直播间 | link填直播间地址 + 配置live.*参数 |
| 采集作品评论 | 开启comments.enabled,可含二级回复 |
| 抓热搜/关键词 | python run.py --hot-board 30/--search "关键词" |
| 对接自有系统 | python run.py --serve --serve-port 8000,REST API 提交任务 |
常见问题速查
Q:为什么只能抓到 20 条左右的作品?A:这是翻页风控的常见现象。确保browser_fallback.enabled: true且headless: false,浏览器弹出后手动完成验证,别急着关窗口。
Q:下载的文件默认放在哪?A:默认在项目下的Downloaded/目录,可用path或-p参数自定义。
Q:怎么保证不重复下载?A:开启database: true,程序通过数据库记录加本地文件双重检查来判断是否已下载。
Q:下载速度太慢怎么办?A:适当调大thread并发数,同时注意网络环境和平台风控,激进并发可能适得其反。
Q:直播录制完能直接看吗?A:FLV 文件可直接播放;HLS 源只保存 playlist,需要配合 ffmpeg 做后处理。
Q:想在下载完成后收到通知?A:配置notifications,支持 Bark / Telegram / Webhook(企业微信、飞书、钉钉 bot 均可)。
写在最后
从单条视频到整页作品库,从静态内容到直播流,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),仅供参考