一步步搞定抖音批量下载：douyin-downloader 免费工具从安装到进阶的完整记录

一步步搞定抖音批量下载：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，开源免费、支持无水印，视频、图集、合集、音乐原声都能整整齐齐存到本地。

这篇文章不想给你一份冷冰冰的功能说明书。我想带你走一遍真实的使用旅程：从"下载到一半断网、崩溃的不只是进度条还有心态"的新手，到能定时批量收藏、顺手采集数据的熟练用户。你会看到每一步会踩什么坑、为什么这样配、以及怎么把它变成你的日常习惯。

一、先承认一件事：收藏不等于下载

我最初的需求很简单：喜欢的视频存下来，留着做素材、离线看。于是我试过几种"老办法"，结果都很劝退：

• 手机录屏：画质打折不说，满屏水印，二次创作基本没戏。
• 第三方解析网站：打开一堆弹窗广告，填验证码，下载的还不是原画质，隐私风险也说不清。
• 手动一个个存：一个博主几十条视频，打开、下载、重命名、归档，一晚上就没了。

后来我算了一笔账，发现差距不是一点点：

这款工具的用法，就是"把链接交给它"。单个视频可以，作者主页批量也可以，合集、音乐、图文、直播，它都能接。下面跟着我的真实操作走一遍，你会发现它比想象中简单。

二、第一次安装：三步走完，附赠两个坑

我的环境是 Windows + Python 3.8+，macOS 和 Linux 同样支持。安装就三条命令：

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

git clone把项目代码拉下来，cd进入目录，pip install装齐它用到的第三方库。如果网络慢、装依赖经常超时，换成国内镜像通常一次就过：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

这里有两个新手容易卡住的地方，提前说：

坑一：装了依赖还不够，要装浏览器组件。工具内置"浏览器兜底"能力，在接口被平台风控时，会自动打开一个真实浏览器替你完成验证。这个功能需要单独装 Playwright：

pip install playwright python -m playwright install chromium

想省事可以跳过这步，但后面翻页受限时你会后悔（这个问题我在后面"踩坑合集"里细讲）。

坑二：别急着改配置，先复制一份示例。项目自带config.example.yml，直接复制一份开始用：

cp config.example.yml config.yml

（Windows 用户用copy config.example.yml config.yml。）

装完之后先别急着跑，还有一步更关键的——让程序"认识你"。

三、为什么必须先搞定 Cookie：一张进入平台的"工牌"

我第一次直接运行，结果提示登录态失效，一脸懵。后来才明白：抖音的大部分内容接口需要登录状态，而 Cookie 就是你的"工牌"——它告诉服务器"这是真实用户在访问，不是爬虫"。

好在不用手动去浏览器开发者工具里抠 Cookie，工具自带自动获取：

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

运行后会自动弹出一个浏览器窗口，你正常登录抖音即可。登录成功后回到终端按一下回车，程序会把 Cookie 自动写进配置文件，还会带上msToken这类辅助参数——手动复制很容易漏，这一步能省很多事。

有一点要记在心上：Cookie 通常有 7~30 天的有效期。哪天运行报"登录态失效"，重新跑一遍这条命令就行，不用重装任何东西。

四、第一次成功下载：看懂一行命令背后的流程

拿到 Cookie 之后，我编辑config.yml，放了一份最精简的配置：

# 要下载的链接：可以是单个视频、图文、合集，也可以是作者主页 link: - https://www.douyin.com/user/MS4wLjABAAAA换成目标用户ID # 保存位置 path: ./我的抖音素材/ # 下载哪些内容：post=发布的视频，like=点赞过的视频 mode: - post - like # 数量限制：0 表示不限制，全量下载 number: post: 0 like: 0 # 并发线程数，3~5 最稳妥 thread: 5 # 失败重试次数 retry_times: 3 # 每秒最大请求数，防止触发风控 rate_limit: 2 # 附带资源：音乐原声、封面图、JSON 元数据 music: true cover: true json: true # SQLite 去重：已下载过的自动跳过 database: true database_path: dy_downloader.db

这份配置里，最关键的是mode、number和database三个字段：mode决定"下什么"，number决定"下多少"（0 就是不设上限），database决定"要不要记住下过什么"——它直接关系到你以后会不会重复劳动。

然后运行：

python run.py -c config.yml

接下来你会看到工具依次做这些事：解析链接（短链接也会自动还原）→ 识别内容类型（视频 / 图文 / 合集 / 音乐）→ 创建对应下载器 → 进入队列并发下载 → 校验文件完整性 → 写入去重记录。全程有进度显示，每一步做了什么都能看到：

顺带一提，项目还有一款内测中的桌面版客户端，界面更直观——上面两张截图就来自桌面版。它和命令行版共用同一套后端逻辑，配置字段完全通用，你在这篇文章里学到的一切，在桌面版里同样成立。

下载完成后，本地目录会自动按"作者 → 内容类型 → 作品"组织好，每件作品一个文件夹，里面是视频、封面、音乐和 JSON 元数据：

第一次成功之后你会明显感觉：原来 10 分钟能搞定以前一小时的活。

五、从"下载一个"到"批量收藏"：真正的分水岭

单条链接下载只是开胃菜。douyin-downloader 真正拉开差距的地方，是把作者主页整个搬下来。

你只要把链接换成作者主页，再配置好mode，就能一次拿全：

• post：该博主发布的所有作品
• like：该博主点赞过的视频（适合研究他喜欢什么）
• mix：该博主创建的所有合集
• music：该博主用过的原声音乐

假设你是个内容创作者，想给剪辑工作攒素材库，会这样配：

link: - https://www.douyin.com/user/创作者A的主页 - https://www.douyin.com/user/创作者B的主页 path: ./创作素材/{date}/{author}/ mode: - post - like music: true cover: true json: true thread: 5 start_time: "2024-01-01" end_time: "2024-12-31"

start_time和end_time是时间过滤，只下载指定日期区间内的作品；path里的{date}、{author}是动态变量，工具会自动替换成实际值，让文件按时间、作者自动归档。

如果你对命名有更细的要求，还可以自定义模板。比如{date}_{title}_{id}会把文件命名成"2024-06-01_爬山vlog_7412345678901234567"这样的格式，{id}保证不重名。桌面版的设置页里可以直接配置这些规则：

批量下载时，工具会显示每个任务的实时进度，排队、解析、下载、完成各环节一目了然：

一个提醒：批量抓取时如果只拿到前 20 条就停了，别慌，那是平台的翻页风控，具体解法见后面的踩坑合集。

六、进阶第一课：只下载"新的"，拒绝重复劳动

批量收藏用了一阵子，我开始遇到另一个问题：每周都全量重跑一遍，等于把以前下过的东西又下了一遍，浪费流量和时间。

这个问题的解药是"增量下载"：

database: true database_path: dy_downloader.db increase: post: true like: true mix: true music: true

原理很简单：程序把每个已下载作品的 ID 记在 SQLite 数据库里，同时还会扫描本地文件名做二次核对。下次运行时，凡是数据库和本地文件里都存在的，直接跳过，只下载新内容。

中途断网、断电也不用慌。它的完整性校验会自动比对文件大小，发现不完整就清理掉重新下载，已完成的部分绝不浪费——就像追剧时"自动续播"，不用从头看起。

想确认自己到底下过什么，一条命令就能查历史：

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

桌面版里也有对应的"作品档案"页面，支持按作者、关键词、时间筛选，最近常看的博主一目了然，还带"下载最新作品"按钮：

到这里，"保存内容"这件事基本圆满了。但如果你的需求不止于存视频——比如你是做研究或做账号分析的，工具还能再往前一步。

七、进阶第二课：让工具替你干活

场景一：研究人员的系统性数据采集

做内容分析最头疼的是数据零散。douyin-downloader 下载时默认生成 JSON 元数据，包含标题、发布时间、作者信息、点赞评论收藏数、视频分辨率、音乐信息等。配合评论采集，就是一套现成的数据集：

comments: enabled: true include_replies: true max_comments: 500 page_size: 20

开启后每个作品会额外生成一份*_comments.json，连二级回复都能拉。此外还有两个命令行小工具：--hot-board拉取热搜榜、--search按关键词搜索作品，结果都以 JSONL 格式落盘，用 Python 的 pandas 或者 Excel 就能直接做后续分析。

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

场景二：直播内容想要留存

直播也是可以"下载"的。只要把链接换成live.douyin.com/房间号，并在配置里开启直播录制：

link: - https://live.douyin.com/你的直播间房间号 live: max_duration_seconds: 0

max_duration_seconds: 0表示一直录到主播下播；哪怕中途网络空闲或手动中断，已录制的部分也会被保留，不会白录。录制界面会先解析出直播间清晰度供你选择：

让任务自己跑：定时批量下载

把命令装进系统的定时任务里，每天早上自动更新素材库，睡醒就能用：

0 3 * * * cd /你的路径/douyin-downloader && python run.py -c daily.yml >> download.log 2>&1

再配合下载完成通知（支持 Bark、Telegram、Webhook 推送），下完了手机立刻收到提醒，真正实现"无人值守"。

八、踩坑合集：三个高频问题，对症下药

用了一个月，我把踩过的坑和网上问得最多的问题整理成了这份"对症下药"清单：

问题一：批量下载只出 20 条就停了？这是抖音的翻页风控，不是工具坏了。确认配置里开启了浏览器兜底：

browser_fallback: enabled: true headless: false

然后重新运行，当浏览器窗口弹出时，手动完成验证码再关窗口，验证通过后翻页就恢复了。

问题二：下载速度慢、频繁失败？抖音对单 IP 的请求频率很敏感。建议把thread控制在 3~5，保留rate_limit: 2限制每秒请求数。如果批量任务量大，还可以在proxy里配置代理来分流请求。

问题三：Cookie 失效报"登录态失效"？Cookie 过期是最常见的提示。重跑python -m tools.cookie_fetcher --config config.yml重新登录一次即可，不需要重装任何东西。

九、常见问题速查

Q1：douyin-downloader 需要登录才能用吗？大部分内容接口需要登录态，建议第一步就用自带的 Cookie 获取工具完成登录，一劳永逸。

Q2：下载下来的文件都存到哪了？默认在配置文件path指定的目录下，按"作者 → 类型 → 作品"自动分层；每件作品包含视频、封面、音乐（可选）和 JSON 元数据（可选）。

Q3：想重新下载某个作品怎么办？删除对应的本地文件，再删掉数据库里那条记录即可。只删文件或只删数据库都不会触发重新下载，两边保持一致才算数。

Q4：视频转文字能实现吗？可以。工具内置了可选的语音转写功能，下载视频后调用转写接口生成transcript.txt，适合做内容检索和二次创作。

十、最后说几句心里话

回头看看，从第一次笨手笨脚地装环境，到现在定时任务每天自动更新素材库，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