企业官网建设流程全解析

抖音无水印批量下载工具：视频、音乐、直播采集完整指南

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

想保存某个创作者的全部作品，或把抖音视频里的背景音乐单独存成 MP3？douyin-downloader 是一个抖音无水印批量下载工具，支持视频、图集、合集、原声音乐的采集，带去水印源选择、增量跳过和 SQLite 去重。本文给出从安装到日常使用的完整配置路径，照着做就能跑起来。

项目概览：这个抖音下载工具能做什么

命令行版是主体，另有一个基于同套后端的桌面客户端 Douzy（Beta 阶段），粘贴链接即可发起任务。核心能力清单：

桌面版把任务列表做成了可视化界面，失败可单独重试：

安装与首次运行：抖音批量下载工具怎么装

环境要求 Python 3.8+，macOS / Linux / Windows 均可。最短路径四步：

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

浏览器兜底和 Cookie 自动获取依赖 Playwright，需要额外装一次：

pip install playwright python -m playwright install chromium

抖音接口需要 Cookie 才能稳定访问，推荐用内置工具自动抓取，它会拉起浏览器，你扫码登录后回终端按回车，Cookie 直接写进配置：

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

然后填好配置里的链接，跑起来：

python run.py -c config.yml

第一次建议把number.post设成 20 左右试跑，确认输出目录结构没问题再放开数量。

核心功能详解

抖音作者主页批量下载：模式与数量配置

能做什么：粘贴作者主页链接（/user/{sec_uid}），按模式批量拉取作品、点赞、合集或音乐；短链接v.douyin.com/...也能直接解析。单视频、单图集、单合集、单音乐链接同样支持，且同一aweme_id跨模式不会重复下载。

关键配置：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - music number: post: 50 # 0 表示不限量 music: 0 thread: 5 # 并发数，默认 5

mode可叠加多个；collect/collectmix是登录账号的收藏夹模式，只能单独使用。

效果：文件按作者/post/日期_标题_aweme_id/落盘，每个作品一个文件夹，命名模板由filename_template/folder_template控制（见 config.example.yml）。

抖音无水印视频下载：画质与附带文件

能做什么：默认自动挑无水印源和最高码率档；也可以探测上传原片，拿到比转码档大数倍的原画。

关键配置：

video_quality: original # 或 highest（默认）/ 1080p 等 music: true # 单独保存背景音乐 MP3 cover: true # 保存封面 json: true # 保存元数据（标题、互动数据、作者信息）

效果：附带产物默认全关（只存视频本体），按需打开即可。开启json: true后每个作品多一份*_data.json，包含作者、统计数据、视频参数，做后续分析很有用。

抖音增量更新设置：跳过已下载作品

能做什么：重复运行时跳过已下载的内容，只补新作品，适合定期追更。

关键配置：

increase: post: true database: true database_path: dy_downloader.db

效果：判断逻辑是"磁盘主文件存在才跳过"，SQLite记录历史但不决定跳过（见 storage/database.py）。注意收藏夹模式不支持增量；把某模式设成false则强制重下并覆盖当前筛选范围的文件。

抖音直播录制与评论采集

能做什么：直播链接录制为 FLV，主播下播、网络空闲或手动中断时已录部分都会保留；评论采集为每个作品生成 JSON 数据文件。

关键配置：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 为录到主播下播 comments: enabled: true include_replies: true max_comments: 500

效果：直播文件落在作者/live/下并附_room.json元数据；评论输出{日期}_{标题}_{aweme_id}_comments.json。直播录制属于实验功能，HLS 源只存播放列表，可播输出需要再过一次 ffmpeg。

用法组合：三个真实工作流

定期追更喜欢的作者。什么时候用：关注的博主持续更新，你只想要新内容。搭配：increase.post: true+number.post: 0，再开通知：

notifications: enabled: true providers: - type: bark url: "https://api.day.app/<你的设备Key>"

定时任务每几天跑一次，跑完手机收到推送，失败也会通知，不用盯着终端。

一次性归档特定时间段。什么时候用：只需要某作者某个阶段的内容，避免全量拉取。搭配：

start_time: "2026-06-01" end_time: "2026-06-30" download_pinned: false # 不要置顶作品，避免混入旧内容

时间过滤 +number.post: 0即可把范围圈死在这一个月内。

脚本化 / 服务端集成。什么时候用：要把它嵌进自己的自动化流程。两种玩法：一是 REST 服务模式，POST /api/v1/download提交链接、GET /api/v1/jobs/{job_id}查状态（源码在 server/）：

pip install fastapi uvicorn python run.py --serve --serve-port 8000

二是纯数据抓取不落盘，python run.py --hot-board 30拉热榜、--search "关键词" --search-max 100按词搜视频，都输出 JSONL 文件，方便管道处理。

实践注意：常见问题与解决

现象：批量下载到 20 条左右就停了。原因：抖音翻页风控，API 不再返回后续页。解决：确认browser_fallback.enabled: true且headless: false，弹出浏览器后手动完成验证，别提前关窗口。

现象：报 403 或未登录类错误。原因：Cookie 过期，有效期一般一周到两周。解决：重跑python -m tools.cookie_fetcher --config config.yml，建议设个日历提醒定期更新。

现象：删了数据库记录，想重下某个作品却没动静。原因：跳过判断是"数据库 + 本地文件"双重检查，文件还在就会跳过。解决：本地目录和数据库记录一起清：

rm -rf Downloaded/作者名/post/*_<aweme_id>/ sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '<aweme_id>';"

现象：转写文件没生成。原因：功能未启用、对象是图集（不转写）或 API Key 无效。解决：按顺序查transcript.enabled、是否视频、OPENAI_API_KEY环境变量是否有效。

现象：进度条刷屏、日志重复。原因：进度阶段日志没进静默模式。解决：保持progress.quiet_logs: true（默认值），调试时再临时加-v。

写在最后

douyin-downloader 把无水印下载、批量采集、增量更新、直播录制和评论数据这几件事收进了一个配置驱动的工具里，命令行、REST 服务和桌面版三种入口共享同一套后端，适合做个人内容库的长期维护。

最后提醒：下载的内容仅用于个人学习、研究或备份，请尊重创作者的劳动成果与版权，不要用于商业用途或二次传播。平台接口如有变动导致功能失效，属于正常技术风险。

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