抖音批量下载完整指南如何用免费工具 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-downloaderdouyin-downloader 是一款免费开源的抖音下载工具覆盖无水印视频下载、作品/喜欢/合集/原声的抖音批量下载、直播录制并内置增量去重。以下流程从装环境讲到第一次下载成功再逐一说明各模式的用法。⚙️ 先搭好环境安装依赖与获取抖音Cookie整个工具只需要 Python 3.8 环境。准备工作分两步一次性的依赖安装加上需要定期刷新的抖音Cookie。安装 Python 依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt第一行把代码拉到本地第二行装齐全部运行依赖。如果后续要用浏览器兜底或自动取 Cookie再补装浏览器引擎pip install playwright python -m playwright install chromium这一步只在用到自动取 Cookie 或翻页兜底时才是必需的。获取抖音Cookie的两种方式没有有效 Cookie抖音接口会拒绝返回内容。获取方式有两种自动方式最省事自动获取推荐python -m tools.cookie_fetcher --config config.yml运行后会自动打开浏览器扫码登录抖音工具会提取并加密保存 Cookie 到配置文件。Cookie 有效期通常为 7-15 天建议每周更新一次。手动配置如果你手头已有 Cookie直接编辑配置文件里的cookies字段填入即可。准备配置文件cp config.example.yml config.yml之后所有操作都围绕config.yml展开完整参数说明见项目文档。用单个视频跑通全流程最短路径拿到第一个无水印文件环境就绪后先别直接上批量任务。用一条视频链接把配置 → 运行 → 落盘走一遍确认 Cookie 和目录都正常再扩大规模。在config.yml中填入目标链接link: - https://www.douyin.com/video/7604129988555574538执行下载命令python run.py -c config.yml命令跑完./Downloaded/目录下会出现一个无水印视频文件。v.douyin.com开头的分享短链也可以直接粘贴工具会自动解析。如果偏好图形界面同一套后端还提供桌面版Douzy粘贴链接即识别类型点一下开始下载。截图为桌面版抖音工作台链接粘贴后自动识别为单个作品一键开始下载。 下载对象分类按想下什么选模式批量任务里mode决定下什么number决定下多少0 表示不限。下面按对象逐个过。作品批量归档创作者发布的视频想完整归档某位创作者把主页链接交给post模式link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0 # 0 表示下载全部作品工具会翻页抓取主页并按序下载。只要某段时间的内容时配合时间过滤即可例如只取 6 月发布的作品start_time: 2024-06-01 end_time: 2024-06-30配置后工具只抓取 6 月发布的作品不用为无关内容多花流量。桌面版还可以先同步关注列表、标记新作品再从那里发起批量下载。喜欢列表抓取别人点赞过的视频换成like抓取对象就从这个人发的变成这个人赞过的适合了解一位创作者的偏好mode: - like number: like: 0合集抖音合集批量保存mix模式把创作者名下的合集整体保存系列内容保持完整mode: - mix单个合集链接/collection/{mix_id}形式也可以直接粘贴只下载那一个合集。音乐单独保存原声music模式不碰视频本体只保存原声音频文件适合攒个人音乐库mode: - music收藏夹备份自己账号的收藏collect收藏作品与collectmix收藏合集作用于当前登录 Cookie 对应的账号用来备份个人收藏。注意这两类模式必须单独使用不能与 post/like/mix/music 混用link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect number: collect: 0桌面版的收藏页面会列出每个收藏合集及条目数可以一键保存整个合集。直播抖音直播录制链接指向live.douyin.com的房间时工具自动切换为录制模式link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 录制1小时0 表示录到主播下播主播下播或网络中断时已经录到的部分会保留不会整场作废。 文件落到哪里目录树、命名模板与增量去重默认目录结构默认folderstyle: true文件按作者 → 模式 → 单作品三级归组Downloaded/ ├── 创作者A_secuid/ │ ├── post/ │ │ └── 2024-06-15_作品标题_aweme_id/ │ │ ├── video.mp4 # 无水印视频 │ │ ├── music.mp3 # 背景音乐 │ │ ├── cover.jpg # 封面图片 │ │ └── info.json # 作品元数据 │ └── like/ └── 创作者B_secuid/日期前缀取的是作品发布时间文件天然按时间排好序。同目录下还会追加写入download_manifest.jsonl清单每个作品一行记录标题、标签、文件路径等可追溯字段。按作者归档的命名模板写法默认命名不合归档习惯时用模板改写folderstyle: true filename_template: {date}_{title}_{id} folder_template: {date}_{title}_{id} author_dir: nickname_uid # 作者目录命名方式author_dir有三个可选值nickname默认直观但重名会合并、sec_uid稳定唯一但不直观、nickname_uid直观且唯一适合归档多位创作者。模板里必须保留{id}防止同名作品互相覆盖。附加资源开关与元数据文件视频本体默认保存其余产物按需打开music: true # 下载背景音乐 cover: true # 下载封面图片 avatar: true # 下载作者头像 json: true # 保存作品元数据元数据文件包含标题、发布时间、点赞/评论/分享数、作者信息、话题标签、分辨率等字段方便后续二次整理。增量下载与自动去重重复下载同一位创作者是最常见的日常场景。开启增量模式后工具会对照 SQLite 记录与本地文件跳过已下载的作品只抓新增内容increase: post: true database: true配置后再次运行同一任务即可只补新内容。和纯手动保存相比差异在归档阶段最明显维度手动保存录屏/客户端douyin-downloader 流程水印录屏或客户端导出带水印自动挑选无水印源文件命名文件名杂乱需人工重命名模板统一生成 日期_标题_id重复下载人工比对找重SQLite 本地文件双重去重增量跳过元数据不保留每作品附带信息文件直播需全程手动录像定时录制中断自动保留更快更稳线程、重试与浏览器兜底并发与重试参数两个数字控制速度与容错thread: 5 # 并发下载数默认 5 retry_times: 3 # 失败重试次数单个文件失败时程序会按指数退避重试已下载文件还会做完整性校验不完整的文件自动清理并重新拉取中断的任务直接重跑原配置即可继续。分页风控与浏览器兜底批量抓取最常见的静默失败是翻页被风控翻一页之后不再返回新内容怎么等都只多出 20 条。出现这种情况时开启浏览器兜底browser_fallback: enabled: true headless: false max_scrolls: 240 idle_rounds: 8 wait_timeout_seconds: 600API 翻页受限时工具会启动浏览器滚动采集作品弹出验证时可以人工完成不要立即关闭窗口。需要注意浏览器兜底目前只对post模式做了完整验证like/mix/music 仍主要依赖 API 正常分页。任务中心桌面版会把每个任务的状态、成败计数和结果目录列出来便于定位需要重跑的项。各机制的设计细节可参考项目文档。 可选扩展REST API、Docker、通知推送等附加能力以下能力都不是基础使用所必需的按需求逐项开启即可。以 REST API 服务方式运行要把下载任务接进自动化流程可以把工具跑成 REST 服务pip install fastapi uvicorn python run.py --serve --serve-port 8000启动后通过接口提交和查询任务POST /api/v1/download提交下载任务GET /api/v1/jobs/{job_id}查询指定任务状态GET /api/v1/jobs列出最近任务GET /api/v1/health做健康检查。Docker 部署服务器环境直接用仓库里的镜像构建docker build -t douyin-downloader . docker run -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/Downloaded:/app/Downloaded douyin-downloader两条命令分别构建镜像和运行容器本地配置与下载目录挂载进去产物仍落在宿主机上。下载完成推送到手机长任务结束不想守在终端就配一个推送通道notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY - type: telegram bot_token: 123456:ABC... chat_id: 987654321支持 Bark、Telegram、Webhook 三类通道各通道并发推送单个通道失败不会阻塞主下载流程。视频语音转写想让视频里的口播变成文本可以调用 OpenAI 的转写接口transcript: enabled: true model: gpt-4o-mini-transcribe response_formats: - txt - json启用后每个视频生成xxx.transcript.txt和xxx.transcript.json。密钥建议通过环境变量OPENAI_API_KEY提供。采集作品评论打开评论采集每个作品的评论区会被输出为结构化 JSONcomments: enabled: true include_replies: false # 是否包含二级回复 max_comments: 500 # 0 表示不限数量生成的文件与媒体文件放在一起方便后续做语料整理或观点分析。热搜榜与关键词搜索两个附加抓取命令内置在入口脚本里# 抓取热搜榜前30条 python run.py --hot-board 30 -p ./Downloaded # 按关键词搜索作品 python run.py --search 猫咪 --search-max 100 -p ./Downloaded结果以 JSONL 文件落到hot_board/与search/子目录可直接用于分析。 排障手册症状、可能原因与修复步骤症状出现 403 Forbidden 或未登录错误可能原因Cookie 过期。有效期通常为 7-15 天过期后接口直接拒绝。修复步骤重新执行python -m tools.cookie_fetcher --config config.yml取得新 Cookie 写回配置。症状某创作者只能抓到 20 条作品可能原因翻页触发风控API 在第一页之后停止返回。修复步骤确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证不要立即关闭窗口。症状下载速度慢或中途中断可能原因网络波动或并发线程数偏高争抢带宽。修复步骤先检查网络再调整thread默认 5中断后依靠完整性校验自动清理并重试重跑原配置即可续上。症状批量下载时内存与磁盘占用高可能原因并发线程一次开太多或磁盘剩余空间不足。修复步骤调低线程数分批下载每批 50-100 个作品确保磁盘预留 50GB 以上。需要查下载历史开启database: true后所有已下载作品都记录在 SQLite 里查最近 20 条sqlite3 dy_downloader.db SELECT aweme_id, title, author_name, datetime(download_time, unixepoch, localtime) FROM aweme ORDER BY download_time DESC LIMIT 20;想强制重新下载某个作品需同时删除对应本地目录并清掉数据库记录只删其中一侧不会触发重下。使用边界个人备份与学习用途尊重创作者工具定位是技术研究、学习交流与个人数据管理。使用时请守住这几条边界仅用于个人学习、研究或备份自己的内容不做二次分发尊重创作者的劳动成果不利用抓取内容侵犯版权或隐私不用于任何违法违规用途使用者自行承担行为产生的全部风险平台接口策略变化可能导致功能失效属于正常技术风险跟随项目更新即可。项目采用 MIT 许可证开源。从配置 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），仅供参考
