企业官网建设流程全解析

3步跑通：用 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（抖音下载器）是一款无水印抖音批量下载工具，支持视频、图文、合集、音乐和作者主页的整页归档。多数人卡住的不是单条保存，而是想把某位创作者的全部作品完整、无水印地落到本地，官方应用并没有这样的入口。本文覆盖从安装、获取 Cookie 到首次成功下载的完整路径，含批量下载配置和常见排错，预计阅读 6 分钟。

项目速览

• 许可证：MIT（见 LICENSE）
• 运行环境：Python 3.8+，支持 macOS / Linux / Windows
• 核心依赖：aiohttp（HTTP 请求）、rich（进度条）、aiosqlite（SQLite 去重）、pyyaml（配置解析），见 requirements.txt
• 内容类型：单条视频/图文/合集/音乐、主页批量下载、直播录制、评论采集
• 工程状态：tests/ 目录含 70 余个自动化测试文件，提供 Dockerfile 部署方案

本文聚焦使用层：安装、Cookie 获取、常用配置项与工作流；不讲解源码架构，也不展开 Docker 部署细节与内测中的桌面客户端开发。

⚡ 从零到跑通（快速上手）

1. 克隆仓库并安装依赖

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

验证：python run.py --version能输出版本号，即环境就绪。

2. 复制配置并获取 Cookie

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

验证：在弹出的浏览器窗口登录抖音后回到终端按 Enter，config.yml 的 cookies 字段被写入真实值。

3. 填入链接并运行

python run.py -c config.yml

验证：终端出现进度条，Downloaded/下生成作者名/post/日期_标题_作品ID/目录，内含 mp4 文件。

除命令行外，项目基于同一套后端提供了桌面客户端 Douzy（内测中），粘贴抖音链接即可识别类型并开始下载：

🧩 核心能力拆解

两点细节：浏览器兜底（browser_fallback）目前仅对 post 模式完整验证；收藏夹模式collect/collectmix只支持 Cookie 已登录的账号，且必须单独使用，不能与其他模式混用。

桌面客户端任务中心，按任务展示完成/失败数量，可打开目录或重试失败项。

📁 一个完整的典型工作流

场景：下载某位创作者的全部作品并归档。先在浏览器地址栏复制该创作者主页链接，按下面写入 config.yml（number.post: 0表示不限条数，抓取全部作品）：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 0 thread: 5

运行python run.py -c config.yml。终端先列出待下载作品，随后显示进度条：5 线程并发下载，默认限速 2 请求/秒；若翻页受限，会自动打开浏览器等你人工完成验证码。

结束后打开Downloaded/作者名/post/确认：每个作品是一个独立文件夹，命名格式为日期_标题_作品ID，内含无水印 mp4；开启json: true还会保存作品元数据。下次重跑同一命令，increase增量模式只会补下新发布的作品。

适用人群与边界

适合

• 短视频研究者 / 内容分析人员：需要按创作者或主题建数据集，元数据 JSON（可选评论）可直接分析
• 系列课程学习者：合集能整集保存，直播回放可录制，配合时间筛选只取所需区间
• 个人存档用户：自己账号的作品与收藏夹可以整体备份（collect模式）

不适合 / 需注意

• 不适用于商业批量爬取和二次分发，项目免责声明限定用途为个人学习、研究
• Cookie 有有效期，失效后需重新运行cookie_fetcher获取；直播录制标注为 experimental，HLS 源需 ffmpeg 后处理才能得到可播放文件

🔧 常见问题与排错

只能拉到约 20 条作品就停了：这是翻页风控的典型行为。确认browser_fallback.enabled: true且headless: false，在浏览器弹窗中人工完成验证码，不要过早关闭，程序会接着抓取。

提示需要登录 / Cookie 失效：重新运行python -m tools.cookie_fetcher --config config.yml，扫码登录后按 Enter 即自动写回配置，不建议手工拼写 cookies 各字段。

个别作品下载失败怎么办：默认按 1s、2s、5s 指数退避重试，次数由retry_times控制（默认 3 次）；下载完整性校验会自动清理不完整文件并重下。仍失败时优先检查网络或proxy配置。

版权与合规：下载内容仅限个人学习、研究使用，请勿用于商业用途，不要侵犯他人隐私与版权。工具只负责下载，使用行为的风险由使用者自行承担。

douyin-downloader 是一款面向无水印抖音批量下载的实用工具：给一个链接，换一套可增量续传的归档目录。克隆仓库后先运行python run.py --version确认环境，再用一条视频链接跑通流程，最后切换到整页主页下载。

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