抖音批量下载去水印完全指南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 去重命令行和桌面端两种形态。这篇文章按能下什么 → 怎么四步跑通 → 速度/稳定性/去重三个关键问题 → 可选旋钮 → 排障清单的顺序展开全部基于仓库文档实测整理。先把地图画出来它能接住哪些内容一句话结论抖音生态内的内容基本都能接但 CLI 和桌面版的覆盖范围不一样先分清再用。按对象分三组看单个链接/video/{id}、/note/{id}视频和图文v.douyin.com短链会先自动解析再下载批量入口用户主页/user/{sec_uid}可拉全部作品mode支持 post发布、like点赞、mix合集、music原声四种模式桌面版 Douzy除抖音外还支持 TikTok、YouTube、Telegram、X 五个平台覆盖主页、合集、频道、播放列表等。有一条边界要说清楚根据 README.zh-CN.md 的说明2026 年 8 月起抖音接口风控陆续覆盖了单个视频、合集、音乐、喜欢/收藏接口CLI 直连这些场景可能失败主页作品有 Playwright 浏览器兜底但不保证成功所以 README 建议日常下载优先用 Douzy。直播录制属于实验功能HLS 源只保存播放列表。想清楚自己要下哪一类后面的配置才不会白写。最短路径从零跑通第一个真实任务全程只需四步前提是有Python 3.9Windows、macOS、Linux 都支持。第 1 步装环境克隆仓库后装依赖Playwright 是浏览器兜底用的建议一起装git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt pip install playwright python -m playwright install chromium第 2 步配 Cookie。抖音接口需要登录态仓库提供了自动获取脚本会拉起浏览器让你登录cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml在弹出的浏览器里登录抖音回终端按 Enter 保存即可。第 3 步填配置。打开 config.example.yml 复制出来的config.yml最小可跑通的样子link: - https://www.douyin.com/user/YOUR_SEC_UID path: ./Downloaded/ mode: [post] number: post: 10 increase: post: truenumber.post: 10表示先下 10 条试试水填 0 就是不限数量。第 4 步运行python run.py -c config.yml不想盯终端的话同项目自带 Douzy 桌面版Windows/macOS粘贴链接直接提交任务命令行和桌面版共用同一套下载后端。跑通第一次之后日常就是改配置 敲一条命令。跑起来之后最值得问的三个问题速度从哪来默认thread: 5五路并发下载配合rate_limit: 2每秒请求限速防风控慢的时候用-t参数或配置项把线程数往上调即可画质默认highest最高转码档选original会先探测原片、失败自动回退。翻车了怎么办三层保险API 优先失败时 Playwright 浏览器兜底默认开启、非无头模式max_scrolls默认 240 轮翻页失败重试按1 秒、2 秒、5 秒的节奏退避retry_times默认3 次见 control/retry_handler.py单条失败直接跳过继续跑最后汇总未成功清单不会让一条死链拖垮整批。重复跑会不会重复下载不会。增量下载默认increase.post: true先检查磁盘上的非空主文件再配合database: true的 SQLite 库dy_downloader.db和追加式清单download_manifest.jsonl字段结构见 PROJECT_SUMMARY.md二次运行只补新内容文件被误删时默认redownload_missing_files: true会自动补下。三个机制叠起来就是白天挂机、早上看结果的底气。可选旋钮把体验推到更顺手按需开启即可每个都对应config.yml里的一个字段。命名与归档filename_template/folder_template默认{date}_{title}_{id}日期取作品发布时间模板带上{id}就不怕重名覆盖author_dir作者目录按昵称、sec_uid或昵称_uid三种方式命名重名作者合并还是隔离由你定。时间与数量筛选start_time/end_timeYYYY-MM-DD格式圈定日期范围含结束当天number.post限制下载条数0 不限。任务级开关video/music/cover/json分别控制是否顺带下配乐、封面、原始 JSON 元数据默认只存视频本体comments评论采集可含楼中楼max_comments为 0 不限。直播与通知livemax_duration_seconds填 0 录到主播下播空闲超时默认 30 秒防假死notifications支持bark / telegram / webhook三种推送成功失败都可触发。进阶入口--hot-board 30拉热搜榜、--search 关键词搜视频、--serve起一个 REST API 服务都写在 README 的更多命令里。旋钮不用全开先跑通主流程哪一步不顺再拧哪一个。动手前的排障清单现象最可能原因一句话解法提示 Cookie 失效 / 需要登录登录态过期重跑python -m tools.cookie_fetcher --config config.yml主页只拉到少量作品接口风控限制翻页保持browser_fallback.enabled: true在可见浏览器里手动过验证单条视频一直失败原视频被删或设为私密工具会自动跳过并继续结尾汇总失败清单即可文件重名或互相覆盖命名模板缺唯一字段模板里带上{id}默认{date}_{title}_{id}已包含同一批内容被重复下载增量开关被关了确认increase.post: true且database: true下载速度慢并发低或网络拥塞thread从默认 5 提到 8–10必要时配置proxy排查不通就加-v参数看详细日志大部分问题日志里能直接定位。收尾把整条路径串一遍装环境Python 3.9 加依赖→ 配认证cookie_fetcher 自动取 Cookie→ 填链接config.yml里写好link和path→ 跑任务python run.py -c config.yml→ 调细节命名模板、增量、时间筛选、通知按需开。走到这一步找素材、存素材、整理素材整条链路就自动化了每份文件都带发布日期和作品 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考