企业官网建设流程全解析

douyin-downloader抖音批量下载：3步上手，1张速查表

【免费下载链接】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一条命令就能把视频、图集、合集、原声音乐无水印批量下载，还自动去重、自动重试。下面按"装环境 → 配 Cookie → 跑起来"的最短路径带你跑通，再讲全量备份、增量追更这些高频玩法。

能力全景：一张表看懂差异

最后一列才是重点：它不止"下载"二字，还能录直播、抓评论、导出热搜 JSONL、把工具跑成 REST API。

从零跑通：三步到第一次下载成功

第一步：装好环境

要求 Python 3.8 以上：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd 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 自动写回配置。

这是唯一的"硬门槛"：它自动打开浏览器，你在弹出的窗口登录抖音，回到终端按回车，cookies字段就被写进config.yml，全程不用手抄。

第三步：填链接，跑起来

编辑config.yml，把链接填进link：

link: - https://www.douyin.com/video/7604129988555574538

做了什么：指定要下载的抖音视频/主页/合集链接。

启动：

python run.py -c config.yml

做了什么：按配置开始下载，终端实时显示进度。

完成品默认落在Downloaded/目录，按"作者 → 模式 → 日期_标题"归档。想临时加链接也可以命令行追加：python run.py -c config.yml -u "https://www.douyin.com/video/xxx"。

场景实战：三种高频用法

主页全量备份与增量追更

追更的博主哪天删号最痛。把link换成用户主页，number.post设为0即不限数量：

mode: - post number: post: 0 # 0 = 全量下载 increase: post: true database: true

做了什么：全量拉取作品，之后再跑只下新增内容。

第一次是全量备份；此后每次运行靠increase.post增量判断，已下过的自动跳过，追更成本几乎为零。桌面版里，每个任务的成功/失败/跳过状态在任务中心一目了然，失败的可以单独重试：

个人数据迁移：点赞、收藏、合集、音乐

刷到过、点过赞的内容，推荐算法一改可能就翻不出来。like下你点赞的作品；收藏类（collect收藏夹、collectmix收藏的合集）用当前登录账号自己的主页链接：

link: - https://www.douyin.com/user/self?showTab=favorite_collection mode: - collect

做了什么：把收藏夹内容整包搬回本地。

注意collect/collectmix只能单独使用，不能和post/like混搭，只支持登录账号本身。作者的视频合集和原声音乐也一样能整包拉：link填/collection/{id}或/music/{id}链接即可，音乐优先下原声文件，缺失时回退到该音乐下的首条作品。

扩展数据源：热搜榜与关键词搜索

把它当"数据雷达"用，两条命令即可，结果都落盘成 JSONL 供任意工具分析：

python run.py --hot-board 30 -p ./Downloaded python run.py --search "猫咪" --search-max 100 -p ./Downloaded

做了什么：抓热搜前30条、按关键词搜作品并导出。

排障手册：高频问题一次讲清

只抓到 20 条作品？→ 八成是 API 翻页被风控。开启浏览器兜底，受限时自动弹窗滚动加载，弹验证码手动过一下即可：

browser_fallback: enabled: true headless: false # 必须 false，要能看到验证码

做了什么：翻页受限时用浏览器接管继续加载。

Cookie 动不动就失效？→ 别手抄，直接重跑一次自动获取脚本（命令同第二步），失效后登录一次即可恢复。

想重新下载却总被"跳过"？→ 工具用"数据库记录 + 本地文件"双重去重，两边都要清：

sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '<aweme_id>';"

做了什么：删掉该作品的历史去重记录。

再删掉本地同名文件夹，下次运行就会重新下载。

下载一半断网了？→ 不用重来。每条任务带指数退避重试（默认 3 次）和内容长度校验，不完整的文件自动清理后重下。

转写（transcript）文件没生成？→ 依次检查：transcript.enabled是否为true、下的是不是视频（图文不转写）、环境变量OPENAI_API_KEY是否有效。

怎么查历史下载记录？

sqlite3 dy_downloader.db "SELECT aweme_id, title, author_name, datetime(download_time,'unixepoch','localtime') FROM aweme ORDER BY download_time DESC LIMIT 20;"

做了什么：查最近 20 条下载历史。

下载太慢？→thread降到 3 比拉高更稳；网络受限就给proxy填本地代理，如http://127.0.0.1:7890。另外进度刷屏时确认progress.quiet_logs: true（默认已开）。

进阶能力：比"下载视频"多走一步

直播录制

link填live.douyin.com/{房间号}，配：

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

做了什么：自动解析直播流录制，断流保留已录数据。

评论采集

运营调研党福音，给每个作品额外生成*_comments.json：

comments: enabled: true include_replies: false # 要二级回复就改 true max_comments: 500

做了什么：按作品采集评论并独立落盘。

REST API 服务

想集成进自己的脚本或前端？

pip install fastapi uvicorn python run.py --serve --serve-port 8000

做了什么：起本地 API，提交 URL 即可异步排队下载。

速查表

回到开头那个场景：录屏和解析站可以退役了。下一步，把config.example.yml复制一份跑通第一次下载，再挑一个场景实战；用顺手了，欢迎到仓库提 Issue 或 PR。最后提醒：请尊重创作者版权，把工具用在个人学习、研究或数据备份等合法场景。

核心关键词：douyin-downloader抖音批量下载；长尾关键词：抖音无水印视频下载、抖音主页全量备份、增量追更配置、抖音直播录制、抖音评论采集、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