抖音视频批量下载完整指南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 这个开源的抖音下载工具值得花十分钟了解一下。读完这篇文章你会从零跑通它的安装与认证学会一条命令下载单条视频学会用一份配置备份整个创作者主页还会解锁直播录制、增量去重、完成通知等进阶玩法。全程不预设编程基础跟着敲就行。先看它能做什么五种内容类型与四项后台能力说白了它就是一个替你干活的抖音下载管家你负责丢链接它负责排队、解析、下载、去重、重试最后把文件整理得整整齐齐。能下载的内容按类型分五类视频/video/{aweme_id}形式的作品链接图文/note/或/gallery/开头的图集链接合集/collection/或/mix/开头的合集链接音乐/music/开头的原声链接直播live.douyin.com/{room_id}的直播录制藏在后台的能力按功能分四项整页批量一个作者主页链接能把他的作品、点赞、合集、音乐一次拉完去重防重复SQLite 数据库 本地文件双重检查同一个作品不会下第二遍下载兜底自动选无水印、最高清画质失败自动重试指数退避还带进度条浏览器兜底翻页被抖音风控拦下时自动弹出浏览器人工过个验证码就能继续动手前先记住三个边界需要 Python 3.8 及以上Windows、macOS、Linux 都能跑首次使用需要 Cookie 认证好在有自动获取命令不用手动翻开发者工具抖音对翻页有限流批量下载的条数可能受限需要开浏览器兜底解决。上图中工具自动抓到了 274 个作品按时间范围过滤后开始并发下载已经存在的文件直接跳过——这就是批量下载时的真实状态。环境搭建克隆、装依赖、Cookie 认证一条龙克隆项目并安装依赖先获取项目代码进入主程序目录并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt克隆下来的仓库里有一个同名子目录那才是主程序所在后面所有命令都建议在这个目录里执行。如果你更习惯容器化部署项目也提供了 Dockerfiledocker build -t douyin-downloader .后挂载配置和下载目录即可运行。如果后面想用浏览器兜底或自动获取 Cookie再补装一个 Playwrightpip install playwright python -m playwright install chromium这步不是必须的可以先用起来遇到翻页受限时再回头装。Cookie 自动获取免去手动复制粘贴很多人被下载器劝退都是卡在手动复制 Cookie 这一步。douyin-downloader 把这件事自动化了先把示例配置复制一份然后运行cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml命令会自动打开一个浏览器窗口你正常登录一次抖音回到终端按一下回车程序就把认证信息写进配置文件了。全程不用碰开发者工具也不用复制粘贴那一长串 Cookie。三类典型下载用法详解单条、整页、直播各怎么配环境搭好之后剩下的事情就简单了。下面按「你要保存的内容」分三条路线对号入座即可。单条作品下载视频、图文、合集、音乐四条链接示例在刷抖音时看到想保存的内容直接把它丢给命令行就行不用先编辑配置python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538-u后面是作品链接-c指定配置文件。如果一次想存好几条也可以把链接写进配置文件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/...短链也能直接识别不用先手动还原。下载完成后目录里会同时生成视频本体、封面图、背景音乐和一份 JSON 元数据方便你以后回溯这个作品的全部信息。创作者主页批量下载一份配置拉完作品、点赞、合集、原声假设你发现了一个宝藏创作者想把他主页的内容整个保存下来。手动操作想想就头疼而这个工具只需要一份配置文件link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 创作者主页链接 path: ./我的抖音收藏/ mode: - post # 下载发布的作品 - like # 下载点赞的作品 - mix # 下载合集内容 - music # 下载音乐作品 number: post: 50 # 下载 50 个发布作品 like: 0 # 0 表示不限制数量全部下载填好后运行python run.py -c config.yml程序会自动按照作者名建好目录四类内容分门别类存放我的抖音收藏/ └── 作者名_MS4wLjABAAAAxxxx/ ├── post/ # 作者发布的作品 ├── like/ # 作者点赞的作品 ├── mix/ # 合集内容 └── music/ # 音乐作品更省心的是跨模式自动去重同一个视频在「发布」和「点赞」里都出现过也只会下载一次不会白占硬盘。下载过程中的并发数默认 5每个文件都带进度条一批几十个作品刷到 100% 的感觉还是很解压的。直播录制配置FLV/HLS 两种格式与断流保留直播和短视频不一样结束就是结束官方不一定有回放特别是知识分享、教学、赛事这类内容错过一场可能再也补不回来。在配置文件里加上直播链接和录制参数link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 录制 1 小时0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30运行后它会解析出直播流地址自动读取标题、在线人数和清晰度选项支持 FLV 和 HLS 两种格式。更贴心的是即使主播中途下播、网络断开或者你按 CtrlC 中断已经录下的内容也会自动保留不会白录一场。录好的文件存在Downloaded/作者名/live/目录下并附带一份直播间信息快照。四个进阶配置技巧增量去重、通知推送、热搜搜索与 API 服务基础用法顺手之后下面这几个进阶配置能让体验再上一个台阶。增量下载与时间过滤只补新内容重复文件自动跳过批量下载最怕重复劳动同一个视频今天下了明天换个模式又下一遍硬盘白占空间。工具内置的 SQLite 去重就像一个「记账本」——上次下到哪、哪些已经存过它心里有数。开启增量模式后下次运行只补新作品database: true # 开启数据库去重和历史记录 increase: post: true # 增量模式只下载新发布的作品 like: true mix: true start_time: 2024-01-01 # 只想保存某个时间段内的内容 end_time: 2024-12-31配合start_time/end_time时间过滤你的素材库会一直保持清爽。每个作品单独一个文件夹命名带日期和标题一眼就能找到想要的内容。下载完成通知Bark、Telegram、Webhook 三选一批量下载动辄几十分钟不用一直盯着屏幕。在配置里加上通知服务下载完成或失败时自动推送到手机notifications: enabled: true on_success: true on_failure: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY - type: telegram bot_token: 123456:ABC... chat_id: 987654321 - type: webhook # 企业微信、飞书、钉钉机器人地址同样可用 url: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?keyxxx多个通知渠道可以同时启用单个渠道失败不会阻塞下载主流程。热搜榜与关键词搜索热点内容一键导出想追热点或找某一类内容不用打开 App 慢慢翻python run.py --hot-board 30 # 拉取抖音热搜榜前 30 python run.py --search 猫咪 --search-max 100 # 搜索关键词相关内容结果会以 JSONL 文件导出到指定目录方便后续做数据分析或内容选题。REST API 服务模式把下载能力包装成 HTTP 接口如果你有自动化需求可以把下载能力封装成服务集成进自己的系统pip install fastapi uvicorn python run.py --serve --serve-port 8000之后就能通过POST /api/v1/download提交{url: ...}下载任务用GET /api/v1/jobs/{job_id}查询任务状态适合有开发基础的进阶玩家。新手常见问题集中解答翻页、Cookie、速度与历史记录问为什么只能抓到 20 条作品这是抖音翻页风控的常见现象。解决办法是确保配置里browser_fallback.enabled: true且headless: false浏览器窗口弹出后手动过一下验证码不要急着关程序会自己继续翻页。问Cookie 失效了怎么办重新跑一次自动获取命令即可几十秒搞定python -m tools.cookie_fetcher --config config.yml问下载速度慢怎么优化把配置里的thread从默认 5 调到 8 试试另外在网络状况好的时段下载效果差异很明显。问怎么查看下载历史程序会自动生成dy_downloader.db数据库文件用一条 SQL 就能查sqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;问想重新下载某个作品怎么办程序通过「数据库记录 本地文件」双重检查来判断是否跳过所以重下需要同时清理这两处删掉本地对应文件夹再删掉数据库里对应的aweme_id记录只删其中一样都不会触发重新下载。问不想敲命令有没有图形界面项目还基于同一套后端做了桌面版 Douzy粘贴链接就能开始下载、可视化跟踪每个任务进度、文件命名规则也能在设置里点鼠标配好。目前处于内测期命令行适合自动化桌面版适合日常使用两条路线共用一套内核。三步行动清单现在就开始搭建你的抖音素材库工具本身不复杂难的只是迈出第一步。现在你就可以做三件事克隆项目并安装依赖进入douyin-downloader/douyin-downloader主目录跑一次 Cookie 自动获取完成身份认证挑一个链接从单条视频下载开始体验一把「一条命令收进硬盘」的痛快。关于更详细的配置项说明和输出目录约定可以翻翻项目里的README.zh-CN.md和config.example.yml每条都有注释。最后多说一句工具让下载变得简单也请把它用在正道上——遵守平台规则尊重创作者版权下载的内容仅供个人学习研究。好的工具加上正确的使用方式才能长久地为你服务。下一次再刷到心动的视频别再让它躺进收藏夹吃灰了——你手里已经有了一条命令可以把喜欢的东西真正留下来。现在就打开终端敲下属于你的第一行命令吧。【免费下载链接】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），仅供参考