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 是面向抖音的无水印批量下载工具支持主页作品批量采集、日期与数量筛选、断点补下与 SQLite 去重提供命令行与桌面两种入口。能力边界它能做什么不能做什么支持无水印下载视频/图文作品可附带封面、音乐、头像与原始 JSON支持用户主页发布作品批量下载post 模式翻页受限时走浏览器兜底支持like / mix / music / collect 四种扩展模式支持评论采集、热搜榜与关键词搜索输出 JSONL支持直播录制实验功能HLS 源仅保存播放列表不是可直接播放的视频限制命令行版仅支持抖音TikTok、YouTube 等平台只在 Douzy 桌面版提供限制2026-08 起抖音风控Argus已拦截单视频、合集、音乐、点赞、收藏等接口主页作品可尝试 Playwright 浏览器兜底但不保证成功下载内容仅建议用于个人学习与数据管理请遵守平台条款与版权规定。环境准备与首次运行三步走克隆仓库git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader安装依赖需 Python 3.9Windows/macOS/Linux 均支持python -m pip install -r requirements.txt配置 Cookie。抖音接口需要登录态仓库自带浏览器自动抓取脚本cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml注意弹出浏览器完成抖音登录后回到终端按 Enter 保存 Cookie若自动抓取失败从浏览器开发者工具复制 Cookie 字符串粘入配置文件即可。配置即工作流读懂 YAML 里的关键参数日常任务基本由一份 YAML 决定行为最常用字段如下link: - https://www.douyin.com/user/MS4wLjABAAAAxxx path: ./Downloaded/ mode: [post] number: post: 10 start_time: 2024-01-01 end_time: 2024-12-31 thread: 5 video_quality: highest increase: post: true字段含义link链接列表主页 sec_uid、单视频、v.douyin.com 短链、合集均可path保存根目录filename_template控制命名模板须含{id}防重名覆盖modepost 发布作品 / like 点赞 / mix 合集 / music 音乐 / collect 收藏number.post各模式下载数量上限0表示不限start_time/end_time作品发布时间范围YYYY-MM-DD含结束日当天thread并发下载线程数默认 5另有rate_limit控制每秒请求数video_qualityhighest最高转码档 /original原画探测失败自动回退/ 指定分辨率increase.post增量下载开关跳过已下载过的作品完整字段与默认值可对照仓库内 配置默认值 查阅。两种入口两种节奏早期版本是 DouYinCommand.py单条与 downloader.py批量两个脚本现在统一为run.py两种节奏靠参数区分。单条链接、临时补一条用-u现追加不动配置文件python run.py -u https://v.douyin.com/xxxx批量抓主页、按日期/数量筛选走配置文件驱动-v输出详细日志-t、-p可临时覆盖线程数与目录python run.py -c config.yml -v桌面客户端给不想碰终端的人Douzy 桌面版的流程就是三句话粘贴链接、点击检测链接确认内容类型、开始下载。除抖音外Douzy 还支持 TikTok、YouTube、Telegram、X 的公开内容批量下载部分批量与高级功能需要激活关注列表同步直接从抖音账号拉取关注博主勾选后要采集的主页任务中心逐任务查看进度、统计与失败日志失败任务可单独重试作品档案本地 SQLite 记录下载历史可按作者、标题、时间筛选与去重进阶玩法直播录制、评论抓取与热搜搜索直播录制把link指向https://live.douyin.com/{room_id}后按常规命令运行即可由直播间链接自动触发。live.max_duration_seconds: 0表示录到主播下播idle_timeout_seconds用于断流超时退出。评论采集在配置中打开开关后每个作品额外生成*_comments.json含评论内容、用户、点赞数与回复关系comments: enabled: true max_comments: 0热搜榜与关键词搜索是独立子命令结果直接落盘为 JSONL便于后续分析python run.py --hot-board 30 python run.py --search 美食教程 --search-max 50落盘规则与元数据默认目录结构按「作者/模式/发布时间_标题_作品ID」组织Downloaded/ ├── download_manifest.jsonl └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 2024-02-07_作品标题_aweme_id.mp4 ├── 2024-02-07_作品标题_aweme_id_cover.jpg └── 2024-02-07_作品标题_aweme_id_data.json目录日期取作品发布时间create_time缺失时回退当前日期并告警。除单作品的_data.json外根目录的download_manifest.jsonl是 append-only 的总清单每行一条 JSON常用字段aweme_id作品唯一 ID去重与增量判断的依据author_name/desc作者昵称与作品描述date发布时间与目录命名保持同一时间基准tags从text_extra、cha_list与描述中的#聚合方便按话题检索核心下载与落盘逻辑集中在 core/排查命名与跳过行为时可从这里入手。SQLite 库默认dy_downloader.db只记录作品明细与任务历史不参与增量判断。踩坑速查问题原因处理下载报风控/需要验证抖音 Argus 风控拦截接口与重试次数无关重跑python -m tools.cookie_fetcher --config config.yml更新 Cookie换 Cookie 仍被拦时保持browser_fallback.enabled: true、headless: false在浏览器里人工完成验证主页只抓到少量作品API 分页受限且兜底未触发确认browser_fallback已开启必要时调大max_scrolls避开高峰时段重试中断后部分文件缺失网络抖动导致未落盘完整用同一配置重跑redownload_missing_files: true会自动补下缺失的主文件同一作品被重复下载increase被关或数据库记录丢失保持increase.post: true且database: true重下覆盖时再改false无需清空数据库速度慢、频繁超时服务端对并发有限流将thread降到 3确认retry_times: 3或在proxy配置代理仓库地址 gitcode.com/GitHub_Trending/do/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），仅供参考