企业官网建设流程全解析

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 是一个基于 Python 命令行运行的抖音下载工具，输入链接加一份 YAML 配置即可批量下载无水印视频、图文、合集与原声音乐，内置重试、SQLite 去重和浏览器兜底，适合需要长期归档个人抖音内容的普通用户和脚本爱好者。

能力速览：先看这张表再决定要不要读下去

想跳过安装细节直接看场景：场景一：单条去水印、场景二：主页批量。

场景一：下载一条无水印视频

📌 解决的问题：把一条别人分享的抖音作品存成无水印 mp4，落到本地固定目录。

前置准备：登录态 Cookie 是最关键的一项，抖音大量接口只认登录用户。把 config.example.yml 复制为config.yml后运行自带的 Cookie 抓取脚本，它会弹出浏览器，你扫码登录、回终端按 Enter，Cookie 就自动写回配置文件：

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

然后把config.yml里的link换成目标作品链接，保留path与cookies区块不动，直接运行：

python run.py -c config.yml

成功长什么样：终端出现完成统计，path指定的目录（默认./Downloaded/）下出现以作者名命名的文件夹，里面是无水印 mp4；若配置里开了music、cover、json，原声、封面和元数据也会一并进作品文件夹。

高频翻车点：

• 请求大面积失败、刚装好时单条都下不动 → 多半是 Cookie 没生效或已过期，重跑一次python -m tools.cookie_fetcher --config config.yml。
• 进度和日志太安静，不知道卡在哪 → 加-v参数查看详细日志。

场景二：把博主的作品和合集一次备份

解决的问题：归档一个博主的存量内容，而不是每次手动贴单条链接。

前置准备：link填博主主页链接（douyin.com/user/...形式），mode勾选要抓的类型，number给每种模式设上限，0表示不限。测试阶段先把post设成 1～5，跑通后再放开：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - mix number: post: 5 mix: 20

python run.py -c config.yml

成功长什么样：内容按Downloaded/{作者}/post/与Downloaded/{作者}/mix/分目录归档；再跑同一份配置时，increase增量为true的已下载作品会被自动跳过，不会在硬盘上堆重复文件。注意collect/collectmix（收藏类）只能单独使用，不能与post/mix等混写在同一份mode里。

高频翻车点：

• 主页只抓到 20 条左右就停了 → 翻页触发风控，确认browser_fallback.enabled: true且headless: false，在弹出的浏览器里手动过验证；仍不行就用start_time/end_time分段抓。
• 想让某博主重下一批 → 把对应的increase.post改为false即可重下并覆盖当前筛选范围，无需清空数据库。
• 目录按作者昵称建，遇到重名博主会合并 → 重度用户把author_dir改为nickname_uid，切换只影响后续下载。

场景三：只导出数据不下载文件

解决的问题：拿到热搜榜或关键词搜索结果做二次筛选，不产生任何媒体文件。

前置准备：Cookie 有效即可，下载目录参数-p指定 JSONL 落盘位置。两条命令各跑一次：

python run.py --hot-board 30 -p ./Downloaded python run.py --search "猫咪" --search-max 100 -p ./Downloaded

成功长什么样：Downloaded/hot_board/{时间戳}.jsonl里是热搜条目，Downloaded/search/猫咪_{时间戳}.jsonl里是搜索命中的作品元数据，一行一条 JSON，jq、pandas 可直接读；挑出感兴趣的链接再丢回下载器即可。

高频翻车点：

• 搜索结果条数不够 →--search-max默认 50，按需调大。
• 导出失败而单条下载正常 → 检查 Cookie 是否过期，抓取脚本重跑一遍。

参数速查：正文出现过的旋钮都在这里

完整字段注释见 config.example.yml，全部命令行参数用python run.py --help查看。

故障排查：一张表对号入座

落地前检查清单

1. 先装依赖pip install -r requirements.txt，再用单条作品链接验证 Cookie 与网络，确认无水印 mp4 落盘后再上主页批量。
2. 测试阶段number.post设 1～5，跑通后才放开为 0；不同任务分开用config_test.yml、config_daily.yml，别共用一份。
3. 长任务开启notifications推送，跑完手机先收到结果再翻终端。
4. Cookie 失效是常态：每次大面积失败先重跑 tools/cookie_fetcher.py，再怀疑别的环节。
5. 更细的行为说明以仓库 README.zh-CN.md 为准，接口风控变化时以最新文档为准。

本项目仅供技术学习与个人数据管理使用，请在合法合规的前提下使用，尊重内容版权与创作者权益。

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