抖音批量下载如何做完整无水印采集：douyin-downloader 实用指南

抖音批量下载如何做完整无水印采集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-downloaderdouyin-downloader 是一个免费开源的抖音批量下载工具面向手动下载慢、带水印难复用、元数据拿不全这几个常见痛点。它支持单个视频/图文/合集/音乐下载、用户主页批量下载、收藏夹抓取和无水印源优先运行在 Python 命令行环境配合 YAML 配置文件即可完成从安装到批量采集的全过程。这个工具能给你留下什么成目录的媒体文件每个作品一个子目录包含无水印 MP4自动挑最高码率档、封面 JPG、背景音乐 MP3按Downloaded/作者名/post/...的层级自动归档结构化数据每个作品旁生成_data.json元数据作者、描述、点赞数等可选生成_comments.json评论文件含二级回复方便后续做统计或分析可复跑的下载历史内置 SQLite 数据库dy_downloader.db 本地文件双重去重重复运行不会重复下载开启increase增量模式后只抓新发布的作品项目基于同一套后端还推出了桌面客户端 Douzy内测中见 README.zh-CN.md以下截图为桌面版界面核心下载逻辑与命令行版一致快速开始从克隆到第一次下载环境要求Python 3.8Windows / macOS / Linux 均可。建议先创建虚拟环境避免依赖冲突python -m venv .venv source .venv/bin/activate # Windows 用 .venv\Scripts\activate # 克隆并安装依赖 git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt # 复制示例配置 cp config.example.yml config.yml下载用户主页需要登录态。推荐用内置的浏览器工具自动获取 Cookie需要先pip install playwright并python -m playwright install chromiumpython -m tools.cookie_fetcher --config config.yml # 浏览器弹出后登录抖音回终端按 EnterCookie 自动写入配置然后编辑config.yml把link改成目标主页链接、number.post改成想要的首批数量运行python run.py -c config.yml终端会显示 Rich 进度条下载结果落在./Downloaded/目录下。也支持 Docker 部署见 Dockerfiledocker build -t douyin-downloader . docker run -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/Downloaded:/app/Downloaded douyin-downloader三种最常用的用法用法一批量下载某作者的全部作品输入作者主页链接浏览器地址栏复制的/user/xxxx完整 URL。在配置里设置mode与numberlink: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 发布作品也可加 like(点赞) / mix(合集) / music(音乐) number: post: 0 # 0 表示全量不限数量python run.py -c config.yml产出Downloaded/作者名/post/日期_标题_aweme_id/下按作品分目录的媒体文件。同一作品在多个模式下出现时自动去重。用法二单条链接下载不用改配置文件视频、图文/note/、/gallery/、合集/collection/、音乐/music/短链都可以直接通过命令行传入配置里的其他项作为默认值生效python run.py -c config.yml \ -u https://www.douyin.com/video/7604123456789012345 \ -t 8 \ # 覆盖并发数为 8 -p ./Downloaded # 覆盖下载目录v.douyin.com短链会自动解析无需手动还原。用法三只追新增内容增量下载适合定期同步关注的账号。开启increase并保证database: true增量依赖数据库记录increase: post: true # 已下载过的作品自动跳过只下新发布的 database: true另外两个轻量场景--search 关键词按关键词搜索并导出 JSONL 到Downloaded/search/--hot-board 30导出热搜榜快照到Downloaded/hot_board/都只跑一条命令即可。批量下载完成后输出目录长这样folderstyle: true时Downloaded/ ├── download_manifest.jsonl # 下载清单 └── 作者名/ ├── post/ │ └── 2024-02-07_作品标题_aweme_id/ │ ├── ...mp4 # 无水印视频 │ ├── ..._cover.jpg # 封面 │ ├── ..._music.mp3 # 背景音乐 │ └── ..._data.json # 元数据 └── like/ mix/ music/ ... # 其他模式同理关键配置项说明以下是config.yml中最影响体验的几项其余保持默认即可thread: 5 # 并发下载数网络一般时降到 2~3 retry_times: 3 # 失败重试次数指数退避 1s/2s/5s proxy: # 代理地址如 http://127.0.0.1:7890无代理留空 video_quality: highest # 画质档original 探测原片 / highest 最高转码档 / lowest 省流量 / 指定 720p 等 database: true # SQLite 去重与历史记录增量模式依赖它 progress: quiet_logs: true # 进度阶段静默日志减少刷屏配置项作用建议thread并发下载线程数默认 5大量下载或网络不稳时调低video_quality码率档位选择日常用highest需要原片用original每条多一次探测请求browser_fallback.headless浏览器兜底是否无头运行保持false翻页被限时需人工过验证码increase.*各模式增量开关定期同步账号时开启comments.enabled是否采集评论需要评论数据时开max_comments控制上限start_time/end_time时间过滤YYYY-MM-DD只抓某时间段的作品时使用工具内部默认速率限制为 2 请求/秒一般不需要额外调参。常见问题排查Cookie 失效接口报登录类错误现象批量下载中途失败或提示需要登录原因抖音登录态有时效Cookie 过期解决重新执行python -m tools.cookie_fetcher --config config.yml登录后按 Enter 即可避免短时间内反复重新登录只能抓到 20 条左右的作品就停了现象主页作品多但下载列表卡在 20 条附近原因翻页触发风控接口分页被限制解决确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证不要立即关闭窗口重新运行任务作品却被跳过了现象想重下某个作品程序显示已存在直接跳过原因程序同时检查数据库记录和本地文件名中的aweme_id两者任一命中即跳过解决删文件不够还要清数据库记录例如sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;全部重下则连dy_downloader.db一起删进度条刷屏日志很难看现象终端输出大量重复的进度行原因进度阶段日志未静默解决确认progress.quiet_logs: true需要排查问题时再临时加-v或--show-warnings参数写在最后这套工具适合三类人需要批量备份/研究某个账号内容的研究者需要定期同步关注的博主新作品的运营以及需要无水印素材与结构化元数据的创作者。接下来你可以克隆仓库并安装依赖用number.post: 1跑一次单条下载验证环境用tools.cookie_fetcher获取 Cookie把number.post调大正式批量下载打开increase.post: true配置定时任务做周期性增量同步请仅将本工具用于个人学习、研究与个人数据管理尊重创作者版权不要用于侵犯他人合法权益的用途。【免费下载链接】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），仅供参考