抖音批量下载:5 分钟跑通的配置指南
【免费下载链接】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(抖音下载器)就是为此而做的抖音批量下载工具:粘上主页链接,它自动翻页抓取并并发下载,无水印保存视频,同时落盘封面、音乐与元数据。下文按能力边界、落地步骤、分人群用法三部分讲清楚它的用法。
功能全景:它能处理哪些内容
能力范围比"单条视频下载"宽不少,核心覆盖五类内容:
- 📹 主页作品与点赞列表:全量或限量批量抓取,支持增量更新
- 📚 合集:单合集链接,或整个账号的合集批量整理
- 🎵 音乐原声:独立保存 BGM,缺失时回退到该音乐下的首条作品
- 📺 直播回放:直播间录制,中断或下播时已录部分自动保留
单条视频、图文、短链(v.douyin.com)也能直接解析下载,核心下载引擎 按链接类型自动分派。
🚀 五分钟跑起来:从克隆到第一次下载
准备 Python 3.8+ 后,克隆仓库并安装依赖:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txtCookie 是访问抖音接口的凭据。用自带的 Cookie 获取工具 自动完成(需先pip install playwright并安装 chromium):
python -m tools.cookie_fetcher --config config.yml浏览器中登录抖音后回到终端按 Enter,Cookie 会自动写入配置文件。然后复制 示例配置 并改成你的目标:
cp config.example.yml config.ymllink: - "https://www.douyin.com/user/目标用户ID" path: ./Downloaded/ mode: - post启动下载:
python run.py -c config.yml临时想加一条单视频链接,不必改文件,命令行用-u追加即可。
下载结果长什么样:目录结构与进度
下载完成后按"作者 / 模式 / 作品"三级目录组织,每个作品一个独立文件夹:
Downloaded/ └── 作者名/ ├── post/2024-02-07_作品标题_aweme_id/ ├── like/ ├── mix/ └── music/作品文件夹内是同名前缀的视频、封面、音乐、元数据 JSON 等文件,目录名日期取自作品发布时间而非下载时间,方便按时间轴回看。
去重靠 SQLite 数据库 记录加本地文件名双重判断,已下载的作品直接跳过;配合increase增量更新开关,第二次运行只拉新作品。中途断网中断后重跑同样安全,不会重复下载。桌面端的任务中心(与命令行共享同一套后端)还能汇总每个任务的成功、失败计数:
三类人各自的用法:创作者 / 运营 / 个人收藏
内容创作者:把对标账号的主页链接写进link列表,mode同时开启post和music,作品和原声一次到位。多个账号可以放在同一份配置里排队跑,跨模式自动去重保证同一条作品只落盘一次。
运营人员:桌面端 Douzy 支持关注列表同步,能筛出有新作品的博主逐个下载;命令行侧则适合写进定时任务,配合增量开关做每周自动存档,再用download_manifest.jsonl清单统计发布频率。
个人用户:把自己收藏的合集和点赞视频整包存到本地,离线回看不受平台变动影响,等于给个人数字资产做一份备份。
⚙️ 进阶开关:让下载更稳、更快
常用调优项都集中在配置文件里,可按需打开:
thread: 5 # 并发线程,建议 3-5 increase: post: true # 增量更新,只下新作品 start_time: "2025-01-01" # 时间过滤起点 end_time: "2025-12-31" # 时间过滤终点 browser_fallback: enabled: true # 翻页受限时浏览器兜底 headless: false # 显示窗口,方便人工过验证通知推送(Bark / Telegram / Webhook)也属于同一类开关:长任务在后台跑,跑完或失败时手机直接收到结果,不用守着终端。
命令行 vs 桌面端:一张表帮你选
同样是这台抖音下载工具,两种形态的定位不同:
| 维度 | 命令行版 | 桌面端 Douzy |
|---|---|---|
| 上手成本 | 自备 Python 环境 | 安装包即用 |
| 配置灵活度 | 完整 YAML 加命令行参数 | 常用选项图形化 |
| 关注同步 | 手动粘贴主页链接 | 自动同步、筛选新作品 |
| 适合谁 | 开发者、定时任务脚本 | 普通用户、内容团队 |
卡住了?三个高频问题速查
问:为什么只能抓到 20 条作品?答:这是翻页触发风控的典型表现。把browser_fallback.enabled设为true、headless设为false,浏览器弹窗出现后手动完成验证,不要急着关窗口。
问:Cookie 失效或获取失败怎么办?答:重新运行python -m tools.cookie_fetcher --config config.yml,登录抖音后按 Enter 自动写回配置;也可以手动编辑配置文件中的cookies段。首次失败先确认执行过playwright install chromium。
问:想重新下载某条作品,为什么它一直被跳过?答:去重依赖"数据库记录 + 本地文件名"双重检查。删除Downloaded下对应的作品目录,再清掉dy_downloader.db中对应记录,重跑即可重新下载。
Douyin Downloader 把批量抓取、去重存档、断点重跑做成了开箱即用的流程,命令行与桌面端共享同一套引擎,换端不丢下载历史。对需要长期跟踪抖音内容的创作者和团队来说,它是少维护、可直接并入日常流程的开源选择。
项目采用 MIT 协议开源,代码与 配置样例 都可以直接审查。遇到平台接口变化导致功能失效时,到仓库 Issues 提交复现信息即可;想参与开发,可用git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader拉取源码,从测试用例入手提 PR。
【免费下载链接】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),仅供参考