企业官网建设流程全解析

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 是一个命令行抖音批量下载工具：给它一个作者主页链接，它自动挑无水印源，把作品、封面、原声、元数据一并落到本地，重跑时只补新内容、不重复占空间。整篇文章围绕一份 config.yml 展开——配置写到哪一行，对应的操作就嵌在哪一段，照着改两个值就能跑起来。

config.yml 是唯一要改的文件

工具的全部行为都由一份 YAML 配置驱动，改配置文件就够了，不用背命令行参数。所以第一步不是敲命令，而是先把依赖装好、把 Cookie 拿到手。

装依赖、拿 Cookie，一次到位

克隆并装依赖：

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

复制配置模板：

cp config.example.yml config.yml

模板里已写好一个示例作者主页链接，number.post 是 1，第一次跑只下 1 条用来验证环境。config.example.yml 就是这份模板，后面所有开关都在它里面。

Cookie 是网页版登录凭证，工具靠它读作品数据。手动从浏览器开发者工具复制容易漏字段，推荐跑自动获取：

装浏览器内核（Cookie 抓取和浏览器兜底都要用）：

pip install playwright python -m playwright install chromium

自动获取 Cookie：

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

浏览器弹出后扫码登录，回到终端按 Enter，Cookie 就写进了 config.yml。抓取逻辑在 tools/cookie_fetcher.py。

⚠️ Cookie 有效期一般只有几天到几周，报 403 或提示未登录时，重跑上面这条 cookie_fetcher 命令重新扫码即可。

先下 1 条，验证环境

首次运行：

python run.py -c config.yml

进度条走完，第一条视频就落在 Downloaded 目录里。看到文件落地，环境就算通了。

link、mode、number：三个值决定下载范围

配置里真正控制"下谁的、下多少、下哪段"的只有三处。

全量存档：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 0 # 0 表示不限条数

link 填目标作者主页，mode 用 post 表示作品列表，number.post 写 0 就不限数量。作品按发布时间倒序拉，封面、原声、元数据按 video、cover、music、json 这几个开关决定是否一起存。同样 200 条作品，手动逐条点保存要两小时，一条命令并发跑十几分钟就落地。作者作品量大时，先把 number.post 设成 100 这类具体数字验证流程，跑顺了再放开成 0。

只想留某个月的作品时，填两个日期边界，工具翻到早于 start_time 的作品就提前停，省掉大量翻页：

只下上个月：

start_time: "2026-08-01" end_time: "2026-08-31" # YYYY-MM-DD，end 含当天整天

增量下载配置：重跑只补新作品

创作者持续更新时，每周用同一份配置跑一次、只想拿新增作品，把增量开关打开就行。它靠 SQLite 记录历史、再和本地文件互相核对，同一份配置随时重跑只补新内容。

增量开关：

database: true database_path: dy_downloader.db increase: post: true # 跳过已下载，只补新作品

去重逻辑在 storage/database.py：判断一条作品是否已下过，以本地媒体文件是否存在为准。

⚠️ 增量判断看的是本地文件。删掉文件会触发重下；只删数据库记录则不会重下，要重下得连文件一起清。

不想敲命令行的话，桌面版 Douzy 的"关注"页也会盯着关注列表的新作品：

从报错反推：20 条封顶、403、跑太慢

批量下载卡住基本就这三种，反推回去都是配置里某一行没开对。

只抓到 20 条左右就停：是抖音对作品列表翻页做了风控。开浏览器兜底，弹窗出来手动过验证再关：

开浏览器兜底：

browser_fallback: enabled: true headless: false

上周能跑、这周报 403 或未登录：Cookie 过期了，重跑 cookie_fetcher 重新扫码一次即可，不用动配置。

进度推进很慢、大批量跑不完：默认并发 5、速率 2 请求/秒偏保守。调高并发，网络不稳再挂代理：

提速：

thread: 8 # 并发数，建议不超过 8 proxy: "http://127.0.0.1:7890"

⚠️ 并发不建议超过 8，过高更容易触发风控，反而抓得更少。

把视频变文字，把下载嵌进自己的系统

想把视频内容变文字，开转写开关，每条视频会在同目录多生成 txt 和 json：

开启转写：

transcript: enabled: true api_key_env: OPENAI_API_KEY

密钥建议放环境变量里。想在自己的系统里提交链接、拿任务 ID 查状态，就把工具起成 REST API：

起 REST API 服务：

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

不想碰命令行，还有内测中的桌面版 Douzy，粘贴链接即可开始批量下载：

任务中心列出每条下载结果，失败项可以直接重试：

下载完的文件默认在 Downloaded/ 下，按作者名、模式、作品名三级目录整理，历史记在 dy_downloader.db 里。把 config.yml 里的示例链接换成目标作者主页、改好 number，运行python run.py -c config.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