企业官网建设流程全解析

抖音视频下载工具教程：三步跑通抖音批量下载

【免费下载链接】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 是个开源的抖音视频批量下载工具：贴个链接，就能去水印下载视频、图文、合集和音乐，还支持增量更新和直播录制。

适用边界：什么时候需要抖音视频批量下载

值得用：

• 追更某个创作者，想把作品存到本地慢慢看
• 做内容分析，需要把一个账号的历史作品批量拉下来
• 想录下正在进行的直播，又不想开录屏软件挂着

不值得用：

• 想下载别人的收藏夹，collect 模式只支持你自己登录的账号
• 只是偶尔看一眼单条作品，App 里直接看就够了

能力速览：抖音视频下载能帮你做什么

⚙️ 安装并首次运行抖音视频下载

先获取源码并安装依赖（需要 Python 3.8+）：

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

这一步拉取源码并装好 Python 依赖。接着装兜底功能要用的浏览器：

pip install playwright python -m playwright install chromium

装好后，翻页被风控卡住时工具会弹出浏览器，你人工过一下验证码就能继续。然后生成自己的配置文件：

cp config.example.yml config.yml

配置模板 里每个选项都有注释，边看边改即可。最后获取凭据：

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

它会弹出抖音登录页，登录完回到终端按回车，Cookie 就自动写进配置，不用手动复制那一长串字符串。

在配置文件的 link 字段填一条链接，执行第一条下载命令：

python run.py -c config.yml

它通过 run.py 入口启动，终端出现实时进度条，文件默认按「日期_标题_编号」命名。

核心场景一：批量下载作者主页作品

问题。你要分析一个竞品账号，或者把关注的主播完整存档，一条一条点太慢。

操作。把 link 换成作者主页，mode 设为 post，number.post 填数量（0 表示全量）：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50

再运行python run.py -c config.yml。

效果。默认 5 个并发、每秒 2 个请求的限速，稳为主。同一作品在多个模式里出现时只下载一次。文件按「作者 → 模式 → 日期_标题_aweme_id」落到 Downloaded/ 下；默认只存视频本体，想同时要封面、音乐或原始 JSON，把配置里对应开关改成 true。

核心场景二：长期追更的增量更新

问题。每周都要跟进这个账号，重复下载浪费流量和时间。

操作。保持 increase.post: true 和 database: true（默认就是开的），定期跑同一条命令。

效果。工具用「SQLite + 本地文件」双检查跳过已有作品，像一本台账，查一次就知道哪些下过了。删掉本地文件，下次会重新下载，本地文件始终是最终依据。

进阶能力速查：直播、评论、搜索与通知

• 直播录制：把链接换成直播间即可开录，FLV 文件直接能播，主播下播或断网时已录数据保留：

  python run.py -c config.yml -u "https://live.douyin.com/123456789"

  HLS 源只保存 playlist 文件，需要自己用 ffmpeg 处理，按实验性功能看待。

• 评论采集：配置里 comments.enabled: true，include_replies 控制是否拉二级回复，每个作品生成一个 *_comments.json。

• 热搜与关键词搜索：python run.py --hot-board 30导出热搜榜前 30 名快照；python run.py --search "关键词" --search-max 100按词抓作品列表，两者都输出 JSONL 文件。

• 完成通知：notifications.providers 里填 Bark / Telegram / 企业微信 Webhook，任务跑完手机就能收到推送。

• 服务模式：先pip install fastapi uvicorn，再python run.py --serve --serve-port 8000，下载器变成一个可调用的 HTTP 服务，POST /api/v1/download 提交任务。

• 桌面端 Douzy（测试版）：同一套后端的图形界面，贴链接即开始下载，任务中心里能看到每个下载任务的结果并一键重试失败项。

⚠️ 卡住时自查：抖音视频下载的五个常见问题

1. 只能拉出 20 条左右就停。翻页触发了风控上限，坑在这儿：把 browser_fallback.enabled: true 打开、headless: false 保持不动，在弹出的浏览器里人工过验证码，别关太早。
2. 接口突然报错或返回为空。Cookie 过期了。重跑python -m tools.cookie_fetcher --config config.yml刷新登录态即可。
3. like/mix/music 模式中途卡住且没有浏览器兜底。浏览器兜底只对 post 模式完整验证过，另外三种依赖接口正常分页，先排除这个原因。
4. collect 模式不生效。收藏夹只支持你自己登录的账号，而且必须单独使用，和 post、like 混写会失败。
5. 直播录下来的文件放不了。源是 HLS 的话只存了 playlist，要用 ffmpeg 合成；FLV 源则直接能播。

最小可用配置：三条就够

• link：填一条视频链接或作者主页
• mode: [post]，number.post：0 全量、50 最新 50 条
• thread: 5、retry_times: 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