企业官网建设流程全解析

douyin-downloader：抖音去水印下载上手与批量抓取实操

【免费下载链接】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 是一个免费开源的抖音去水印批量下载工具，适合想把某个作者的作品存到本地硬盘的人。跟着下面操作，你十分钟内能从零下载到第一条无水印视频，之后还能整页搬走一位创作者的主页。

一次跑通：四步拿到第一条无水印视频

这一节是第一次跑通的最短路径，照着在终端里依次敲就行。

第 1 步：装好依赖

前提是本机有 Python 3.8 及以上。

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

看到依赖全部安装完成、终端没有报错即代表成功。装得慢就临时给 pip 切个国内镜像源。

第 2 步：准备一份配置

cp config.example.yml config.yml

看到目录里多了 config.yml 即代表成功。模板里每个字段都带了默认值，你只需要改链接。

第 3 步：扫码拿 Cookie

pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml

命令会弹出浏览器，扫抖音码登录，回终端按回车。看到 config.yml 里 cookies 段被自动填上即代表成功。凭证只存在你本地。

第 4 步：跑第一次下载

打开 config.yml，只改链接这一处：

link: - 你的实际抖音链接 path: ./Downloaded/

然后运行：

python run.py -c config.yml

看到 Downloaded/ 目录里出现第一个无水印视频，即代表成功。

它能帮你干什么：作品、合集、收藏归档

这一节按"你想存什么"分场景，每个场景都只需要改配置里的几个字段，剩下的事它自动做。

📦 整页搬走一位创作者的主页

douyin-downloader 抖音去水印下载桌面版主界面

粘贴作品或主页链接，勾选下载内容即可开始

想批量保存作者发布的作品 → 改这里的配置：

link: - 作者主页链接 mode: - post number: post: 50 # 0 表示全量

多个任务并发跑，各自有独立进度条，失败项自动重试。post、like、mix、music 还能写在同一份配置里，同一个作品跨模式不会重复下载。

⏱️ 只抓某个时间段的作品

想只留某段时间内发布的作品 → 改这里的配置：

start_time: "2024-06-01" end_time: "2024-06-30"

🚫 已下载过的不再下第二遍

想让第二次运行只抓新作品 → 改这里的配置：

database: true increase: post: true

每次下载的作品 ID 都会记进本地 SQLite 数据库，下次自动跳过已记录的。

❤️ 把自己的收藏批量搬走

想换设备前归档自己的收藏 → 改这里的配置（依赖第 3 步的登录态）：

link: - https://www.douyin.com/user/self?showTab=favorite_collection mode: - collect

注意 collect 和 collectmix 必须单独使用，不能跟 post、like 混在一份配置里。

进阶与调优：三个值得开的开关

这一节只挑三个最常用的进阶能力，各配一段最小配置，直接粘就能用。

📺 直播录制：下播自动收尾

想录一整场直播 → 改这里的配置：

link: - live.douyin.com/房间号 live: max_duration_seconds: 0 # 0 = 录到主播下播

主播下播、断网或你按 Ctrl+C，已录制的字节都会保留，临时文件自动转成正式文件。

🧭 翻页被卡时开浏览器兜底

想主页翻页不卡住 → 改这里的配置：

browser_fallback: enabled: true headless: false

API 翻页被风控限制时，会自动弹一个浏览器继续抓取，你手动过一下验证就行。

📝 给视频配一份文字稿

想让视频能用文字检索 → 改这里的配置：

transcript: enabled: true model: gpt-4o-mini-transcribe

把OPENAI_API_KEY设进环境变量即可，每个视频会多一个 txt 文字稿。只对视频作品生效，图文不转写。

接入你的工作流：任务挂进脚本和手机

下面三个入口，可以把下载任务接进你自己的流程。

• REST API 服务：先pip install fastapi uvicorn，再python run.py --serve --serve-port 8000，用接口提交任务、查询进度，方便写进自动化脚本。
• 完成通知推送：在配置的 notifications 段加 provider，支持 bark、telegram、webhook 三类，任务跑完手机直接收到。
• 任务中心：桌面客户端和命令行同一套后端，任务状态、成功失败数和输出目录集中在一处看。

douyin-downloader 任务中心查看下载任务状态

任务中心：每个下载任务的状态与数量集中展示

避坑手册：四个高频现象及处理

这四条是最容易碰上的情况，各给原因和解法。

1. 遇到反复提示登录失效或 403 时：Cookie 是张会过期的门钥匙，有效期一般一到两周。重跑python -m tools.cookie_fetcher --config config.yml扫一次码就行，建议每周更新一次。
2. 遇到主页翻页停在 20 条不再增加时：这是分页被风控限制。确认开了browser_fallback.enabled: true且headless: false，弹窗出来后别急着关窗口，等它跑完验证。
3. 遇到想强制重下却被跳过时：程序靠"数据库记录 + 本地文件"双重去重。只删文件会触发重新下载，只删数据库不会，因为文件名的作品 ID 也会被扫到。
4. 遇到批量任务跑得慢或资源占用高时：把并发thread（默认 5）调小，单次任务控制在五六十条，跑之前先确认磁盘余量。

第一次跑通之后，建议先挑一条单视频链接确认落盘文件无水印，再换成某位创作者的主页试一次批量，用 number 和时间范围约束住范围。等批量顺手了，再把增量开关打开，以后每次运行只拉新增内容。

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