如何快速上手抖音批量下载工具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 数据库去重和浏览器兜底适合想把创作者内容备份到本地的普通用户也适合需要自动化脚本的技术用户。 项目一览项目说明项目类型命令行下载工具另有内测中的桌面版 Douzy基于同一套后端主语言Python要求 3.9 及以上开源协议MIT License核心能力单个作品下载、作者主页批量下载、无水印视频、SQLite 去重、增量下载、直播录制、评论采集运行方式本地python run.py运行或打包为 Docker 镜像部署可选扩展REST API 服务模式、视频转写、Bark / Telegram 完成通知下面用到的 4 张截图来自配套桌面版 Douzy 的界面内测中命令行版的输出结构与它们一致。 快速上手跑通一次只需要 4 步克隆安装、复制配置、获取 Cookie、发起下载。第一步克隆项目并安装依赖。执行完会在本地得到完整代码并装好 aiohttp、rich、PyYAML 等运行时依赖。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt第二步复制配置文件。仓库提供了config.example.yml模板复制后所有参数都有可参考的默认值。cp config.example.yml config.yml第三步获取 Cookie。这条命令会打开一个浏览器窗口你扫码登录抖音后回到终端按 EnterCookie 会自动写入config.yml。python -m tools.cookie_fetcher --config config.yml第四步发起第一次下载。把config.yml里的link改成任意一个抖音视频链接然后运行下面的命令。python run.py -c config.yml跑完后终端会显示 Rich 进度条文件落在./Downloaded/目录下默认按“作者名 / 模式 / 作品”分层存放视频自动挑选无水印源。桌面版 Douzy 的链接下载工作台粘贴视频、图文、主页或合集链接即可识别并开始下载 功能实战批量下载作者主页作品这是最常用的高频场景你关注了一位创作者想把他发布的作品全部存下来。把link换成作者主页地址mode指定postnumber.post设为 0 表示不限数量。link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 作者主页链接 mode: - post # 下载发布的作品 number: post: 0 # 0 表示下载全部桌面版的关注管理页同步博主列表标记有新作品的账号后一键下载跑完后该作者的全部作品会归档在Downloaded/作者名/post/下。再次运行同一配置时由于默认开启database: true和increase.post: true数据库记录过的作品会被跳过只下载新增内容这就是它的增量模式。按时间范围过滤作品如果你只关心某位博主最近一个季度的内容用start_time和end_time划出区间即可格式为YYYY-MM-DD。start_time: 2026-06-01 # 只下载此日期之后发布的作品 end_time: 2026-08-31 # 以及此日期之前发布的作品配合上一个场景的作者主页链接使用工具只抓取区间内发布的作品翻页效率明显提升。下载自己账号的收藏夹想备份个人收藏时把链接指向https://www.douyin.com/user/self?showTabfavorite_collection模式填collect收藏夹视频或collectmix收藏合集。link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect # 收藏夹视频下载收藏合集则用 collectmix number: collect: 0桌面版“收藏与喜欢”页同步当前账号的收藏合集可整合集批量下载注意两点这个模式只认当前 Cookie 对应的登录账号collect/collectmix必须单独使用不能和post、like等模式混写。录制直播把link指向live.douyin.com/{房间号}即可开始录制主播下播、断网或按 CtrlC 中断时已录到的字节都会保留成正式文件。link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 最多录 1 小时填 0 则录到主播下播文件保存在Downloaded/{作者}/live/下FLV 格式可直接播放并附带一个*_room.json直播间元数据快照。桌面版任务中心批量任务按状态筛选可打开目录、查看详情或重试失败项⚙️ 关键配置说明平时最常改动的是下面这几项都在config.yml里配置项含义示例值link要下载的链接可写多条作者主页或视频链接mode下载模式主页场景用post/like/mix/music[post]number.post该模式下载数量上限0 表示不限50start_time/end_time按发布时间过滤格式YYYY-MM-DD2026-06-01thread并发下载数默认 53网络差时调小video_quality画质档位默认highest最高转码档original探测原片database启用 SQLite 去重与历史默认truetrue完整参数清单见 config.example.yml每个配置项旁边都有中文注释。 进阶玩法REST API 服务模式。先执行pip install fastapi uvicorn再用python run.py --serve --serve-port 8000启动。启动后POST /api/v1/download提交链接、GET /api/v1/jobs/{job_id}查询状态适合把下载能力嵌进你自己的自动化系统。Docker 部署。仓库自带 Dockerfile先docker build -t douyin-downloader .构建镜像运行时把config.yml和Downloaded目录挂载进去即可。服务器无人值守跑增量下载时这套方式最省事。热搜榜与关键词搜索。这两条命令不依赖配置文件python run.py --hot-board 30 -p ./Downloaded抓取热搜榜前 30 条python run.py --search 关键词 --search-max 100 -p ./Downloaded按关键词搜作品。结果都以 JSONL 文件落到输出目录方便二次加工。️ 避坑指南现象某作者只能抓到 20 条作品翻页就停了。原因抖音对翻页请求触发了风控。解决保持browser_fallback.enabled: true且headless: false弹窗出现后手动完成验证别急着关窗口。现象下载报 403 或提示未登录。原因Cookie 过期有效期通常只有 7 到 15 天。解决重新执行python -m tools.cookie_fetcher --config config.yml获取新 Cookie。现象删了数据库记录重新运行却不下载。原因去重是数据库加本地文件双重判断文件还在就会被跳过。解决同时删掉本地对应目录和数据库记录只删文件反而能触发重新下载。现象进度条下方日志反复刷屏。原因调试参数打开了 info 级别日志。解决保持默认progress.quiet_logs: true不要随手加-v需要排错时再临时加--show-warnings。现象开了转写却没有生成 transcript 文件。原因转写只对视频作品生效图文不会生成密钥无效也会静默跳过。解决确认transcript.enabled: true且OPENAI_API_KEY环境变量有效图文内容无需处理。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），仅供参考