抖音下载器完整使用指南从零开始批量备份视频、合集与直播回放【免费下载链接】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这个开源工具就是专门解决这类麻烦的。它能批量下载视频、图集、合集、音乐也能录制直播回放全程自动去重还带进度条和失败重试。这篇指南就带你从零开始完成把一位博主的主页全部作品备份到本地这个真实任务。它到底能帮你解决哪几类麻烦在动手之前先看看它覆盖的常见需求整页备份一位博主发布过的所有作品一条命令全下载直播回放直播间录制成 FLV 文件主播下播也不丢数据合集与音乐收藏的合集、作者用过的原声都能单独拉下来收藏夹迁移把当前登录账号的收藏夹内容同步到本地顺手的加分项无水印优先、自动选最高清、SQLite 去重、浏览器兜底一句话搞懂它的工作原理你可以把抖音下载器想象成一条流水线拿到链接 → 解析成作品 ID → 调用抖音接口取数据 → 按你的配置下载视频和附加资源 → 记录到本地数据库。其中数据库SQLite很关键它记下每个已下载的作品 ID。下次再跑同一作品会被自动跳过——这就是智能去重的由来也让重复下载变得毫无压力。任务主线备份一位博主的主页我们一步步来全程不超过十分钟。第一步安装环境确认电脑上有 Python 3.8 以上版本然后拉取项目并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如果之后想用浏览器兜底功能后面会讲再补一句pip install playwright python -m playwright install chromium第二步扫码登录自动写入 Cookie抖音接口需要登录凭证。项目内置了自动获取工具扫码登录一次即可不用手动去浏览器里翻 Cookiepython -m tools.cookie_fetcher --config config.yml命令执行后会弹出浏览器你扫码登录抖音然后回到终端按回车凭证会自动写进配置。这个工具对应的源码在douyin-downloader/tools/cookie_fetcher.py想研究细节可以自己看。小提示Cookie 是有时效的。过段时间发现下载报未登录重跑这条命令刷新一次就行。第三步准备一份配置文件复制模板然后按需修改cp config.example.yml config.yml把下载目标换成你想备份的博主主页链接在抖音 App 里点分享复制链接即可link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post music: true cover: true avatar: true json: true thread: 5 retry_times: 3 database: true几个关键项的说明mode: post表示下载该博主发布的作品改成like就是下载 TA 点赞过的内容thread: 5是并发数网速不好可以降到 3database: true开启去重和历史记录强烈建议保留想限制数量加一行number.post: 50只下 50 个设为 0 表示全量第四步运行下载看它干活python run.py -c config.yml你会看到一个实时进度界面每个作品的状态、进度百分比、耗时都一目了然。下面这张图是下载进行中的实际效果如果只想临时下单个视频不用改配置直接命令行追加python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538第五步查看下载结果下载完成后文件会按作者 → 模式 → 作品的层级自动归类。每个作品是一个独立文件夹里面有视频、封面、背景音乐和元数据 JSON一个作品文件夹通常包含四类文件.mp4视频、cover封面图、music原声音乐、result.json元数据。不想全部保留的话在配置里把对应项改成false即可比如cover: false。关键技巧增量下载以后只补新的第一次全量备份完成后博主可能又更新了。你不需要重新下一遍打开增量开关increase: post: true database: true之后每次运行程序会对比数据库记录只下载新增作品。这个机制配合去重非常适合每周定期同步的用法。中途插播最容易踩的三个坑坑一只能抓到 20 条作品。这是翻页风控的常见现象。解决办法是确认browser_fallback.enabled: true且headless: false运行时会弹出浏览器你手动完成一次验证即可继续翻页。坑二进度条疯狂刷屏。默认配置里progress.quiet_logs: true已开启静默模式。如果还觉得乱调试时临时加-v看详细日志平时不要开。坑三重新下载不生效。这个工具是数据库记录 本地文件双重去重。只删数据库不删文件不会重新下载只删文件不删数据库会触发重新下载。想彻底重来就清空Downloaded/目录并删除dy_downloader.db。进阶玩法直播回放、合集与收藏夹一个任务做完工具的其他本事你也可以随时启用入口都是同一个配置文件。录制直播回放把链接换成直播间地址并加上直播参数link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 chunk_size: 65536 idle_timeout_seconds: 30录制的 FLV 文件保存在Downloaded/作者名/live/下。主播下播、网络空闲或你按 CtrlC 中断已录制的数据都会被保留不会白录。直播录制模块在core/live_downloader.py想深入可以翻翻。下面是直播下载时选择清晰度的界面示例下载合集与音乐link: - https://www.douyin.com/collection/7341234567890123456mode 换成mix可以下载作者的所有合集music则下载作者用过的原声。甚至可以同时列多个模式跨模式还会自动去重mode: - post - like - mix - music备份自己的收藏夹把链接换成收藏夹地址mode 用collect就能把当前登录账号收藏的作品全部同步到本地link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect常见问题速查表症状解决办法提示未登录 / 登录失效重跑python -m tools.cookie_fetcher --config config.yml刷新 Cookie只能抓到 20 条作品检查browser_fallback.enabled: true浏览器弹出后手动过验证码下载速度慢调低thread并发数或配置proxy走代理不想下音乐/封面对应项设为false如music: false重复下载同一批视频确认database: true已开启若想强制重下清文件或清数据库记录下载中断后想继续直接重跑同一命令已完成的会被自动跳过给已经上手的你两个升级方向方向一把工具变成后台服务。安装 fastapi 和 uvicorn 后可以用服务模式启动pip install fastapi uvicorn python run.py --serve --serve-port 8000之后通过 HTTP 接口提交下载任务、查询任务状态适合做成小工具或接进自己的脚本。方向二试试桌面版客户端。项目配套的桌面版Douzy基于同一套后端粘贴链接即可开始还能同步关注列表、按作者筛选下载历史对不习惯命令行的朋友来说这是更友好的入口。桌面版的任务中心可以直观看到每个任务的进度和结果写在最后从手动存一个视频到一条命令备份整个主页你只需要四步装依赖、扫码登录、改配置、跑命令。剩下的去重、重试、分类、断点续传工具都替你处理好了。现在就去试试吧——把你最常看的博主主页链接丢进配置跑一次完整的批量下载你会立刻体会到一键归档的爽感。如果中途卡住回来看一眼上面的速查表大部分问题都能自己解决。温馨提示请仅用于个人学习、研究和数据管理遵守平台规则尊重创作者版权避免高频大量抓取。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考