3 分钟上手 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刷到一个喜欢的创作者想把他主页 200 条视频全部存下来慢慢看结果手动一条条复制、再找个网页去水印工具折腾一小时才下了 5 条——这个场景douyin-downloader 就是用来终结的。它是一个开源的抖音批量下载工具主打去水印保存、作者主页整页抓取支持视频、图文、合集、音乐、直播录制等多种类型命令行跑一次就能把一整个主页端回家。桌面客户端里从关注列表就能看到每位博主的下载状态点击即可发起批量下载。先解决一个现实问题下载抖音内容到底卡在哪官方 App 没有下载按钮网页版右键又拿不到真实视频地址。市面上能用的工具不少但多数要么是网页版一次只能下一条、要么要付费解锁数量、要么去水印后画质缩水。你要的是一个能自托管、能跑脚本、能全量抓取的东西而 douyin-downloader 把这几件事一次性做完了去水印自动挑选无水印视频源并且从码率数组里挑最高清的那一档整页抓取输入作者主页链接作品、点赞、合集、音乐四种模式一次拉全防重SQLite 记录 本地文件双重去重重复运行不会产生垃圾文件兜底接口被风控翻不了页时自动拉起浏览器人工过验证码。一句话概括它把下载抖音内容从手工活变成了配置一次、之后躺着跑的事。动手之前需要准备的几样东西项目要求操作系统Windows / macOS / Linux 均可Python3.8 及以上用python --version确认网络能正常访问抖音即可不要求特殊网络环境Cookie抖音账号登录态下文有自动获取方式磁盘视频按原始画质保存批量下载前先留够空间三分钟跑通第一条下载命令第一步拉代码并进入项目目录。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader第二步安装依赖。pip install -r requirements.txt想用浏览器兜底功能翻页风控时自动弹浏览器再多装一个 Playwrightpip install playwright python -m playwright install chromium第三步复制配置模板并获取 Cookie。cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml运行第二条命令会打开一个浏览器窗口登录抖音后回到终端按回车Cookie 就自动写进配置文件了。这是全流程里唯一需要手动操作的一步之后都是全自动。第四步把链接填进配置跑起来。python run.py -c config.yml首次建议先用单视频链接试水——把config.yml里的link改成你想下的视频地址link: - https://www.douyin.com/video/7604129988555574538看到终端里出现下载进度条和下载完成的提示你的第一条无水印视频就存到./Downloaded/里了。一张表看清它能下载什么能力对应命令/配置适用场景单个视频 / 图文-u https://www.douyin.com/video/...收藏了某条想单独存下来单个合集-u https://www.douyin.com/collection/...追某个系列教程单个音乐原声-u https://www.douyin.com/music/...保存喜欢 BGM 及该音乐下作品作者主页全部作品主页链接 mode: [post]备份创作者、竞品分析作者点赞列表主页链接 mode: [like]看对方收藏了什么好内容作者合集 / 音乐主页链接 mode: [mix, music]一次抓全作者的内容体系直播录制-u https://live.douyin.com/房间号录下完整直播下播自动保存热搜榜 / 关键词搜索python run.py --hot-board 30/--search 关键词数据采集、选题调研REST API 服务python run.py --serve --serve-port 8000把下载能力接进自己的程序三个真实场景实操场景一把整个作者主页搬回家这是使用频率最高的操作。把主页链接和模式写进config.ymllink: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like - mix - music number: post: 50number.post: 50表示只下最新 50 条改成0就是全量。四种模式同时开启时同一个视频只会下载一次跨模式自动去重。批量下载时多个作品并发拉取进度逐条推到 100%耗时一目了然。小提示第一次建议先设个数量上限比如 20试跑确认命名和目录结构符合预期再放开全量。场景二录一场直播改配置即可link: - https://live.douyin.com/273940655995 live: max_duration_seconds: 0 # 0 录到主播下播 idle_timeout_seconds: 30开播前跑起来工具会解析直播间并自动选择清晰度主播下播、断流或你按 CtrlC已录制的部分都会保留成正式文件不会白白丢掉。录制产物存在Downloaded/作者名/live/下还附带一份直播间元数据快照。场景三抓热搜榜和搜索结果不下载视频只想要数据python run.py --hot-board 30 -p ./Downloaded python run.py --search 露营 --search-max 100 -p ./Downloaded结果分别以 JSONL 格式落在./Downloaded/hot_board/和./Downloaded/search/下时间戳命名方便后续接进分析流程。值得花时间的三个调优点1. 并发数从 5 提到 10速度翻倍但别贪默认并发 5、每类请求限速 2 次/秒。家庭宽带下调整thread 值效果调整前5稳定但偏慢几百条视频要等很久调整后10速度明显提升多数网络无压力不建议20触发风控概率上升得不偿失2. 增量下载让更新变成秒级操作作者每天发新视频你不想每次全量重下increase: post: true database: true跑过一次后第二次只拉新作品。增量模式依赖 SQLite 记录所以database必须开着。3. 命名模板决定你以后好不好找文件config.example.yml里预置了模板变量至少保留{id}防止重名覆盖filename_template: {date}_{title}_{id} folder_template: {date}_{title}_{id} author_dir: nickname_uidauthor_dir建议选nickname_uid——只用昵称时作者改名会让历史文件分家带上 sec_uid 就稳了。调整后生成的文件结构大致是Downloaded/ └── 作者名_sec_uid/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 2024-02-07_作品标题_aweme_id.mp4 ├── 2024-02-07_作品标题_aweme_id_music.mp3 ├── 2024-02-07_作品标题_aweme_id_cover.jpg └── 2024-02-07_作品标题_aweme_id_data.json桌面版里命名模板可视化配置变量选择、作者目录策略一目了然命令行版同名配置可参考。新手最常见的四个报错与自救现象只抓到 20 条作品就停了翻页翻不动。原因主页分页接口被风控属于平台常规限制。 办法确保browser_fallback.enabled: true且headless: false重跑后浏览器窗口弹出时手动完成验证不要急着关窗口抓完自动继续。现象下载到一半提示文件不完整或文件损坏打不开。原因网络波动导致传输中断。 办法工具内置完整性校验会用 Content-Length 比对不完整的文件自动清理并重试。多数情况重跑一次就能补齐无需手动删文件。现象跑着跑着开始报登录失效、拿不到数据。原因Cookie 过期了抖音登录态有时效。 办法重新执行python -m tools.cookie_fetcher --config config.yml一分钟内刷新完成。现象重复下载、增量不生效。原因去重靠数据库记录 本地文件名双通道只删其中一边都会导致判断错位。 办法想重下某个作品把对应的本地目录和数据库里的aweme_id记录一起清掉再跑一次。什么都不删就直接重跑工具默认跳过已存在的文件。想深入一点这些模块值得看完整功能清单与配置说明在 douyin-downloader/README.zh-CN.md包括转写、通知推送、REST API 等进阶用法全部配置项注释在 douyin-downloader/config.example.yml比文档更直观想改源码从 douyin-downloader/core/ 入手下载主流程、URL 解析、API 客户端都在这里cli/是命令行入口storage/管文件和 SQLiteauth/管 Cookie 与 token项目自带 70 自动化测试跑pytest -q可以验证环境没问题不习惯命令行的用户桌面客户端 Douzy 与命令行共用同一套后端截图存放在 douyin-downloader/img/desktop/任务状态、历史档案这类能力在图形界面里更直观。SQLite 历史记录沉淀成作品档案按作者、关键词、时间范围筛选随时重新下载。写在最后一句话记住它douyin-downloader 把抖音内容保存变成了一条命令的事——去水印、全量抓取、断点重试、增量更新全都在本地可控。下一步很明确clone 代码、装依赖、跑一次单视频命令把第一个作品下下来。工具是开源的代码就摊在眼前数据存哪、存成什么样都由你说了算。从今天起你的抖音收藏夹不必再依赖平台的服务器。【免费下载链接】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），仅供参考