企业官网建设流程全解析

如何安装并跑通抖音批量下载工具 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 是一个面向抖音内容的去水印下载命令行工具，支持视频、图文、合集、音乐、收藏夹五类链接，内置 SQLite 去重、失败重试与浏览器兜底。本文带你从零把环境搭好、跑通第一条下载，并快速了解常用配置。

一、能帮你做什么

• 批量下载作者主页的全部作品，不必逐条复制链接
• 单个视频、图文、合集、音乐下载，v.douyin.com 短链自动解析
• 下载记录写入本地 SQLite 数据库，二次运行自动跳过已下内容
• 实时进度条、指数退避重试、请求限流，避免把请求打爆
• 可选采集评论、语音转写、完成通知推送

二、安装与启动步骤

需要 Python 3.8 及以上，Windows、macOS、Linux 均可运行。

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

然后获取抖音登录 Cookie。这一步需要额外的浏览器内核：

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

运行后会弹出浏览器窗口，在里面完成抖音登录，回到终端按 Enter，认证信息会自动写入配置文件。各字段含义可对照 config.example.yml 中的注释，更多说明见 README.zh-CN.md。

三、跑通第一次下载：单条内容到主页全量

先用单条作品验证环境，无需改配置，直接用-u传入链接：

python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538"

文件会落到path指定的目录（默认./Downloaded/），进度条实时显示下载状态。

单条跑通后，再切换到主页批量：把config.yml里的link改成作者主页地址（douyin.com/user/xxx形式），mode设为[post]，number.post设为想取的数量（0表示不限），然后执行python run.py -c config.yml。

两点提醒：

• 2026 年起抖音对 CLI 的接口风控持续收紧，个别类型可能抓不到。遇到时保持browser_fallback开启，或改用基于同一后端的桌面版 Douzy（README 中有说明）。
• 主页翻页受限时，浏览器兜底会接管抓取，见下节。

四、常用配置速览

路径与命名

• path：下载根目录，默认./Downloaded/
• author_dir：作者目录名取nickname（默认）、sec_uid或nickname_uid（昵称_ID，重名不混淆）
• folderstyle：按作品建独立子目录，默认开启
• filename_template：默认{date}_{title}_{id}，模板中必须含{id}防覆盖

数量与范围

• number.post、number.mix等：各模式下载条数，0为不限
• start_time/end_time：按发布日期过滤，格式YYYY-MM-DD
• thread默认 5（并发数），retry_times默认 3（重试次数）
• video_quality：可选original、highest（默认）、lowest或 1080p 等指定分辨率

增量与去重

• database：默认true，生成dy_downloader.db记录下载历史
• increase.post：默认true，再次运行只补新作品
• 想重新下载某作品，需同时删除本地文件和数据库记录（双重去重）

通知提醒

• notifications.enabled：true后下载完成推送消息
• providers支持 bark、telegram、webhook 三类，企业微信、飞书、钉钉的 bot 地址也可直接用于 webhook

五、值得了解的进阶能力

浏览器兜底browser_fallback.enabled默认为true。主页作品 API 翻页受限时自动切换到真实浏览器读取页面自己发出的列表请求；headless: false（默认）会弹出可见窗口，出现验证码时可人工完成，max_scrolls、wait_timeout_seconds控制滚动与超时上限。

语音转写设置transcript.enabled: true后，视频下载完成会调用 OpenAI Transcriptions API，在视频旁生成.transcript.txt与.transcript.json。密钥建议通过环境变量OPENAI_API_KEY提供；仅对视频生效，图文不转写。

评论采集设置comments.enabled: true，每个作品额外生成*_comments.json；include_replies可多拉二级回复（请求量增加），max_comments限制每作品条数，0为不限。

六、遇到问题怎么办

• 主页只能抓到 20 条就停：翻页风控的典型现象。确认browser_fallback.enabled: true且headless: false，浏览器弹出后手动完成验证，不要立即关闭窗口。
• Cookie 失效、请求无权限：重新执行python -m tools.cookie_fetcher --config config.yml登录并写入即可。
• 进度条刷屏：保持progress.quiet_logs: true（默认）；需要看细节时加--show-warnings或-v参数运行。
• 想重新下载某作品：删除文件名带该作品 ID 的本地目录，并用sqlite3从dy_downloader.db删除对应aweme_id记录，两者都清才会触发重下。

这套工具适合内容创作者建素材库、需要采集作品数据的研究者，以及想定期备份自己主页收藏的用户。使用时请仅用于个人学习、研究与备份，尊重内容创作者的权益，不要将下载内容用于商业传播。

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