
抖音作品批量下载从单条到全量收藏的完整指南【免费下载链接】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 的开源抖音批量下载工具输入单条链接、主页链接或合集链接即可无水印批量采集作品、图集、合集与原声音乐并自动按作者和日期整理输出。2. 能力总览支持的链接类型输入输出备注单视频/video/xxx视频、封面、音乐、JSON 元数据无水印源优先自动挑最高码率短链v.douyin.com/...同单视频自动解析真实链接后下载用户主页/user/xxx发布 / 喜欢 / 合集 / 原声批量下载用mode选择模式合集链接/collection/xxx合集内全部作品兼容/mix/xxx形式音乐链接/music/xxx使用该音乐的作品优先原声文件直播链接live.douyin.com/xxxFLV 录制文件实验性下播时保留已录数据关键能力无水印优先自动选择无水印视频源画质可在原画与最高转码档之间选择并发与限速默认 5 个并发线程、约 2 请求/秒均可调整去重与增量SQLite 数据库与本地文件双重去重增量模式只取新作品重试与兜底失败任务自动退避重试翻页受限时可切换浏览器兜底人工过验证附加资源封面、音乐、头像、元数据 JSON、评论按需开关工具以 YAML 配置文件驱动绝大多数功能靠改几个键就能覆盖命令行参数可覆盖配置适合一次性快速任务。桌面客户端 Douzy内测中复用同一套后端提供图形化工作台。3. 环境准备与首次运行需要 Python 3.8支持 macOS、Linux、Windows。3.1 克隆与依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt3.2 配置访问凭证Cookie为什么需要 Cookie抖音接口需要有效登录态才会返回完整作品列表与无水印源这一步不能省略。获取方式有两种自动获取推荐内置工具会打开浏览器你用自己账号登录回到终端按 Enter 即自动写入配置手动获取在已登录抖音网页的浏览器开发者工具里复制 Cookie粘贴到配置的cookies段cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml如果打算使用浏览器兜底翻页受限时才需要再补装pip install playwright python -m playwright install chromium3.3 下载第一个目标把一条想试的视频链接填进配置的link字段然后运行python run.py -c config.yml也可以直接在命令行传入链接并指定输出目录与并发数python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538 -p ./Downloaded -t 5运行后终端会显示下载进度条文件按命名规则存入Downloaded/。想查看更详细的日志加--show-warnings或-v即可。另外也提供了 Dockerfile习惯容器化的话可以直接构建镜像运行。4.1 收藏某创作者的全部发布目的把一个主页下的作品一次性拉到本地不用手动翻页。link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0 # 0 表示不限数量运行后工具按时间顺序翻页拉取作品列表默认 5 线程并发下载封面、音乐按cover、music开关附带保存。默认不抓作者置顶作品需要的话把download_pinned设为 true。如果是自己收藏的作品可以把mode换成collectlink填本人主页链接工具会取 Cookie 所属账号的收藏夹列表。4.2 按时间范围筛选作品目的只采集某个时间段内的作品例如 2024 年发布的全部作品。link: - https://www.douyin.com/user/xxxxx start_time: 2024-01-01 end_time: 2024-12-31过滤依据是作品发布时间区间外的作品不会被请求。时间格式为YYYY-MM-DD留空即该方向不限制。筛出来的作品同样按发布时间命名目录天然按时间排好。4.3 定时增量备份目的定期只取新发布的作品避免重复下载。database: true increase: post: true增量模式依赖数据库记录已入库的作品直接跳过只有新作品进入下载队列。把它和系统定时任务比如 cron配合每天固定时间跑一次就能持续归档新发布的作品。若本地文件被人删掉但数据库仍有记录redownload_missing_files决定是补下还是继续跳过默认补下。5. 性能调优与进阶5.1 调整并发线程数由thread配置控制默认 5。网络稳定时可以试 10加快大批量下载网络一般时建议保持 5避免频繁超时不稳定时降到 3 反而更稳。5.2 混合下载模式mode: - post - like number: post: 0 like: 50上面的配置会同时拉取全部发布作品和最近 50 条喜欢作品跨模式自动去重同一作品只保存一次。5.3 自动重试与浏览器兜底失败请求按 1s、2s、5s 退避自动重试默认 3 次。主页翻页受限时比如只能拉到 20 条把browser_fallback.enabled设为 true工具会弹出浏览器窗口你手动通过验证后它再从断点继续翻页。6. 输出产物说明默认按「作者—模式—作品」三层组织输出每个作品一个独立子目录Downloaded/ └── 作者名/ └── post/ └── 2024-02-07_作品标题_作品ID/ ├── 2024-02-07_作品标题_作品ID.mp4 ├── 2024-02-07_作品标题_作品ID_cover.jpg ├── 2024-02-07_作品标题_作品ID_music.mp3 └── 2024-02-07_作品标题_作品ID_data.json命名规则默认是「发布日期_标题_作品ID」日期取作品发布时间而不是下载时间。去重靠「数据库记录 本地文件」双重检查再次运行时已存在的作品直接跳过文件缺失才补下。根目录还会写一份download_manifest.jsonl下载清单每行一个作品的 JSON方便日后按标签、日期检索。7. 实现简析core/api_client.py— 负责抖音接口请求、签名处理与无水印源挑选core/url_parser.py与core/downloader_factory.py— 识别链接类型并选择下载执行器core/user_modes/— 发布、喜欢、合集、音乐、收藏夹等模式的下载策略auth/cookie_manager.py— Cookie 的加载、解析与写入control/rate_limiter.py、control/retry_handler.py— 速率限制与指数退避重试storage/database.py— SQLite 下载历史与增量去重8. 常见疑问速答8.1 下载的视频有水印吗没有。工具自动优先选择无水印源画质可选原画或最高码率转码档原画文件可能比转码档大数倍可按存储预算选择。8.2 需要登录抖音账号吗需要。完整作品列表和无水印源都依赖有效 Cookie用内置工具扫码登录一次即可自动保存失效后重跑同一条命令。8.3 下载速度大概多快取决于网络。默认 5 线程配置下100 个视频通常需要约 10-30 分钟另需加上列表拉取阶段的时间。8.4 会不会影响账号安全合理使用一般不会。保持默认限速2 请求/秒、不盲目拉高并发即可降低风险遇到验证弹窗时手动通过就行。8.5 一次能下多少个作品number: 0即不限。作品量上千的账号建议分批运行或开启浏览器兜底避免翻页受限中途截断。9. 合规边界本工具仅用于个人学习、研究与自有数据管理。请尊重内容版权不要将下载的作品用于商业再分发并遵守平台规则与相关法律法规。仅用于个人学习研究不用于商业二次创作或传播尊重他人隐私不批量抓取涉及隐私的内容控制下载频率不给平台服务器造成过大压力接口策略变化导致功能失效属于正常技术风险随项目更新跟进10. 行动清单克隆仓库并执行pip install -r requirements.txt安装依赖复制config.example.yml为config.yml运行python -m tools.cookie_fetcher --config config.yml在浏览器完成登录在link填一条单视频链接运行python run.py -c config.yml跑通首个任务确认输出无误后再换成主页链接尝试批量模式最后开启增量并配置定时任务跑通第一个任务后再逐步尝试批量与增量功能配合时间过滤让它匹配你自己的收藏节奏。【免费下载链接】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),仅供参考