抖音视频批量下载实战用 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面对五花八门的抖音下载工具多数人的第一反应是能下就行。可真到了要用的时候问题就来了有的只能下单个视频有的下载到一半就断有的翻几页就被风控拦住。选工具不能只看能不能下更要看它能不能扛住真实使用场景。本文要讲的 douyin-downloader正是一个把下载、去重、直播录制、自动化通知都打包好的开源方案。如果你有批量整理抖音素材的需求这篇文章会告诉你它到底值不值得用、以及怎么用才顺手。先看全景一个下载器要解决哪四类问题在动手之前先把该不该用想清楚。判断一个抖音批量下载工具是否合格可以从四个维度检验它们恰好对应了 douyin-downloader 的核心能力问题类型具体场景工具对应能力单条保存刷到一个好视频、图文、音乐想存下来视频/图文/合集/音乐/短链自动解析整页搬运想把某个作者的作品、点赞、合集一次拉完作者主页批量下载post/like/mix/music 多模式时效性内容直播错过就没了官方不一定有回放FLV/HLS 直播录制下播自动保留长期维护越下越多重复占空间、目录混乱SQLite 去重、增量下载、规范化命名这四个维度按从简单到复杂排列正好也是一条学习路径。后面的内容就顺着这条路径逐层展开读完你就能从零搭起一套完整的抖音素材流水线。第一部分五分钟跑通最小闭环很多教程喜欢把装环境和第一次下载拆成两篇文章讲其实对新手最友好的做法是把它们连成一个流程一口气跑通。全程只需要四步。第一步拿到代码并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt注意项目目录结构克隆下来后主程序在douyin-downloader子目录里后面所有命令都要在这个子目录下执行。环境要求是 Python 3.8 以上Windows、macOS、Linux 均可。第二步准备身份认证抖音的接口需要登录态手动去浏览器开发者工具里翻 Cookie 又麻烦又容易复制不全。工具提供了一个自动获取的方式需要先装 Playwrightpip install playwright python -m playwright install chromium然后复制一份示例配置执行自动获取cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml运行后会弹出一个浏览器窗口你正常登录一次抖音回到终端按一下回车程序就会把认证信息写进配置。整个过程不用碰任何技术细节。第三步写一份最小配置link: - https://www.douyin.com/video/7294250369037542671 # 想保存的视频 path: ./Downloaded/ mode: - post # 下载发布的作品 number: post: 1 thread: 5 # 并发线程数 database: true第四步执行第一条下载命令python run.py -c config.yml想临时换链接也可以直接用参数指定python run.py -c config.yml -u https://www.douyin.com/video/7294250369037542671跑完后Downloaded/目录里会出现一个以日期和标题命名的文件夹里面包含视频本体、封面图、背景音乐和一份 JSON 元数据。从零到第一次下载成功前后不过五分钟。第二部分按素材类型逐层深入最小闭环跑通之后就该按素材类型逐级解锁更复杂的需求了。这一部分采用从最常遇到到最进阶的梯度一步步来。第一层单个视频与图文一条命令的事这是使用频率最高的场景——刷到一个喜欢的作品顺手存下来。视频、图文图集都支持链接可以直接贴分享出来的短链程序会自动解析python run.py -c config.yml -u https://v.douyin.com/your_short_link默认会优先下载无水印版本并自动挑选最高清的视频源。下载后除了媒体文件本身还会附带封面、音乐和原始 JSON 元数据方便日后回溯这个作品的全部信息。第二层合集、音乐与作者主页一份配置全搞定单个下载只是热身。当你想把一位创作者的整页内容存下来时手动操作的工作量会迅速劝退——而这个场景恰好是批量下载的主场。把配置改成作者主页链接并声明要下载的素材类型link: - https://www.douyin.com/user/MS4wLjABAAAAf9d8s7g6h5j4k3l2 # 作者主页 path: ./我的素材库/ mode: - post # 发布的作品 - like # 点赞过的作品 - mix # 合集内容 - music # 使用的原声 number: post: 60 # 拉取 60 个发布作品 like: 0 # 0 表示不限制数量程序会按作者名自动建目录把不同来源的素材分门别类存放我的素材库/ └── 作者昵称_MS4wLjABAAAAf9d8s7g6h5j4k3l2/ ├── post/ # 发布的作品 ├── like/ # 点赞的作品 ├── mix/ # 合集内容 └── music/ # 音乐作品批量下载时进度界面会实时显示每个文件的状态已经存在的内容自动跳过多个线程并发拉取你只需要在旁边等结果。第三层直播回放自己动手录直播是时效性最强的内容形态——结束就是结束官方未必有回放。对于知识分享、教学、赛事这类内容错过一场可能再也补不回来。这时用直播录制功能在配置里加上直播间链接link: - https://live.douyin.com/273940655995 live: max_duration_seconds: 0 # 0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30 # 空闲超时保护运行后程序会解析出直播流地址支持 FLV 和 HLS 两种格式并自动读取直播标题、在线人数和清晰度选项。即使主播中途下播、网络断开或者你按 CtrlC 中断已经录下的内容也会自动保留不会白录一场。录好的文件存在Downloaded/作者名/live/目录下并附一份直播间信息快照。第三部分把维护成本交给工具批量下载最怕什么重复下载和目录失控。同一个视频今天下过、明天换个模式又下一遍硬盘白占空间找文件还费劲。这一部分的核心思路是下载是开始整理才是长期工作而这部分工作完全可以交给工具。用数据库当账本拒绝重复入库工具内置 SQLite 去重配合本地文件做双重检查。同一个作品无论从哪个模式进来都会被记录在案不会重复下载database: true # 开启数据库去重和历史记录 database_path: dy_downloader.db想查看下载历史一条 SQL 就能查到sqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;增量模式只补新内容开启增量下载后工具会记录上次下载的进度再次运行只补新发布的作品而不是全量重来increase: post: true like: true mix: true命名模板让目录自己变整齐文件名和文件夹名支持自定义模板变量包括日期、标题、作者、ID 等。例如{date}_{title}_{id}会生成2024-12-30_作品标题_7294250369037542671这样的结构一眼就能定位内容。每个作品单独一个文件夹日期、标题、作者信息一目了然。第四部分让工具自动化替你值班基础功能用顺之后你会发现这个工具真正值钱的地方在于无人值守——把规则设定好剩下的事它自己办。四个开关分别解决四类人在旁边守着的场景。① 时间过滤只收指定时间段的内容start_time: 2024-06-01 end_time: 2024-08-31适合只想整理某段时间发布的素材比如只补某个项目的所有相关内容。② 完成通知下完不用干等批量下载动辄几十分钟与其盯着屏幕不如让结果自己找上门。支持 Bark、Telegram以及企业微信、飞书、钉钉这类 Webhook 机器人notifications: enabled: true on_success: true on_failure: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY下载完成或失败手机立刻收到一条带统计数字的推送。③ 热搜榜与关键词搜索不打开 App 也能追热点python run.py --hot-board 20 # 拉取抖音热搜榜前 20 条 python run.py --search 烘焙教程 --search-max 80 # 搜索关键词相关内容结果以 JSONL 文件导出后续做内容选题或数据分析都很方便。④ REST API 服务模式把下载能力接口化如果想把下载能力集成到自己的系统里可以先安装可选依赖再以服务模式启动pip install fastapi uvicorn python run.py --serve --serve-port 8000启动后就能通过 HTTP 接口提交下载任务、查询任务状态适合有自动化需求的进阶玩家。第五部分新手高频翻车点速查实践中最常见的问题就那么几个这里用一张表集中说明遇到时直接对照处理。问题现象常见原因解决办法只能抓到 20 条作品抖音翻页风控确认配置里browser_fallback.enabled: true翻页受限时弹出浏览器窗口手动过一下验证码别急着关Cookie 失效、提示未登录登录态过期重新跑python -m tools.cookie_fetcher --config config.yml几十秒刷新下载速度慢并发数太低或时段不佳把thread从 5 调到 8 左右同时尽量在网络状况好的时段运行文件命名混乱未配置命名模板用filename_template和folder_template指定{date}_{title}_{id}等组合翻页后重复抓取没开去重保持database: true再配合增量模式只补新内容第六部分还有桌面版和你的三步启动清单不想敲命令桌面版 Douzy 正在内测如果你对命令行不感冒项目基于同一套后端做了桌面客户端 Douzy目前处于内测期。粘贴链接就能开始下载任务中心可视化跟踪每个任务的进度和状态文件命名规则也能在设置里点选完成。命令行适合自动化场景桌面版适合日常点选两条路线共用一套内核按自己的习惯选就行。现在就可以做的三件事工具本身不复杂难的只是迈出第一步。给你一份可直接执行的启动清单克隆项目、安装依赖跑通第一部分的前两步执行一次 Cookie 自动获取完成身份认证随便挑一个链接从单个视频下载开始感受一下一条命令收进硬盘的顺畅。最后一句题外话工具让下载变得简单也请把它用在正道上——遵守平台规则尊重创作者版权下载的内容仅供个人学习研究使用。好的工具配上正确的使用方式才能长久地为你服务。下次遇到那个等了好久的视频或者不想错过的直播你已经有办法把它们留住了。打开终端敲下第一行命令属于你的抖音素材库就从今天开始建立。【免费下载链接】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），仅供参考