企业官网建设流程全解析

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 去重，提供命令行与桌面两种入口。

能力边界：它能做什么，不能做什么

• 支持：无水印下载视频/图文作品，可附带封面、音乐、头像与原始 JSON
• 支持：用户主页发布作品批量下载（post 模式），翻页受限时走浏览器兜底
• 支持：like / mix / music / collect 四种扩展模式
• 支持：评论采集、热搜榜与关键词搜索（输出 JSONL）
• 支持：直播录制（实验功能，HLS 源仅保存播放列表，不是可直接播放的视频）
• 限制：命令行版仅支持抖音，TikTok、YouTube 等平台只在 Douzy 桌面版提供
• 限制：2026-08 起抖音风控（Argus）已拦截单视频、合集、音乐、点赞、收藏等接口；主页作品可尝试 Playwright 浏览器兜底，但不保证成功

下载内容仅建议用于个人学习与数据管理，请遵守平台条款与版权规定。

环境准备与首次运行（三步走）

克隆仓库：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader

安装依赖（需 Python 3.9+，Windows/macOS/Linux 均支持）：

python -m pip install -r requirements.txt

配置 Cookie。抖音接口需要登录态，仓库自带浏览器自动抓取脚本：

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

注意：弹出浏览器完成抖音登录后回到终端按 Enter 保存 Cookie；若自动抓取失败，从浏览器开发者工具复制 Cookie 字符串粘入配置文件即可。

配置即工作流：读懂 YAML 里的关键参数

日常任务基本由一份 YAML 决定行为，最常用字段如下：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxx path: ./Downloaded/ mode: [post] number: post: 10 start_time: "2024-01-01" end_time: "2024-12-31" thread: 5 video_quality: highest increase: post: true

完整字段与默认值可对照仓库内 配置默认值 查阅。

两种入口，两种节奏

早期版本是 DouYinCommand.py（单条）与 downloader.py（批量）两个脚本，现在统一为run.py，两种节奏靠参数区分。

单条链接、临时补一条，用-u现追加，不动配置文件：

python run.py -u "https://v.douyin.com/xxxx"

批量抓主页、按日期/数量筛选，走配置文件驱动，-v输出详细日志，-t、-p可临时覆盖线程数与目录：

python run.py -c config.yml -v

桌面客户端：给不想碰终端的人

Douzy 桌面版的流程就是三句话：粘贴链接、点击检测链接确认内容类型、开始下载。

除抖音外，Douzy 还支持 TikTok、YouTube、Telegram、X 的公开内容批量下载，部分批量与高级功能需要激活：

• 关注列表同步：直接从抖音账号拉取关注博主，勾选后要采集的主页
• 任务中心：逐任务查看进度、统计与失败日志，失败任务可单独重试
• 作品档案：本地 SQLite 记录下载历史，可按作者、标题、时间筛选与去重

进阶玩法：直播录制、评论抓取与热搜搜索

直播录制：把link指向https://live.douyin.com/{room_id}后按常规命令运行即可，由直播间链接自动触发。live.max_duration_seconds: 0表示录到主播下播，idle_timeout_seconds用于断流超时退出。

评论采集：在配置中打开开关后，每个作品额外生成*_comments.json，含评论内容、用户、点赞数与回复关系：

comments: enabled: true max_comments: 0

热搜榜与关键词搜索是独立子命令，结果直接落盘为 JSONL，便于后续分析：

python run.py --hot-board 30 python run.py --search "美食教程" --search-max 50

落盘规则与元数据

默认目录结构按「作者/模式/发布时间_标题_作品ID」组织：

Downloaded/ ├── download_manifest.jsonl └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 2024-02-07_作品标题_aweme_id.mp4 ├── 2024-02-07_作品标题_aweme_id_cover.jpg └── 2024-02-07_作品标题_aweme_id_data.json

目录日期取作品发布时间create_time（缺失时回退当前日期并告警）。除单作品的_data.json外，根目录的download_manifest.jsonl是 append-only 的总清单，每行一条 JSON，常用字段：

• aweme_id：作品唯一 ID，去重与增量判断的依据
• author_name/desc：作者昵称与作品描述
• date（发布时间）：与目录命名保持同一时间基准
• tags：从text_extra、cha_list与描述中的#聚合，方便按话题检索

核心下载与落盘逻辑集中在 core/，排查命名与跳过行为时可从这里入手。SQLite 库（默认dy_downloader.db）只记录作品明细与任务历史，不参与增量判断。

踩坑速查

仓库地址 gitcode.com/GitHub_Trending/do/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