douyin-downloader 抖音无水印下载完整指南4步跑通批量存下视频、图集与直播【免费下载链接】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值得试一下它直接走接口拿无水印源支持**视频、图集、合集、音乐原声**四类内容批量下载并附带直播录制、评论采集、热搜导出、完成通知等能力完全免费MIT 协议。它是什么一句话定位 能力分层douyin-downloader 是一个面向个人备份与学习研究的抖音下载工具输入链接单条作品或用户主页它负责解析、下载、去重、重试这一整条链路终端里能看到实时进度和统计。按模块划分它的能力可以看成四层下载层自动选无水印源并按video.bit_rate挑最高码率同时可附带封面、原声、头像和 JSON 元数据。批量层用户主页支持post作品/like喜欢/mix合集/music音乐四种模式跨模式自动去重支持数量限制、增量下载和时间过滤。可靠性层指数退避重试1s/2s/5s、下载完整性校验不完整文件自动清理重下、SQLite 数据库 本地文件双重去重翻页被风控时还能启动浏览器兜底继续滚动加载。扩展层直播录制、评论采集含二级回复、热搜榜与关键词搜索导出 JSONL、Bark/Telegram/Webhook 完成通知、可选的 OpenAI 视频转写以及一键转成 REST API 服务。核心源码在douyin-downloader/core/各类型下载器REST 服务实现在douyin-downloader/server/Cookie 自动获取工具在douyin-downloader/tools/cookie_fetcher.py更完整的说明见douyin-downloader/README.zh-CN.md。10 分钟跑通从安装到第一次下载成功整个过程只有四步其中唯一需要你亲自操作的是一次扫码/输密码登录。第 1 步克隆并安装依赖。要求 Python 3.8 以上macOS / Linux / Windows 均可。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt预期结果依赖装完无报错。注意当前 V2.0 主程序位于仓库的douyin-downloader子目录里仓库根目录另有旧版 V1 脚本以子目录为准。第 2 步装好浏览器内核。这一步既服务于浏览器兜底翻页风控的救命能力也是自动获取 Cookie 的前提建议直接装上。pip install playwright python -m playwright install chromium第 3 步复制配置并自动获取 Cookie。cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml预期结果自动弹出浏览器登录一次抖音后回到终端按回车Cookie 被写入config.yml的cookies段全程不用手动复制字符串。第 4 步填一条链接运行。最小可用配置长这样link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ mode: - post database: true然后执行python run.py -c config.yml预期结果终端出现 Rich 进度条完成后文件落在Downloaded/作者名/post/日期_标题_aweme_id/下附带封面与元数据 JSON。命令行也支持临时追加参数例如python run.py -c config.yml -u 视频链接 -t 8 -p ./Downloaded其中-t指定并发数。实战手册按任务取用复制配置即可下面的每个小节对应一类真实需求给出最小配置与预期结果。所有配置都写在config.yml中link支持一次填多条。下载单个视频、图文、合集或音乐四类单条内容都只需把链接放进link工具会自动识别类型link: - https://www.douyin.com/video/7604129988555574538 # 视频 - https://www.douyin.com/note/7341234567890123456 # 图文 - https://www.douyin.com/collection/7341234567890123456 # 合集 - https://www.douyin.com/music/7341234567890123456 # 音乐短链v.douyin.com/...也能直接解析。音乐链接会优先下载原声文件拿不到原声时自动回退到该音乐下的首条作品。备份某位博主的主页作品含图集把链接换成主页地址number.post设为0表示不限数量link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0预期结果遍历该博主全部已发布作品并逐个下载视频与图集通吃文件按作者 → 模式 → 日期_标题_aweme_id归档。批量任务完成后Downloaded/下的结构大致是Downloaded/ └── 作者名/ ├── post/ │ └── 2024-02-07_作品标题_aweme_id/ │ ├── xxx.mp4 │ ├── xxx_cover.jpg │ ├── xxx_music.mp3 │ └── xxx_data.json ├── like/ ├── mix/ └── live/配置增量追更只拉新视频全量备份过一次之后日常追更不必重下旧内容。开启增量模式依赖数据库记录increase: post: true database: true预期结果再次运行时只下载数据库中没有的新作品追更耗时与流量都接近于零。like/mix/music模式同样支持增量收藏夹模式暂不支持。保存自己的点赞与收藏link指向自己的主页/user/self按需要选模式link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect number: collect: 0collect下载收藏夹内容collectmix下载收藏的合集like则可直接搭配任意博主主页使用mode: [post, like, mix, music]可多选跨模式自动去重。两条硬规则collect/collectmix必须单独运行不能与其他模式混用且只支持当前登录 Cookie 对应的账号。录制直播下播自动收工link填直播间地址即可开始录制属实验性功能link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 一直录到主播下播预期结果录制的 FLV 保存在Downloaded/作者名/live/下并附带直播间元数据 JSON主播下播、断流或手动 CtrlC 时已录制的字节会完整保留不会白录。HLS 源只保存 playlist 文件需要再用 ffmpeg 合流。热搜榜、关键词搜索与评论采集把工具当数据雷达用两条命令分别抓热搜快照和搜索结果均导出 JSONLpython run.py --hot-board 30 -p ./Downloaded # 热搜前 30输出到 Downloaded/hot_board/ python run.py --search 猫咪 --search-max 100 -p ./Downloaded做运营分析的话评论采集值得开启——每个作品旁会多出一个*_comments.jsoncomments: enabled: true include_replies: false # 需要二级回复时设 true请求量会明显增加 max_comments: 500 # 0 不限进阶开关通知、转写与 REST API批量任务跑完想让手机推一条消息配置notifications.providersbark / telegram / webhook 可并发单个失败不阻塞下载想给视频生成文字稿把transcript.enabled设为true并提供OPENAI_API_KEY仅对视频作品生效想接到自己的脚本或前端里把它整个跑成 REST 服务pip install fastapi uvicorn python run.py --serve --serve-port 8000预期结果本地起一个 APIPOST /api/v1/download提交{url: ...}即返回job_id异步排队GET /api/v1/jobs/{job_id}查询进度另有/api/v1/jobs与/api/v1/health两个辅助接口。疑难诊疗室按症状排查症状主页抓取停在 20 条左右原因API 翻页被风控截断。处理确认配置中browser_fallback.enabled: true且headless: false翻页受限时会自动弹出浏览器继续滚动若弹出验证码手动通过后再关窗口不要急着取消。症状提示 Cookie 失效或要求重新登录原因登录态过期。处理重跑一次自动获取即可无需手抄任何字符串python -m tools.cookie_fetcher --config config.yml。症状想重新下载某个视频总显示跳过已存在原因工具用数据库记录 本地文件名中的 aweme_id双重去重。处理两边都要清——删掉对应本地目录目录名含 aweme_id再执行sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;\注意只删数据库、不删文件不会触发重下只删文件、不删数据库则会。清空某作者全部作品可改为WHERE author_name 作者名。症状进度条疯狂刷屏原因静默日志被关闭。处理把progress.quiet_logs设回true默认即为 true需要排查问题时再临时加--show-warnings或-v看详细日志。症状收藏夹collect模式报错原因违反使用约束。处理确认collect/collectmix单独出现在mode里且 Cookie 对应的就是你想下载收藏的那个账号要同时下作品和收藏就分两次运行。症状transcript 转写文件没生成原因按概率排查transcript.enabled未开 → 下载的是图文图文不转写→OPENAI_API_KEY无效 →response_formats里没有txt或json。逐项核对即可。症状下载很慢或网络中断原因并发过高或网络受限。处理中断不必担心完整性校验会自动清理不完整文件并重试速度方面把thread降到 3 往往比调高更稳若网络环境受限在配置里给proxy填本地代理地址如http://127.0.0.1:7890API 请求与媒体下载都会走它。一页速览命令与配置速查需求命令 / 配置说明单条无水印下载link填视频/图文/合集/音乐链接自动选高清源、附封面与元数据主页全量备份mode: [post]number.post: 00 表示不限数量增量追更increase.post: truedatabase: true只下新增内容点赞 / 收藏mode: [like]/[collect]collect 须单独运行、限当前账号直播录制link填live.douyin.com/{room_id}live.*下播自动保留已录数据热搜 / 搜索--hot-board [N]/--search 关键词结果导出 JSONL评论采集comments.enabled: true可含二级回复输出 JSON完成通知notifications.providersBark / Telegram / Webhook服务化集成python run.py --serve --serve-port 8000异步队列下载 API刷新 Cookiepython -m tools.cookie_fetcher --config config.yml一次登录自动写入查下载历史sqlite3 dy_downloader.db SELECT ... FROM aweme ...按download_time倒序如果你完全不想碰终端项目还基于同一套后端打包了桌面客户端Douzy内测中粘贴链接即开始、同步关注列表、任务中心逐条跟踪状态、作品档案可直接筛选 SQLite 历史记录。下一步怎么走先按10 分钟跑通把最小示例跑起来拿到第一条无水印视频然后挑一个贴合你需求的任务主页全量备份、增量追更或直播录制实战一遍用顺手之后建议直接翻一遍douyin-downloader/下的源码和douyin-downloader/README.zh-CN.md官方文档遇到问题提 Issue有余力就提交 PR——这是一个仍在快速迭代的开源项目社区参与会让它更稳定。最后提醒一句请把它用在个人学习、研究与数据备份等合法场景尊重创作者版权与平台规则不要用于侵犯他人隐私或权益的用途。核心关键词抖音下载长尾关键词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），仅供参考