企业官网建设流程全解析

douyin-downloader 实战指南：5 步搭建抖音无水印批量下载工作流

【免费下载链接】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 的抖音批量下载工具，适合整理个人收藏的普通用户、收集素材的内容创作者，以及需要分析内容的研究人员。它支持 post、like、mix、music、collect 五种下载模式，可保存无水印视频与图文，并配有 Douzy 桌面版提供图形化操作。

安装命令行版并准备环境

需要 Python 3.9 及以上版本，支持 Windows、macOS 和 Linux。获取代码后安装依赖，以及兜底机制用到的浏览器：

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

前两条命令克隆仓库，后三条安装 Python 依赖和 Playwright 使用的 Chromium 浏览器，Cookie 获取与主页兜底下载都依赖它。

两步完成 Cookie 认证

认证使用抖音 Cookie，仓库内置了获取工具。复制一份配置模板后运行获取命令：

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

按提示在弹出的浏览器窗口登录抖音，回到终端按 Enter 保存 Cookie，信息全部存在本地。Cookie 失效时重新执行同一条命令即可，获取工具源码见 tools/cookie_fetcher.py。

五种下载模式与关键配置

在 config.yml 中填写目标链接和下载行为。mode 决定内容类型，五个取值分别对应：post 博主作品、like 博主点赞内容、mix 合集、music 音乐原声、collect 收藏夹；number 按模式限制条数，0 表示不限；start_time 与 end_time 用 YYYY-MM-DD 格式按日期过滤；video_quality 控制清晰度，默认 highest。

link: - https://www.douyin.com/user/YOUR_SEC_UID path: ./Downloaded/ mode: [post] number: post: 10 increase: post: true

这段示例把某博主主页的 10 条作品下载到 ./Downloaded/，increase.post 为 true 表示增量下载、跳过已下载的作品。完整配置项与中文注释在 config.example.yml 里都有，Douzy 桌面版把这套选项做成了可视化界面：

运行任务与文件组织

配置保存后运行任务：

python run.py -c config.yml

追加 -v 输出详细日志，-u 可临时追加配置外的链接，-t 调整并发数。文件默认按作者目录归档，每个作品再建独立文件夹（folderstyle 控制），文件名由 filename_template 模板生成，默认 {date}{title}{id}，包含作品 ID 避免重名。想把作者目录改成 nickname_sec_uid 格式、防止同名账号合并，改 author_dir 字段即可。

增量下载与数据库去重

默认启用本地 SQLite 数据库 dy_downloader.db，记录所有已下载作品，再次遇到相同作品会自动跳过，避免重复文件与重复请求。增量下载前会先检查磁盘上的非空主媒体文件：文件缺失且 redownload_missing_files 为 true（默认）时会重新下载补齐；设为 false 时，只要数据库里有有效记录就继续跳过。

需要整批重下时，把对应模式的 increase 设为 false 即可，不用清空数据库。下载历史还可以直接写 SQL 查询，按作者统计条数、按时间分布做汇总，数据库模块源码在 storage/。

进阶选项：评论、转写与通知

三类可选功能按需开启。comments 为每个作品采集评论并保存成评论 JSON 文件；transcript 调用转写接口为语音生成 txt/json 文本，本地先抽取音频再上传，需要配置 OPENAI_API_KEY；notifications 支持 Bark、Telegram、Webhook 三种渠道，在成功或失败时推送消息。此外还有直播间录制（live.douyin.com 链接触发）和 --serve 启动的 REST API 模式。偏好图形化操作的人可以选 Douzy 桌面版，它与 CLI 共享同一套 Python 后端，除抖音外还覆盖 TikTok、YouTube 等平台：

常见问题与解决思路

• Cookie 失效或请求异常：重新运行 Cookie 获取命令更新认证。
• 主页只获取到少量作品：保持 browser_fallback.enabled: true 与 headless: false，在浏览器窗口里手动完成滑块验证。
• CLI 风控提示：抖音接口目前会拦截 CLI 对单个作品、喜欢、合集、音乐等内容的下载，主页作品只能尝试浏览器兜底且不保证成功；以单条下载为主的日常使用建议改用 Douzy 桌面版。
• 下载慢或不稳定：调低 thread 并发数，或配置 proxy 代理。

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