企业官网建设流程全解析

抖音无水印批量下载完整教程：三步给一个主页建立本地档案

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

在 App 里逐条保存到相册，慢、带水印，想存一位博主的作品库更麻烦。douyin-downloader 是一个抖音无水印下载命令行工具：贴上主页或单条视频链接，接口调用与文件写入都发生在你的电脑上，数据不出本机。做完你能得到一套按日期归档的无水印视频、封面与原声档案库。

能力速览

• 全程本地执行：接口请求、下载、落盘都发生在你的机器上，不经过第三方中转。
• 自动去重省空间：SQLite 记录加本地文件双重检查，已下载的作品第二次运行直接跳过。
• 附带资源可选：封面、原声音乐、元数据 JSON 各是独立开关，和视频本体一起存。
• 抗中断：逐条进度显示、失败自动重试、浏览器兜底，限流时也有路可走。
• 边界说清楚：纯命令行工具，没有图形界面；多数接口需要有效 Cookie；部分接口当前受风控限制；请仅用于个人学习与备份。

快速跑通：三步拿到第一个无水印视频

第 1 步：装依赖

要求 Python 3.9 以上。

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

后两条是安装 Playwright 和浏览器内核，Cookie 获取和浏览器兜底都靠它。坑在这：内核不装好，第 2 步跑 Cookie 命令时会直接报错，别跳。

第 2 步：拿 Cookie 并改配置（新手最容易卡的一步）

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

这条命令会弹出一个浏览器，你在里面正常登录抖音，回到终端按 Enter，Cookie 就自动写进 config.yml 了。跑成功的标志：终端无报错，打开 config.yml 能看到 cookies 区块里填上了真实值。坑在这：不要手动改里面单个字段，将来过期了整条命令重跑一次、整套重写就行。

然后只需把link换成你的目标：

link: - https://www.douyin.com/user/xxxx

第 3 步：执行 🚀

python run.py -c config.yml

也可以不走配置文件直接传链接：python run.py -u "https://www.douyin.com/video/xxxx" -t 8 -p ./Downloaded（-t并发数，-p保存目录）。

你会看到终端逐条滚动进度条，结束后目录里按"日期_标题_作品ID"分好文件夹——看到这套结构就算成功了。坑在这：示例配置里的 link 是演示账号，跑之前务必换成自己的。

什么时候才要改配置：只动这几个字段

完整字段说明见 config.example.yml，下表只收录值得动的。

三个真实需求

🗂️ 主页全量归档：把一个创作者变成本地库

目的：某位创作者的所有作品连封面、元数据一起落到磁盘。

number: post: 0 cover: true json: true

跑完看到什么算成功：目录里按"日期_标题_作品ID"逐个分好文件夹，视频、封面、元数据各归其位，一个不缺。

⏰ 每日增量补全：只拉新发布的作品

目的：定期自动运行，只补新作品，不用人盯着。

increase: post: true database: true

再给 crontab 加一行，每天凌晨 2 点跑：

0 2 * * * cd /path/to/douyin-downloader && python run.py -c config.yml

跑完看到什么算成功：第二次运行秒级结束，绝大多数条目显示跳过，目录里只多出几条新文件——去重记录在 SQLite 里，不会重复占空间。

✂️ 按时间段截取：只要最近一个月的作品

目的：只取某段时间内发布的内容，不拉全部历史。

start_time: "2026-08-15" end_time: "2026-09-14"

跑完看到什么算成功：终端打印当前过滤的时间范围，文件名以发布日期开头，肉眼核对全部落在区间内。

排障自查

• 现象：任务大面积失败，提示需要登录原因：Cookie 过期修复：python -m tools.cookie_fetcher --config config.yml整套重写

• 现象：只抓到几条就停，远少于预期原因：翻页被风控限流修复：browser_fallback.enabled: true且headless: false，在弹出的浏览器里手动完成验证；也可调低thread、调高retry_times重跑，去重不会重复下载

• 现象：同标题作品互相覆盖原因：自定义命名模板丢了{id}修复：filename_template里保留{id}变量

• 现象：下载途中磁盘空间不够原因：全量抓取量太大修复：给number.post设上限，或用start_time/end_time收窄范围后重跑

• 现象：提示 Playwright 或浏览器内核未安装原因：只装了 Python 库，没装内核修复：pip install playwright再python -m playwright install chromium

产物还能干什么

• json: true后每个作品多落一份元数据 JSON，作者、发布时间、标题标签都在里面，导入表格就能做内容盘点。
• 下载历史记在dy_downloader.db，一条 sqlite3 查询就能回答"我到底存过哪些东西"。
• 内容库攒大之后，直接浏览本地封面，比翻 App 信息流找回忆快得多。

仅把这套能力用于个人学习、研究与备份，尊重创作者的权益。一次十分钟的配置，换来一个持续更新的无水印本地档案。

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