免费开源的douyin-downloader怎么用?抖音批量下载完整上手教程

📅 2026/8/15 12:52:48
免费开源的douyin-downloader怎么用?抖音批量下载完整上手教程
免费开源的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 就是为这类场景准备的免费开源工具它覆盖视频、图文、合集、音乐和直播回放支持作者主页批量下载、去水印、最高清择优用一条命令就能把一整个主页搬回本地硬盘。30 秒速览这个工具到底能做什么先花 30 秒建立整体印象下面是它的核心能力一览。维度具体能力内容类型视频、图文、合集、音乐原声、直播回放、作者主页、收藏夹链接支持短链自动解析v.douyin.com 等、视频/图文/合集/音乐单条链接下载质量无水印优先按码率自动挑选最高清版本批量能力作者主页 post/like/mix/music 四种模式并发下载防重复SQLite 数据库 本地文件双重去重支持增量下载稳定性失败指数退避重试、下载完整性校验、浏览器兜底附加功能评论采集、热搜榜、关键词搜索、REST API、完成通知推送它适合做什么长期追更某个创作者、搭建个人内容资料库、保存直播回放、批量整理自己的收藏与点赞。它不适合做什么不适合把它当作破解会员或规避平台规则的工具——它面向个人学习与数据管理请尊重版权。三个真实场景功能是怎么帮你省事的与其罗列功能清单不如看看三个日常场景里它能替你做掉多少琐事。场景一想把一位创作者的全部作品存下来这是使用频率最高的场景。你只需要把对方主页链接填进配置文件再告诉工具要下载哪些内容发布作品、点赞列表、合集还是音乐。link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 博主主页链接 path: ./我的收藏/ mode: - post # 发布的作品 - like # 点赞过的作品 - mix # 合集内容 - music # 音乐作品 number: post: 50 # 每个模式最多下载多少条0 表示不限 like: 20工具会自动按作者名 → 内容类型建好目录每个作品单独成文件夹视频、封面、音乐、元数据各归其位。跨模式还会自动去重——同一个作品在 post 和 like 里都出现时只下载一次。上图为批量下载合集作品时的实时进度多条任务并行处理每条进度一目了然。场景二直播没看够回放想留一份知识分享直播结束后往往没法回看错过就是错过。把直播链接填进配置douyin-downloader 会以 FLV/HLS 流的形式录制整场直播支持设定录制时长上限主播中途下播或网络空闲时已经录下的数据也会自动保留不会白录。link: - https://live.douyin.com/273940655995 # 直播间链接 live: max_duration_seconds: 3600 # 0 一直录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30 # 空闲多久视为结束录完的文件会存放在下载目录/作者名/live/下同时附一份*_room.json记录直播间信息方便日后回查。命令行会先解析直播信息标题、在线人数、清晰度选项再拉起对应质量的直播流。场景三内容越攒越多怎么避免乱成一团下载数量过百后最头疼的就是找不到、分不清、重复下。这个工具的答案是把管理做进下载流程里SQLite 记录每个作品连同标题、作者、发布时间、保存路径写入本地数据库随时能查下载历史。智能命名文件名和目录默认带发布日期前缀如2024-02-07_作品标题_aweme_id按时间排序即按发布顺序。时间过滤start_time/end_time只下载指定日期区间的内容。评论采集开启后可把每个作品的评论导出为*_comments.json方便做内容分析。配套桌面版提供了作品档案视图可以按作者、关键词、时间筛选历史记录还能一键下载某位博主的最新作品。从 0 到 1douyin-downloader快速安装方法下面是一套完整可照做的流程从环境准备到跑通第一次下载。第 1 步获取代码并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt需要 Python 3.8 及以上版本macOS / Linux / Windows 均可。第 2 步生成配置文件cp config.example.yml config.yml然后编辑config.yml填入你的目标链接和保存路径。第 3 步完成身份认证抖音接口需要有效的 Cookie。项目提供了自动获取方式运行后会自动打开浏览器python -m tools.cookie_fetcher --config config.yml在浏览器里登录抖音回到终端按 Enter程序会把 Cookie 自动写入配置不需要手动复制粘贴。第 4 步运行并观察结果python run.py -c config.yml也可以临时追加参数覆盖配置比如指定单条链接、调整并发数python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538 -t 8 -p ./Downloaded下载完成后控制台会汇总成功/失败数量与耗时每个作品独立成目录媒体文件与元数据按规则存放。可以看到每个文件夹以日期 标题命名作者的全部内容整齐归档查找非常直观。三个进阶玩法让它帮你省下更多时间基础流程跑通后下面几个能力能进一步解放你的双手。增量下载只补新的不碰旧的长期追更某位作者时重复下载很浪费流量和磁盘。开启增量模式后程序会对照数据库和本地文件只下载之前没有的内容increase: post: true # 只下载新发布的作品 like: true database: true # 增量依赖数据库记录它省下的是反复下载的等待时间、被重复占用的存储空间。完成通知下载完自动告诉你批量任务动辄几分钟到几十分钟不用一直盯着终端。开启通知后任务结束会推送到你的手机或群机器人notifications: enabled: true on_success: true on_failure: true providers: - type: bark # 也支持 telegram / webhook url: https://api.day.app/YOUR_DEVICE_KEY它省下的是守在电脑前等进度的注意力。单个通知渠道失败不会阻塞下载主流程。接口化与数据能力融入你的工作流工具内置了 REST API 服务模式和热搜榜/搜索能力。运行python run.py --serve --serve-port 8000后就可以通过 HTTP 接口提交下载任务、查询任务状态方便接入自己的自动化脚本。--hot-board 30可以导出热搜榜快照--search 关键词则按关键词搜索作品并落盘为 JSONL便于后续数据分析。python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded配套桌面版把命名模板等常用配置做成了可视化界面想自定义{date}_{title}_{id}这类规则时不用再翻文档。避坑速查表常见问题一次说清问题原因解决办法只能抓到 20 条作品翻页触发平台风控确认browser_fallback.enabled: true且headless: false浏览器弹出验证时手动完成别急着关窗口下载速度偏慢并发数或网络受限调大thread如 5 → 8配置proxy代理选网络空闲时段下载Cookie 失效报错登录态过期重跑python -m tools.cookie_fetcher --config config.yml想重新下载某条作品双重去重机制拦截删除对应本地文件并执行sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id...;控制台日志刷屏进度日志过多保持progress.quiet_logs: true排查时再临时加-v参数没生成转写文件转写未开启或密钥无效检查transcript.enabled、视频类型图文不转写、OPENAI_API_KEY是否有效它适合谁给你一份选择建议如果你符合以下任意一条这个工具大概率值得一试追更型用户常逛的作者更新频繁想定期把新作品归档资料收集型用户把抖音当学习/素材来源需要按作者和主题整理内容库直播回看需求者经常错过直播、想留存回放反复学习轻度开发爱好者想通过 REST API 把下载能力接进自己的自动化流程。反过来如果你只是偶尔保存一两个视频手动操作已经够用工具的前期配置对你来说性价比不高。下一步从第一条命令开始动手成本其实很低三条命令就能跑起来git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt python -m tools.cookie_fetcher --config config.yml认证完成后把想保存的主页链接写进config.yml运行python run.py -c config.yml剩下的交给并发队列和进度条。最后提醒一句请遵守平台规则、尊重创作者版权下载内容仅用于个人学习与研究。工具本身是开源的遇到问题时可以查看项目内的config.example.yml注释、USAGE.md使用说明以及core/、storage/等模块源码理解它的工作方式后再放心使用。让精彩内容留在你的硬盘里也留在你的学习清单上。【免费下载链接】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),仅供参考