
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 这条流水线值得 10 分钟试跑一遍。它是一个命令行优先的抖音下载器单条视频、图文、合集、音乐、整个用户主页都能进同一个入口处理并且默认带进度展示、失败重试、SQLite 去重和浏览器兜底。本文按先跑通一条再放大到主页级批量采集的动线走一遍顺带把去重、增量、通知这些后台机制讲清楚。这条流水线能吃下哪些链接判断能不能用的标准很简单只要你能从抖音复制或从 App 分享出来的链接基本都在它的处理范围内。短链会被自动展开不用先手动跳转。输入形式处理行为/video/{id}下载单个视频自动挑无水印、最高码率的源/note/{id}、/gallery/{id}下载单个图文/collection/{id}、/mix/{id}按合集整组抓取/music/{id}下载音乐原声缺失时回退到该音乐下的首条作品v.douyin.com/...等短链自动解析成真实目标/user/{sec_uid}主页批量采集配合mode指定抓什么当前登录账号收藏夹collect/collectmix模式只能单独使用live.douyin.com/{room_id}直播录制实验性FLV/HLS--hot-board/--search 关键词热搜榜、关键词搜索结果导出 JSONL首次跑通安装、登录态与第一条视频这一节把三件事并成一条线走完装好环境、拿到登录态、把第一条无水印视频落到本地。装好项目与依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml第一、二行拿到源码并进入目录第三行装依赖要求 Python 3.8Windows / macOS / Linux 均可第四行从 config.example.yml 复制出一份可编辑的config.yml。浏览器兜底用到的 Playwright 不急遇到翻页被风控时再补装pip install playwright python -m playwright install chromiumCookie 登录态自动获取优先登录态有两个来源。首选自动获取tools/cookie_fetcher.py 会拉起一个浏览器窗口python -m tools.cookie_fetcher --config config.yml在弹出的窗口里登录抖音回到终端按回车Cookie 会自动写进配置文件全程不碰代码。如果你习惯从浏览器开发者工具里复制也可以手动写进config.yml字符串或字典形式都支持cookies: msTokenxxx; ttwidxxx; odin_ttxxx;Cookie 偶尔会过期过期后重跑一次上面的自动获取命令即可属于日常维护动作而不是故障。无水印视频下载命令配置就绪后单条视频一行命令python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538-c指定配置文件-u追加链接-t调并发-p指定下载目录。工具解析后会自动在无水印源里挑码率最高的一档落盘的同时在终端给出成功 / 失败 / 跳过的实时计数跑完一眼就能核对结果。主页级批量采集模式、数量与增量单条只是起点把整个主页搬下来才是这套工具的主场。把主页链接和采集策略写进配置link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like number: post: 50 like: 0三个字段的含义link是目标主页mode决定采集范围post发布作品、like点赞作品另有mix合集、music用过的原声number给每个模式设上限0表示不设上限全量抓。保存后运行python run.py -c config.yml多任务会并发跑每个任务的进度、耗时滚动刷新。两个配套技巧跨模式去重同一个aweme_id在发布和合集里同时出现时只落盘一次增量模式把increase.post: true打开依赖database: true再次运行时只补新发布的内容适合挂成长期监控任务。还可以用start_time/end_time格式YYYY-MM-DD把采集范围圈在某段时间内。产物去向下载目录的自动分层下载完成后文件不是堆在一个平铺目录里而是按作者 → 模式 → 日期标题自动分层Downloaded/ └── 作者名/ ├── post/ │ └── 2024-02-07_作品标题_aweme_id/ │ ├── ...mp4 # 视频本体 │ ├── ..._cover.jpg # 封面按需开启 │ ├── ..._music.mp3 # 原声按需开启 │ └── ..._data.json # 元数据按需开启 ├── like/ └── mix/每个作品一个独立文件夹命名模板filename_template/folder_template可用{date} {title} {id} {author}等变量自定义素材库整理时直接按文件夹拖走。封面、原声、头像、JSON 这些附带产物默认关闭在配置里按需打开避免平白多出几倍文件。让它替你干活去重、重试、校验与通知真正降低维护成本的是几个后台机制平时你感觉不到它们存在出问题时才显出价值双重去重SQLite 数据库记录 本地文件名扫描双保险。换机器、挪目录之后它仍能从文件名里的aweme_id认出这条下过指数退避重试网络抖动导致的失败按 1s → 2s → 5s 节奏自动重试中途中断的文件可续传完整性校验下载结束比对 Content-Length发现截断的文件自动清理并重下避免看着成功实际损坏直播录制喂入live.douyin.com的房间链接即可边播边录主播下播或按 CtrlC 时已录字节保留FLV 直接可播完成通知notifications.providers支持 Bark、Telegram、Webhook企业微信 / 飞书 / 钉钉 bot 地址同样可用一批任务跑完推到手机人不守机器数据侧输出comments.enabled: true时每个作品旁生成*_comments.json--hot-board 30、--search 关键词把结果落成 JSONL接分析流程很方便。如果你希望用程序而不是命令行触发任务还有一个 REST 服务模式pip install fastapi uvicorn python run.py --serve --serve-port 8000POST/api/v1/download提交链接拿job_id再轮询任务状态即可适合嵌进自己的自动化系统。故障速查表症状可能原因处理方式只抓到 20 条就停翻页触发风控browser_fallback.enabled: true且headless: false弹窗出现后手动过验证别急着关窗口下载大面积报错Cookie 失效重跑python -m tools.cookie_fetcher --config config.yml想重下却一直被跳过去重机制生效删掉Downloaded/作者名/模式/*_aweme_id/目录并执行sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;进度刷屏影响阅读日志未静默确认progress.quiet_logs: true需要排查时再加-v没生成 transcript 文件转写未生效依次查transcript.enabled、是否为视频作品图文不转写、OPENAI_API_KEY是否有效查下载历史也走数据库sqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;。适合谁以及边界在哪这套流程适合三类场景个人素材归档按作者分好层随取随用、竞品 / 账号长期监控增量 定时 通知推送、以及需要评论与热搜数据配合的分析工作。它的边界同样明确collect/collectmix收藏夹模式只认当前登录 Cookie 对应的账号且不能与post/like等混用浏览器兜底目前只在post模式完整验证过like/mix/music主要依赖 API 正常分页直播录制标记为实验性FLV 直接可播HLS 源只保存 playlist 文件需要 ffmpeg 后处理。不想敲命令的人可以留意桌面端Douzy内测中与命令行共用同一套引擎粘贴链接即下、同步关注列表、可视化跟踪任务。工具的价值在于跑起来之后不用你管去重、重试、分类、增量这些重复劳动都压在后台你只负责复制链接、触发任务、回来验收。按上面的动线走一遍第一条无水印视频落盘之后主页级批量采集只是改几个配置项的事。【免费下载链接】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),仅供参考