douyin-downloader 快速上手：从单条视频到批量归档的抖音无水印下载

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 是一款开源的抖音批量下载工具，核心能力是抖音无水印下载：覆盖单条视频与图文、创作者主页批量归档、直播实时录制、评论与热搜数据采集，也可以作为 REST API 服务运行。它解决的是手动录屏带水印、批量收集整理效率低这两类实际问题。

🎯 能力总览：六项核心功能速查

功能	适用场景	上手难度
无水印视频下载	保存单条视频、图文，自动挑选最高画质	低
创作者作品批量归档	主页作品、点赞、合集批量收集	低
直播实时录制	直播存为 FLV，断流自动保留	低
评论采集	作品评论与二级回复导出为 JSON	低
热搜榜与关键词搜索	话题监测、内容研究	低
REST API 服务	自动化提交下载任务	中

所有能力都通过一份config.yml驱动，命令行参数可以临时覆盖配置项。下文按首次上手和三个高频场景展开。

首次上手：三步完成抖音无水印下载

第一步：安装 douyin-downloader 与 Python 依赖

环境要求 Python 3.8 及以上，两条命令完成：

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

如需要浏览器兜底或自动获取 Cookie，再执行pip install playwright和python -m playwright install chromium安装浏览器内核。

第二步：一键获取 Cookie

抖音接口需要登录态，手工拷贝 Cookie 容易出错。项目提供基于浏览器的自动获取工具，实现在 tools/cookie_fetcher.py：

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

命令运行后浏览器会打开抖音登录页，扫码登录完成回到终端按 Enter，Cookie 即自动写入config.yml，后续运行直接可用。

第三步：下载第一条无水印视频

先执行cp config.example.yml config.yml生成基础配置，再用命令行直接传入视频链接与保存目录，单条视频无需改动配置文件：

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

运行结束后，Downloaded/目录中生成无水印 mp4、封面图与 JSON 元数据。桌面版 Douzy 提供同样的入口，粘贴链接即可点击下载：

📦 三个高频用法：归档、直播录制与数据采集

批量归档创作者作品：批量下载怎么配置

目标：完整保存某位创作者的全部作品。操作：配置中填入主页链接并开启post模式，number.post: 0表示不限量，increase.post: true开启增量模式：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post

产出：文件按Downloaded/作者名/post/日期_标题_aweme_id/组织，每条作品包含无水印 mp4、封面、音乐与元数据 JSON，storage/database.py 用数据库加本地文件双重检查跳过重复内容。桌面版关注管理页还支持同步全部关注创作者并筛选新作品：

抖音直播录制：直播抓取如何设置

目标：把直播内容完整保存下来回看。操作：配置中填入直播间链接，live.max_duration_seconds: 0表示一直录到主播下播：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0

产出：FLV 文件存入Downloaded/作者名/live/，附带*_room.json房间元数据快照；主播下播、网络空闲或按 Ctrl+C 时，已录制的字节都会保留，不会丢前半场。

评论与热搜数据采集：结构化数据怎么导出

目标：拿到作品评论或热点话题快照用于分析。操作：配置开启comments.enabled: true，下载时自动在媒体文件旁生成{aweme_id}_comments.json，include_replies: true会附带二级回复，max_comments可限量。热搜与关键词搜索无需配置文件：python run.py --hot-board 30 -p ./Downloaded会在Downloaded/hot_board/生成带时间戳的 JSONL 快照，--search "关键词" --search-max 100把搜索结果导出到Downloaded/search/。产出：JSON/JSONL 可直接用 pandas 读取统计。

进阶：服务化与自动化调优

douyin-downloader 可作为常驻 REST API 服务运行，实现见 server/app.py：先安装fastapi uvicorn，再执行python run.py --serve --serve-port 8000，外部系统通过 POST/api/v1/download提交下载任务、凭 job_id 查询进度，方便接入定时采集流水线。任务结束后可通过 Bark / Telegram / Webhook 推送通知，单个渠道失败不阻塞下载主流程。速度上调整thread（建议 4–16，按带宽取舍）；归档上folderstyle: true按作品建子目录；日常增量跑批时按模式开启increase，避免重复下载已有内容。

🛠 避坑指南：三个常见故障的修复

• 现象：批量下载只拿到约 20 条作品。原因：抖音翻页风控，接口提前停止返回。解决：browser_fallback.enabled: true且headless: false，在浏览器弹窗中手动完成验证。
• 现象：原本正常的作品突然解析失败。原因：Cookie 过期。解决：重新执行python -m tools.cookie_fetcher --config config.yml。
• 现象：想重新下载却被跳过。原因：程序按数据库记录加本地文件双重检查，只删数据库不触发重下。解决：同时删除本地作品文件与dy_downloader.db中对应记录。

douyin-downloader 从单条视频的抖音无水印下载、创作者作品归档，到抖音直播录制与数据采集，整条链路靠配置文件即可启用。详细配置项见 README.zh-CN.md，项目结构见 PROJECT_SUMMARY.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