企业官网建设流程全解析

抖音视频下载工具 douyin-downloader 保姆级教程：3 个真实任务带你玩转无水印高清批量下载

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

上个月，我在抖音刷到一位更新了三年的手工博主，看完第 400 期视频后，特别想把整个主页都存下来慢慢回味。挨个录屏？太慢。丢进在线转换网站？画质缩水还甩不掉水印。就在快放弃时，朋友塞给我一个命令行工具douyin-downloader——一条命令，从单个视频到整个作者主页，无水印、自动选最高清、按作者和日期自动归档，几分钟全部搞定。它完全免费、开源，Windows、macOS、Linux 都能跑。

这篇文章不讲空泛的功能清单，而是围绕三个最常见的真实任务带你走一遍：保存单个视频、批量搬走一个主页、追直播和热点。读完你就能自己动手。

出发之前：装好"眼睛"和"通行证"

把 douyin-downloader 想象成一位管家，它需要两样东西才能干活：运行环境（眼睛）和你的抖音登录态（通行证）。准备阶段只花两分钟，之后所有任务共用这一套配置。

先克隆项目并安装依赖。下面这段命令会下载项目代码，并把aiohttp、rich、pyyaml等全部依赖装好，跑完即完成环境准备：

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

接着复制一份配置文件，作为你以后所有操作的"控制台"：

cp config.example.yml config.yml

最后是关键一步——获取 Cookie。抖音要求登录后才能读取内容，手动从浏览器开发者工具里翻 Cookie 又麻烦又容易抄错。工具内置了自动获取脚本：它会自动打开浏览器，你扫码登录抖音，回到终端按一下回车，Cookie 就自动写进config.yml了：

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

一句话总结：克隆项目、装依赖、扫码登录，三步之后所有下载任务就都有了通行证，全程不需要手抄任何 Cookie。

任务一：把喜欢的视频"干净"地存下来

场景回到你刷视频时：遇到一条特别想保存的内容，复制链接，剩下的交给工具。

链接支持得很全——视频、图文、合集、音乐单曲都能识别，而且抖音 App 里的分享短链（v.douyin.com/...）也会自动解析成真实地址，你不用手动去还原。把链接填进配置文件：

link: - https://v.douyin.com/xxxxx/ # App 里复制的分享短链 - https://www.douyin.com/video/7604129988555574538 # 网页版链接 path: ./Downloaded/ # 保存目录 music: true # 连带下载背景音乐 cover: true # 连带下载封面 json: true # 保存元数据 JSON

然后一条命令开始下载：

python run.py -c config.yml

下载过程有两点特别省心：一是无水印优先，工具会主动挑无水印的视频源，不会拿带角标的版本糊弄你；二是最高清自动挑选，它不靠猜，而是读取视频的码率数组、自动选码率最高的一档，视频和实况图都适用。

下载完成后，每个作品会被自动整理成一个独立文件夹，视频、封面、音乐、数据信息分开存放，一眼就能找到：

一句话总结：粘贴链接、跑一条命令，无水印原画质视频连同封面、音乐、元数据一起归好类躺在你的硬盘里。

任务二：把一位创作者的主页整体搬回家

这是 douyin-downloader 最拿手的场景——作者主页批量下载。还是开头的例子：400 期视频，手动下载要几天，用它只需要配置一个链接。

把作者主页链接填进去，再用mode指定要搬哪些内容：post是发布作品，like是点赞过的，mix是合集，music是发过的音乐（原声）：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like - mix - music number: post: 0 # 0 表示不限数量，全部下载 thread: 5 # 并发下载数 database: true # 开启 SQLite 去重与历史记录

运行后终端会显示完整的下载进度——顶部是已获取的作品数和下载配置，下方逐条展示视频、封面、头像的处理状态和统计结果，哪些成功、哪些跳过一目了然：

批量场景下有三个功能是长期使用的"护身符"，缺一不可：

双重去重，绝不重复下载。工具同时检查数据库记录和本地文件，同一个作品哪怕在"发布"和"合集"里都出现，也只下载一次。断网、中断后重跑，已完成的文件会自动跳过，不会从头再来。

增量下载，只追新增。长期跟踪某位博主时，打开增量开关，以后每次运行只下载他没见过的作品，既省流量又不刷屏：

increase: post: true # 只下载新增的发布作品

浏览器兜底，专治翻页风控。批量抓取时如果被平台限制、只能抓到前 20 条，工具会自动启动浏览器逐页滚动采集，弹出验证码时你手动过一下就行——这个机制能让"抓不全"变成"抓得完"：

browser_fallback: enabled: true headless: false # 弹出可见浏览器，便于手动过验证 max_scrolls: 240

合集批量下载时同样有进度展示，每个视频一条记录，完成度清晰可见：

一句话总结：一个主页链接加一个 mode 列表，配合并发、双重去重、增量和浏览器兜底，几百期作品也能完整搬回家。

任务三：直播、热搜与评论区——追热点的三件套

除了存作品，你还可以把 douyin-downloader 当成热点内容采集器，三个附加能力正好对应三种需求。

录制直播。遇到想保存的直播间（比如演唱会、课程、比赛），把直播链接填进配置，设置好时长上限就能开始录制：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 表示录到主播下播

工具会解析出直播间信息和清晰度选项，录制的 FLV 文件连同直播间元数据快照一起保存在作者名/live/目录下。主播中途下播、网络空闲或你手动中断，已录制的数据都会被保留，不会前功尽弃：

热搜榜与关键词搜索。想快速掌握当天热门内容，两条命令直接把结果导出成便于分析的 JSONL 文件：

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

评论采集。想做内容分析时，开启评论采集，每个视频旁边会多出一个*_comments.json，点赞数、评论数据都齐了：

comments: enabled: true include_replies: false # 是否包含二级回复 max_comments: 500 # 0 表示不限

一句话总结：直播能录、热搜能导出、评论能采集，追热点和做内容研究都有了现成的数据抓手。

进阶：把下载交给机器去跑

如果你用顺手了，还有几条路可以让下载完全自动化，适合搭服务、接脚本的进阶用户。

REST API 服务模式。一条命令把工具变成 HTTP 服务，提交 URL、查询任务状态都有现成接口，方便接入自己的程序：

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

完成通知推送。下载结束后推送到 Bark、Telegram 或企业微信/飞书/钉钉的 Webhook，长任务跑完手机立刻收到提醒，不用一直盯着终端。

视频转写。下载视频后还能调用 OpenAI 的转写接口生成字幕文本（txt 和 json 两种格式），做素材库检索非常方便。

桌面版 Douzy。不喜欢命令行的朋友也不用绕路——项目基于同一套后端提供了桌面客户端，粘贴链接、勾选作品类型、跟踪任务状态都在图形界面里完成：

一句话总结：API、通知推送、桌面版和 Docker 四条路径，让下载从"手动点跑"升级成"自动运转"。

你的上手行动清单

• 克隆项目：git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader
• 安装依赖：pip install -r requirements.txt
• 复制配置：cp config.example.yml config.yml
• 获取 Cookie：python -m tools.cookie_fetcher --config config.yml，扫码后按回车
• 跑通第一个任务：把一条视频链接填进link，执行python run.py -c config.yml
• 再试试批量：换成一个作者主页链接，mode里写上post，看进度条跑起来
• 想深入研究的，完整命令参数和配置项说明都在项目文档里：查看 douyin-downloader/README.zh-CN.md，配置模板可对照 douyin-downloader/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