一次配好的抖音视频批量下载：主页全量保存、去水印、已下载的自动跳过

一次配好的抖音视频批量下载：主页全量保存、去水印、已下载的自动跳过

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

你要做的是抖音视频批量下载：5 个主页、上百条作品，逐条保存再逐条去水印，是一场慢动作灾难。抖音下载器 douyin-downloader 把这类任务一次接住——粘贴链接即可批量保存无水印视频，自动挑选最高码率，已下载的作品直接跳过。

🧰 它能帮你干完哪几件事

主页作品，整列存盘

你在做素材收集或竞品盯防，把作者主页链接填进配置的link，mode设post（想连点赞、合集、音乐一起抓，就加like、mix、music），它会翻页把无水印 mp4 存下来，还能按需带上封面_cover.jpg、原声_music.mp3和_data.json元数据。

自己的收藏夹，批量备份

用你登录的 Cookie，mode填collect（收藏作品）或collectmix（收藏合集），整个收藏夹就能整批落盘，number填0表示不限条数。

数据，成批导出

你在做话题研究，把comments.enabled设为true，每个作品会在文件旁生成{date}_{title}_{aweme_id}_comments.json（可选二级回复）；--hot-board 30把热搜榜快照导出成Downloaded/hot_board/下的 JSONL，--search "关键词" --search-max 100把搜索结果按同样格式导出，直接喂给分析脚本。

两个长尾场景

想录直播，粘贴live.douyin.com/{房间号}直播间链接即可，录成 FLV，主播下播时已录内容自动保留；想给视频要文字稿，打开transcript，下载完成后调 OpenAI 转写 API 生成.transcript.txt。

桌面版与 REST API

同一套后端还有内测中的桌面客户端 Douzy：粘贴链接开始下载，任务中心里看每个任务的进度和失败原因。

想把它接进自己的流程，先装fastapi uvicorn，再跑python run.py --serve --serve-port 8000，其他程序通过POST /api/v1/download提交链接、从/api/v1/jobs/{job_id}轮询状态即可。

🚀 从零到第一次成功

需要 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

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

第二条命令会自动弹出浏览器，你在浏览器里正常登录抖音，回到终端按 Enter，Cookie 就写进了 config.yml 的cookies段。Cookie 有有效期，失效了重跑这条命令就行。

第四步：跑第一个下载

python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538"

跑完去Downloaded/目录看结果：按「作者名 / 模式 / 日期_标题_aweme_id」分层存放，文件名里都带着作品 aweme_id，这正是后面去重的依据。要改成批量任务，只需把主页链接填进配置的link，用mode和number圈定范围：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [post, like] number: post: 50

然后python run.py -c config.yml跑批。

🎛️ 用顺手之后，值得动的 3 个开关

增量下载怎么开

database: true（默认开）会把下载历史写进 SQLite 文件dy_downloader.db。保持increase.post: true，第二次运行只抓新发布的作品；改成false则忽略历史、在筛选范围内强制全量重抓。

视频画质怎么选

video_quality默认highest，在 API 返回的转码档里挑bit_rate最高的一档；改成original会额外探测上传原片（可比最高转码档大数倍，代价是每条作品多一次探测请求）；也可以指定1080p、720p等分辨率，匹配不到自动降到最接近的档。

触发风控时浏览器替你兜底

API 翻页被平台风控卡住时，browser_fallback.enabled: true且headless: false的配置下，程序会自动弹出一个真实浏览器，你在窗口里手动过掉验证码，它继续滚动拉取（默认最多 240 轮）。失败下载按 1s / 2s / 5s 指数退避重试 3 次，默认 5 个并发、令牌桶限到 2 请求/秒，这一组默认值一般不用动。

⚠️ 跑之前先看这 5 条

• 置顶作品为什么没出现—download_pinned默认false，主页置顶作品不参与抓取，想带上就改成true。
• 只抓到 20 条左右就停了— 翻页风控的典型信号。确认browser_fallback.enabled: true、headless: false，浏览器弹窗出现后手动完成验证，别急着关窗口。
• 别人收藏夹的链接报错—collect/collectmix只认当前登录 Cookie 对应的账号，且必须单独使用，不能和post/like/mix/music混在同一个mode里。
• 删了记录为什么不重新下载— 去重是数据库记录 + 本地文件名双重检查：只删数据库记录不会触发重下；想重抓某条作品，删掉它在Downloaded/下对应目录（名字含 aweme_id）即可，下次运行会补齐缺失文件。
• 为什么没有转写文件— 转写只对视频作品生效，图文不转写。依次核对：transcript.enabled是否为true、OPENAI_API_KEY是否有效、response_formats里有没有txt或json。

🤝 谁适合，谁先别上

如果你需要成批保存无水印素材、抓取主页作品和评论数据做研究，或者想把下载能力通过 REST API 接进自己的流程，它正中靶心；如果你想下载别人的收藏夹，或指望全程无人值守（浏览器兜底需要人工过验证码），先缓一缓。项目采用 MIT 协议开源、免费使用，参数细节看 README.zh-CN.md 和 config.example.yml。

从你手上第一个主页开始试跑，跑完第一轮你就知道它合不合你的工作流。

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