企业官网建设流程全解析

抖音批量下载工具 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 就是一个开源免费的命令行工具：贴一条主页链接，它就能把该作者的全部作品去水印批量抓下来，按作者和日期自动归档，重复内容还会自动跳过。实测下来，从装环境到跑通第一条下载，最快不超过十分钟。

一、能力全景：30 秒看懂它能干什么

先给你一张功能地图，确认它管不管你想干的那件事：

如果你不想敲命令行，它还有一个基于同一后端的桌面版 Douzy，粘贴链接就能开始下载，下面是它的抖音链接下载工作台：

二、5 分钟完成安装配置，跑通第一条下载

第 1 步：装环境

需要 Python 3.8 以上（macOS / Linux / Windows 均可），克隆仓库后装依赖：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt

如果后面要用"浏览器兜底"或"自动拿 Cookie"，再补一个浏览器内核：

pip install playwright python -m playwright install chromium

验证方法：python run.py --version，能输出版本号就 OK。

第 2 步：准备 Cookie

抖音网页得先认得"你是谁"才肯给数据，Cookie 就相当于一张临时身份证。工具给了自动获取的方式，跑下面这条命令，浏览器弹出后扫码登录，回到终端按回车，Cookie 会自动写进配置文件：

cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml

验证方法：打开config.yml，确认cookies字段里ttwid、odin_tt等已有值。手动方式也留了口子——登录抖音网页版后从浏览器开发者工具复制整段 Cookie 粘进去即可。

第 3 步：下载第一条视频

配置里只需要动link字段：

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

然后运行：

python run.py -c config.yml

验证方法：Downloaded/下出现按"作者 / 日期_标题_作品ID"命名的子目录，里面有 mp4 文件；终端结尾会打印下载统计。嫌改配置麻烦的话，也可以临时用参数覆盖：python run.py -c config.yml -u "视频链接" -t 8 -p ./Downloaded，其中-u追加链接、-t并发数、-p保存目录。

三、批量下载：主页链接 + mode，关键参数对照表

单条只是热身，主页批量抓取才是主力用法。把作者主页链接贴进link，再用mode声明要抓的内容类型：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 作者发布的作品 - mix # 作者的合集 number: post: 0 # 0 表示全量，不限量

mode可以写多个，一次运行把几类内容都带回本地，同一个作品 ID 跨模式不会重复下载：

下载完成后目录会自动分层，结构大致如下：

Downloaded/ ├── download_manifest.jsonl └── 作者名/ ├── post/ │ └── 2024-02-07_作品标题_作品ID/ │ ├── 视频.mp4 │ ├── ..._cover.jpg # 开启封面下载时 │ └── ..._data.json # 开启元数据时 ├── like/ ├── mix/ └── music/

每个作品独立一个子目录，文件名里带作品 ID，后面找素材、查重都非常方便。桌面版里"收藏与喜欢"页面也能对收藏合集做整集下载：

四、进阶场景：直播、评论、热搜按频率排序

直播录制（实验性功能）。把直播间链接填进link，配上时长上限即可挂机录制：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 = 一直录到主播下播 idle_timeout_seconds: 30 # 空闲多久视为结束

录制文件落在Downloaded/{作者}/live/下并附带直播间元数据 JSON。重点是：主播下播、网络断掉或你手动 Ctrl+C，已经录到的部分会自动从临时文件转正，不会丢。

评论采集。在配置里打开comments.enabled: true，每下载一个作品就会在旁边生成{日期}_{标题}_{作品ID}_comments.json；把include_replies设为true还能带上二级回复（请求量会多一些），max_comments可给每个作品设评论上限。做用户研究时，这类数据直接就能进文本分析流程。

热搜榜与关键词搜索。两条命令就能把榜单或搜索结果落成 JSONL 文件，存到Downloaded/hot_board/和Downloaded/search/下，做选题调研省掉大量手工翻页：

python run.py --hot-board 20 python run.py --search "关键词" --search-max 100

账号内容同步。如果你用桌面版，"关注"页面可以把关注的博主列表同步下来，筛选有新作品的博主直接从列表下载：

五、长期使用心得：五个最常调的参数

用上一段时间后，你会发现决定体验的就是下面这几个参数，建议收藏这张表：

补充两点原理：去重靠"数据库记录 + 本地文件名里的作品 ID"双重校验，所以删文件但没删数据库记录会触发重下，只删数据库不删文件则不会；video_quality除了默认的最高转码档，还可以设original去探测上传原片，代价是每条作品多一次探测请求。

六、排障速查表

收尾：把重复劳动交给程序

回到开头那个场景：整页作品手动保存的日子，现在可以翻篇了。按下面四步走，半小时内你能拿到第一批无水印素材：

1. 克隆仓库、装依赖，跑通python run.py --version；
2. 用python -m tools.cookie_fetcher --config config.yml配好 Cookie；
3. 复制config.example.yml为config.yml，填一条视频链接，跑通首次下载；
4. 换成作者主页链接加mode: post，体验批量下载，之后按需打开增量模式做定期同步。

最后一句提醒：请只在合法合规的范围内使用本工具，尊重内容版权和平台规则，把它用于个人数据管理与技术研究。

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