企业官网建设流程全解析

抖音批量下载实战：我用 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 是一款免费开源的抖音批量下载工具，支持无水印保存视频、图集、合集与音乐，一条命令就能把整个作者主页搬回本地。这篇文章不讲功能清单，而是带你完整跑通一次真实的批量下载，再聊聊那些文档里没写明白的坑。

一、凌晨一点，你才想起那 400 条收藏

关注三年的博主宣布退网，评论区一片哀嚎。你猛然想起一件事：自己在"收藏"里攒了 400 条 ta 的作品——而收藏夹和账号是绑定的，一旦注销，什么都没了。

你点开第一条视频，长按保存，发现带水印；第二条，只有 720p 的糊版；第三条，卡在 99% 再也不动。折腾到凌晨两点，400 条里成功存下来的只有 11 条。

这就是大多数人的真实处境：不是不想存，是"一个个手存"这件事本身，就足以劝退任何人。而 douyin-downloader 要解决的，正是"批量下载"这一件事——把作者主页的发布作品、点赞、合集、原声音乐一次性搬回家，顺带把水印去掉、把清晰度拉到最高。

二、一次完整的批量下载走查：从空目录到 300 条视频

与其听我讲它有多少功能，不如直接跟着走一遍。下面这段，就是我用它下载某位作者主页 300 条作品的完整过程。

1. 三行命令，把运行环境搭起来

先把代码拉下来，进入项目里 V2.0 主程序所在的douyin-downloader子目录：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader

然后安装依赖（需要 Python 3.8+）：

pip install -r requirements.txt

2. 自动登录，30 秒拿到可用凭证

抖音的接口需要 Cookie 鉴权，手抄 Cookie 又慢又容易抄错。项目自带一个自动获取工具，会帮你打开浏览器完成登录：

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

浏览器弹出后登录你的抖音账号，回到终端按一下回车，程序就会把 Cookie 自动写进配置里，全程不需要手动复制粘贴。

3. 四行配置，告诉它"搬什么、搬多少"

在config.yml里填上作者主页链接和下载模式，这就是最精简的配置：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 300 thread: 5 database: true

含义很直白：下载这个主页的发布作品，最多 300 条，5 个线程并发，并开启数据库去重。如果你想把作者的主页、点赞、合集、音乐一锅端，把mode换成下面这样即可：

mode: - post - like - mix - music

4. 运行，然后去倒杯水

启动下载的命令只有一行：

python run.py -c config.yml

程序会依次处理：解析链接 → 拉取作品列表 → 并发下载 → 校验文件完整性。下面这张图是运行中的真实画面，可以看到 5 线程并发的下载进度和逐条事件日志：

5. 验收：无水印、最高清、自动分类

下载完成后，打开保存目录，你会看到每个作品一个独立文件夹，视频、封面、音乐、元数据各归其位：

几个值得说一嘴的细节：视频源默认优先选无水印的，且会从bit_rate数组里自动挑最高码率，而不是拿默认清晰度糊弄你；同一个aweme_id在 post/like/mix 多个模式下出现时不会重复下载——这套"数据库 + 本地文件"双重去重机制，配合increase: true还能实现增量更新，下次再跑只会补新内容。

三、走查之外：这几个能力，多数人没注意到

批量下载只是它的"基本盘"，下面三个玩法是翻文档时容易被略过、但实际很实用的部分。

直播录制：错过开播，也别错过全程

工具能对live.douyin.com的直播间做实时录制，支持 FLV 和 HLS 源，主播下播、网络空闲或手动中断时，已录制的字节都会被保留，不会白录一场：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600

最长录制 1 小时（设为 0 则录到主播下播）。录制完成后，FLV 文件会连同直播间元数据快照一起存在作者名/live/目录下。下面这张截图就是它解析直播间信息、列出清晰度选项、拿到 FLV 直链的真实输出：

热搜榜与搜索：当下载工具做数据采集

如果你在做内容选题或竞品观察，它还能当数据工具用：

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

前者导出抖音热搜榜前 30 名，后者按关键词搜索作品，结果都落成带时间戳的 JSONL 文件，方便后续分析。

自动化闭环：REST API 加通知推送

下载完成后，还能把结果推到你手机上：

notifications: enabled: true on_success: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY

想进一步接入自己的系统？执行python run.py --serve --serve-port 8000就能启动 REST API 服务，通过POST /api/v1/download提交链接、GET /api/v1/jobs/{id}查询状态，适合挂在服务器上做定时任务。

另外多说一句：如果你对命令行实在无感，项目还提供了一个基于同一套后端的内测桌面版 Douzy，任务中心、作品档案、实时进度都有可视化界面：

四、新手最容易踩的坑：我替你翻过车了

以下几点来自真实使用中高频出现的问题，提前知道能省下不少排查时间。

只下到 20 条就停了。这是抖音翻页风控的典型现象，不是工具坏了。解决办法是开启浏览器兜底并把headless设为false，弹窗出现后手动完成验证，别急着关窗口。

Cookie 失效，下载全部报错。平台登录态是会过期的，重新跑一次python -m tools.cookie_fetcher --config config.yml即可，不用手动改配置。

想重新下载某条视频，程序却一直"已跳过"。它靠"数据库记录 + 本地文件名"双重判断去重，所以重新下载必须同时清掉本地文件夹和数据库记录，只删一边都不会触发重下。具体命令在项目文档里写得很清楚。

收藏夹模式（collect/collectmix）报错。它只能单独使用，不能和 post/like/mix/music 混在一起配置；而且只支持当前登录 Cookie 对应的账号，这点容易被忽略。

直播录完发现只有一个 playlist 文件。HLS 源只保存了播放列表，需要用 ffmpeg 后处理才能合并成可播放的视频；FLV 源则可以直接播放。录制前先确认直播间用的是哪种源。

五、诚实边界：什么情况下，我不建议你用

聊了这么多优点，也该说说它的边界，这能帮你判断它到底适不适合你。

如果你要做商业用途或大规模搬运——不建议。项目本身就声明仅用于技术研究、学习交流与个人数据管理，尊重创作者版权是最基本的底线。

如果你依赖它做生产级服务——要谨慎。它依赖抖音的网页接口，接口策略一变就可能失效，项目自己也把直播的 webcast 接口标记为 experimental。它更适合"个人工具"，而不是"业务依赖"。

如果你完全不想接触配置文件——体验会打折扣。虽然桌面版内测中，但主力使用路径还是命令行 + YAML 配置，需要你愿意读一点文档。

六、现在，选一个作者主页试试

看完这篇，最值得做的下一步不是收藏，而是立刻动手：挑一个你最喜欢、作品最多的作者，把number.post设为 10，先跑通一次完整流程。十分钟后，当你看到 10 条无水印、最高清的视频安静地躺在本地文件夹里，你就知道这套流程搬到 300 条上是什么体验了。

那一刻你会明白，批量下载的意义不只是"省时间"，而是让你真正拥有那些内容——博主删号、作品下架、直播过期，都不再能夺走你收藏过的东西。把工具用起来，建立你自己的抖音资源库，让喜欢的内容真正属于你。

（完整参数说明在项目根目录的USAGE.md与config.example.yml中，核心实现可查看core/与cli/目录源码。）

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