企业官网建设流程全解析

抖音批量下载完整指南：单条视频到整主页无水印采集快速教程

【免费下载链接】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是一个抖音批量下载工具，单条视频、图文、合集、音乐原声都能去水印抓取，也能把整个用户主页的作品一次性搬下来。

它不是"解析一条下一条"的单点工具，而更像一台自动化采集机：粘贴链接后，下载、重试、去重、建文件夹这些脏活全部自己干。你只需要收素材。

适合谁：一张表看懂能力边界

如果你是做竞品素材整理、账号内容归档、短视频选题研究，或者想长期监控某个博主的更新，它能帮你省掉"手动另存 + 人工去重 + 重新整理文件夹"的全部手工环节。不想敲命令的人，也可以留意基于同一套引擎的桌面客户端 Douzy（内测中）。

30 秒上手：从装环境到第一次下载

全程只有一条主线，跟着敲完就能出片。环境要求很低：Python 3.8+，Windows、macOS、Linux 都行。

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 -m tools.cookie_fetcher --config config.yml python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538"

逐句说下这几行在干什么：前四行把源码拉下来、装依赖、复制一份可编辑的配置文件；第五行是"登录关卡"——它会弹出一个浏览器，你扫码登录抖音后回终端按回车，Cookie 自动写进配置，全程不用碰代码；最后一行就是跑通第一次下载，-u后面跟链接，进度条起来，成功/失败/跳过数实时可见。

如果之后遇到翻页被风控、需要弹浏览器过验证码，再补装一次浏览器内核即可，不急着现在装：

pip install playwright python -m playwright install chromium

Cookie 获取脚本的源码在 tools/cookie_fetcher.py，想深入了解可以翻一翻。

核心玩法拆解

单条视频无水印下载

除了命令行-u直传，也可以把链接写进配置的link字段。/video/、/note/（图文）、/collection/（合集）、/music/（原声）四种链接它都认，v.douyin.com短链同样直接丢进去，不用先手动跳转。

整主页批量采集

这才是拉开差距的用法。把博主主页链接放进link，再声明要抓哪几类内容：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like number: post: 50 like: 0 # 0 表示不限量全抓

mode决定抓什么：post是发布作品，like是点赞作品，还能加mix（合集）、music（用过的原声）；number给每个模式限量，填0就是全量。多模式同时跑时，同一个作品只会被下载一次——你在"发布"里下过的视频，在"合集"里再遇到也不会重复落盘，省时省流量。

想长期盯一个账号，把增量开关打开：

increase: post: true

之后每次运行只补新发布的内容，跑一次相当于帮你盯了一个月。

直播录制

把live.douyin.com/{房间号}链接丢进去，再配上录制上限：

live: max_duration_seconds: 3600 # 0 = 录到主播下播

录到一半主播下播、网络空闲甚至你手动 Ctrl+C，已经录下的部分都会保留，FLV 文件落在Downloaded/{作者}/live/下，附带一份直播间元数据快照。

数据导出

不下载视频、只要数据的场景也有现成命令，结果落 JSONL，方便后续做分析：

python run.py --hot-board 30 -p ./Downloaded # 拉热搜榜前 30 python run.py --search "关键词" --search-max 100 -p ./Downloaded

另外在配置里打开comments.enabled: true，每个作品会顺带生成一份*_comments.json，连评论一起归档。

下载完去哪找：目录结构与 3 个关键配置

默认按"作者 → 模式 → 日期+标题"三层自动归档，视频、封面、原声、JSON 元数据各归各位，整理素材时按文件夹拖走就行：

Downloaded/ └── 作者名/ ├── post/ │ └── 2024-02-07_作品标题_aweme_id/ │ ├── ...mp4 │ ├── ..._cover.jpg │ ├── ..._music.mp3 │ └── ..._data.json ├── like/ └── live/

三个最常用配置，理解后基本够你改一切：

• thread：并发下载数，默认 5。网速富余时调大可以明显提速；
• increase：各模式增量开关。true跳过磁盘上已存在的作品，适合长期监控；false则重新下载并覆盖当前范围内的文件；
• database/database_path：SQLite 历史记录开关与路径（默认dy_downloader.db），去重和历史查询都靠它。

去重逻辑、重试策略等更多细节可以翻 核心下载模块，增量与时间过滤的设计文档在 docs/superpowers/specs/。

进阶能力：几个文档里一笔带过但很实用的功能

• 完成通知推送：配notifications后，一批下完自动推送到 Bark、Telegram 或企业微信 webhook——任务可以丢给电脑后台跑，人不用守在屏幕前；
• REST API 服务模式：python run.py --serve --serve-port 8000把它变成 HTTP 服务，POST 一个链接拿任务 ID，适合嵌进自己的自动化流程；
• 视频转写：transcript.enabled: true后，每条视频下完自动调用转写接口生成 txt/json 文稿，做内容研究和字幕提取很省事；
• 桌面客户端 Douzy（内测中）：同一套引擎的图形界面，粘贴链接即刻开始、同步关注列表、可视化跟踪任务，适合不想敲命令的日常零散下载：

新手避坑指南

问：下载过程中完全看不到报错，只有进度条，出问题怎么排查？答：这是静默模式在起作用，progress.quiet_logs默认为true，进度阶段会压掉日志。需要看细节时给命令临时加上--show-warnings或-v即可，平时保持安静反而清爽。

问：collect收藏夹模式和post一起写进mode，为什么跑不起来？答：collect/collectmix只服务当前登录 Cookie 对应的那个账号，官方要求它们单独使用，不能和post/like/mix/music混在同一次运行里。

问：我已经删了数据库记录，重新跑却仍然"跳过"，为什么？答：去重是"数据库记录 + 本地文件"双重检查——程序会扫描本地文件夹名里的aweme_id，只要文件还在磁盘上就算已下载。要真正重下，文件夹和数据库记录两边都得清掉；反过来，只删文件留数据库，则会触发重新下载。

问：直播录出来的文件为什么放不进播放器？答：直播接口目前标注为实验性。FLV 源录出的文件可直接播放，HLS 源则只保存 playlist 文件，需要再用 ffmpeg 做一次后处理才能出可播放的成品。

收尾

工具的价值不在"能下载"，而在"下完不用你管"——去重、重试、归档、增量，douyin-downloader 全包了。现在就 clone 下来，把一个你最想存档的博主主页链接丢进配置，跑完这单，批量采集就彻底打通了 🚀

【免费下载链接】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