抖音下载器从零开始完整上手批量去水印下载与直播录制的实战指南【免费下载链接】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抖音下载器就是为这种场景设计的开源工具去水印、批量下载、自动归档、智能去重一条命令跑通从收藏到入库的全过程。一句话定位与三个王牌能力它是什么一句话一个面向实用场景的抖音内容下载器把粘贴链接 → 识别类型 → 下载 → 归档 → 去重整条链路做成闭环并且默认自带进度展示、失败重试和完整性校验。凭什么值得用它三个王牌能力足够说明问题链接级全类型覆盖单条视频、图文note、合集collection/mix、音乐music、直播间live.douyin.com都能直接下v.douyin.com短链自动解析不用手动展开。主页级批量与多模式粘贴一个作者主页链接可同时下载作品post、喜欢like、合集mix、音乐music支持数量限制、时间过滤和增量更新还能下载当前登录账号的收藏夹collect/collectmix。工程级可靠性SQLite 记录 本地文件双重去重、Content-Length 完整性比对、指数退避重试、请求限速、浏览器兜底翻页下载到一半断了会补重复内容不会二次占空间。 三步上手从零开始跑通第一个任务第一步安装环境项目需要 Python 3.8克隆后安装依赖即可git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt如果想启用浏览器兜底功能翻页风控时自动打开浏览器再补一步pip install playwright python -m playwright install chromium粘贴链接后自动识别内容类型勾选作品、喜欢或合集即可开始下载。第二步配置 Cookie 并登录下载公开内容也建议带上登录态稳定性和可下载范围都会好很多。推荐用内置工具自动获取cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml按提示在浏览器完成抖音登录回到终端按回车Cookie 会自动写进config.yml全程保存在本地不会上传到任何服务器。第三步跑通第一个任务先试最保守的单条视频下载python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538 -p ./Downloaded看到进度条走完Downloaded/下出现作者目录和作品文件夹说明整条链路已经通了。接下来可以放心把链接换成作者主页进入批量模式。按角色拆解玩法总有一款适合你新手个人收藏整理如果你只想把喜欢的作品存下来配置越简单越好link: - https://www.douyin.com/user/self?showTabfavorite_collection # 自己的收藏夹 mode: - collect # 下载收藏夹内容 number: collect: 0 # 0 不限全部下载 music: true # 顺手把背景音乐也存下来 cover: true # 保存高清封面 folderstyle: true # 每个作品独立文件夹方便整理收藏夹模式要求使用当前已登录的 Cookie且collect需要单独使用不要和其他 mode 混写。进阶玩家批量建自己的素材库追博主、做二创、存教程的进阶用户直接上主页批量 增量link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 目标作者主页 mode: - post - mix - music number: post: 100 # 最近 100 个作品 mix: 0 # 全部合集 increase: post: true # 下次运行只下新增内容 mix: true database: true # 增量依赖数据库记录务必开启同一个作品在不同模式下只下一遍跨模式自动去重开启increase后定期重跑就能维持一个持续更新的资料库。专业团队与研究者数据采集分析需要做内容研究、舆情分析的用户重点放在三个能力上comments: enabled: true # 采集评论 include_replies: true max_comments: 500 transcript: enabled: true # 视频转写 model: gpt-4o-mini-transcribe api_key_env: OPENAI_API_KEY # 密钥走环境变量比写死在配置里安全每条作品会生成*_comments.json含二级回复和transcript.txt/json配合时间过滤start_time/end_time按周期采样评论、文案、音频内容都能拿到结构化数据。作品档案基于 SQLite 记录可按作者、关键词、日期范围快速筛选历史下载。配置深水区三个决定成败的关键配置mode、number 与 increase先想清楚下什么mode决定下载类型number决定数量0 表示全量increase决定是否只补新增。三者的默认值分别是[post]、post: 1、全部false——也就是说默认只下 1 个作品别惊讶。想全量就把对应模式的 number 设为 0想长期维护就开 increase。先理解这套组合再调参数比死记命令有效得多。author_dir 与 filename_template决定归档质量默认author_dir: nickname仅昵称直观但会重名合并filename_template默认{date}_{title}_{id}模板里必须含{id}否则同名作品会互相覆盖。重度用户建议这样配author_dir: nickname_uid # 昵称_sec_uid直观又唯一推荐重度用户 filename_template: {date}_{title}_{id} folder_template: {date}_{title}_{id} folderstyle: true注意切换author_dir只影响后续下载不会迁移已有目录越早定下来越好。browser_fallback翻页风控的兜底网批量抓主页时最常见的现象是只能抓到 20 条——这是翻页风控。默认browser_fallback.enabled: true且headless: false遇到限制会自动弹出浏览器你手动过一下验证码就能继续翻页。两个建议不要关掉它验证码弹窗出现时别急着关窗口等它自动继续。命名模板和作者目录策略支持可视化配置改完即生效。再进一步把下载器接进你的工作流定时增量下载配合 crontab资料库可以无人值守地持续更新0 2 * * * cd /path/to/douyin-downloader/douyin-downloader python run.py -c config.ymlREST API 服务模式需要对接自动化系统的场景可以起一个 API 服务pip install fastapi uvicorn python run.py --serve --serve-port 8000核心端点POST /api/v1/download提交{url: ...}创建任务GET /api/v1/jobs/{job_id}查状态GET /api/v1/health做健康检查。完成态任务默认保留 24 小时可用server.job_ttl_seconds调整。热搜与关键词搜索选题找素材很好用结果直接落 JSONLpython run.py --hot-board 30 -p ./Downloaded # 热搜榜前 30 python run.py --search 猫咪 --search-max 100 -p ./Downloaded # 关键词搜索完成通知与历史查询notifications: enabled: true providers: - type: bark # 也支持 telegram / webhook url: https://api.day.app/YOUR_DEVICE_KEYsqlite3 dy_downloader.db SELECT aweme_id, title, author_name, datetime(download_time,unixepoch,localtime) FROM aweme ORDER BY download_time DESC LIMIT 20;实时进度界面逐步展示任务执行状态可随时取消或查看事件日志。常用命令速查表场景命令 / 配置安装依赖pip install -r requirements.txt浏览器兜底pip install playwright python -m playwright install chromium自动获取 Cookiepython -m tools.cookie_fetcher --config config.yml运行下载python run.py -c config.yml命令行追加链接python run.py -c config.yml -u 链接并发 / 重试thread: 5默认、retry_times: 3默认全量下载number.post: 00 不限增量下载increase.post: true时间过滤start_time: 2024-01-01/end_time热搜 / 搜索--hot-board 30/--search 关键词 --search-max 100REST APIpython run.py --serve --serve-port 8000录制直播link: https://live.douyin.com/{room_id}live.max_duration_secondsDocker 部署docker build -t douyin-downloader .运行时挂载 config 与下载目录⚠️ 避坑清单常见问题三段式排查症状 1只能抓到 20 条作品原因翻页触发风控。解法确认browser_fallback.enabled: true、headless: false验证码弹窗出现后手动完成不要立即关闭窗口。症状 2Cookie 失效报登录相关错误原因登录态过期。解法重跑python -m tools.cookie_fetcher --config config.yml重新登录并自动写入配置。症状 3进度条刷屏日志混乱原因默认日志输出较吵。解法保持progress.quiet_logs: true调试时再临时加--show-warnings或-v。症状 4想重新下载某个作品却不触发原因数据库记录 本地文件双重去重在起作用。解法同时删掉数据库记录和本地目录——先用sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id id;再删对应本地文件夹。症状 5没有生成转写文件原因转写仅对视频作品生效。解法检查transcript.enabled是否为true、OPENAI_API_KEY或transcript.api_key是否有效、response_formats是否包含txt并确认下载的是视频而非图文。最后说几句从单条视频到作者主页批量从去水印到增量更新从评论采集到 API 服务douyin-downloader 的覆盖范围已经超出了下载工具四个字——它更像一个可以持续运营的抖音内容管理系统。建议你先用单条视频跑通流程再逐步打开批量、增量和通知几周后回头看自己维护的资料库会有很踏实的收获。请记得合理使用下载内容仅用于个人学习、研究与备份尊重创作者的版权和劳动成果遵守平台规则。工具的开源维护依赖社区遇到问题可以先去仓库的 Issues 里搜一搜也欢迎提交反馈和代码让它变得更好用。现在打开终端从第一条命令开始吧。【免费下载链接】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），仅供参考