十分钟跑通抖音无水印批量下载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-downloaderdouyin-downloader 是一个基于 Python 的抖音批量下载工具支持视频、图文、合集与音乐原声的无水印下载内置 SQLite 去重、失败重试和浏览器兜底。同一套后端还有桌面客户端Douzy提供链接队列、任务中心和作品档案的图形化管理。这篇指南带你走完从安装到第一个无水印文件落盘的最短路径并讲清楚去重与增量规则让这个库能长期低维护地积累。安装到首次下载十分钟出片依赖安装与环境要求先克隆仓库并把依赖装好整个过程只有两条命令git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt环境要求 Python 3.8Windows、macOS、Linux 都支持。如果计划用浏览器兜底或自动抓 Cookie再补装pip install playwright python -m playwright install chromium。Cookie 一次配到位把示例配置复制出来cp config.example.yml config.yml然后运行内置抓取工具python -m tools.cookie_fetcher --config config.yml它会自动拉起浏览器引导你登录抖音完成后回到终端按 EnterCookie 就直接写回配置文件。手里已有有效 Cookie 的话手动编辑cookies字段也行。所有认证信息只存在本地。首次下载直接跑python run.py -c config.yml命令行可临时覆盖配置-u追加链接、-t并发数、-p输出目录。想以 REST API 方式提交任务加--serve需另装 fastapi 与 uvicorn。链接类型与模式怎么选单条链接自动识别类型/video/、/note/、/mix/、/music/路径以及v.douyin.com短链都能直接解析不需要手动指定类型。音乐链接会优先下载原声文件拿不到时回退到该音乐下的首条作品。按内容源给作者主页挑模式用户主页按mode区分内容来源post拉作者发布的作品like拉公开点赞mix拉合集music拉用过的原声。collect与collectmix只对应当前登录账号的收藏夹和收藏合集必须单独使用不能与其余模式混写。几个关键参数建议用表格记忆参数作用说明number抓取数量0表示全量start_time/end_time发布区间过滤格式YYYY-MM-DDvideo_quality画质档位默认highest取码率最高档original会额外探测上传原片仅在比最高转码档大时才下载跨模式去重是自动的同一个aweme_id同时出现在 post 和 mix 里只下载一次。目录结构与命名规则设计author_dir 与文件名模板怎么选默认输出到./Downloaded/。folderstyle: true时每个作品独立一个子目录group_by_mode默认true会在作者目录下再分post/like/mix一层。author_dir决定作者目录的命名依据取值优点代价nickname直观重名作者会合并改昵称会分裂成两个目录sec_uid稳定不直观nickname_uid兼有两者优点无默认取值就是nickname_uid。filename_template默认{date}_{title}_{id}{id}参与命名可以避免标题重复导致的重名覆盖。注意切换author_dir只影响之后的下载不会迁移已有目录。封面、原声与数据文件默认是关的⚠️ 容易踩的一点默认只保存视频本体music、cover、avatar、json全部默认关闭想要就显式打开author_dir: nickname_uid folderstyle: true filename_template: {date}_{title}_{id} cover: true music: true json: true配置好之后落盘结构长这样Downloaded/ └── 作者名/post/ └── 2024-02-07_作品标题_aweme_id/ ├── 作品.mp4 ├── 作品_cover.jpg └── 作品_data.json增量更新与双重去重判定看懂数据库 文件名双重检查database: true时程序维护一个 SQLite 文件默认dy_downloader.db。去重靠数据库记录 本地文件名中的 aweme_id双保险任一处命中就跳过。各模式的增量开关是increase.post/like/mix/music默认开启日常定时任务只拉新增内容。查下载历史直接查库即可sqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;强制重下某条作品的两步操作必须同时清掉文件和记录缺一不可rm -rf Downloaded/作者名/post/*_aweme_id/ sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;判定是不对称的只删数据库记录、本地文件还在不会触发重下文件名扫描仍会命中只删文件、记录还在配合默认的redownload_missing_files: true才会触发重下。桌面端的任务中心也提供按任务重试失败项的入口。兜底、重试与完成后的触达翻页被风控时靠浏览器兜底翻页受限时browser_fallback默认enabled: true会启动浏览器继续抓取headless: false时弹出可见窗口出现验证码手动完成后再关max_scrolls和idle_rounds分别控制滚动上限与空闲判定。失败重试默认retry_times: 3按 1s、2s、5s 指数退避rate_limit默认 2 请求/秒下载后做 Content-Length 完整性比对不完整的文件自动清理并重试。网络受限场景配置proxy即可API 请求和媒体下载走同一出口。完成通知与语音转写按需开启批量任务跑完后的触达由notifications负责providers 支持 bark、telegram、webhook 三类多路并发推送单路失败不影响下载主流程。评论采集用comments.enabled: true开启include_replies决定是否拉二级回复max_comments为 0 表示不限量结果落在*_comments.json。语音转写只对视频作品生效图文不生成开启transcript.enabled后默认先用 ffmpeg 本地抽出单声道 mp3 再上传规避 25MiB 单文件上限密钥建议走环境变量OPENAI_API_KEY输出.transcript.txt和.transcript.json两个文件状态记录在数据库的transcript_job表。高频问题速查只抓到 20 条作品或 Cookie 失效只抓到 20 条是翻页风控的典型表现确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证、别急着关窗翻页才会继续。Cookie 失效则重跑python -m tools.cookie_fetcher --config config.yml登录完成后自动写回配置无需手工复制字段。有条作品被重新下载了是为什么双重去重下数据库有记录但磁盘文件缺失且redownload_missing_files为true就判定为需要补下。反过来只删库记录不删文件不会重下所以强制重下必须文件和记录一起清。更多实现细节可参考 docs/ 下的设计文档。这套工具适合个人学习、研究与数据备份场景去重、增量与兜底机制让每次重跑只处理差量配合定时任务和完成通知内容库可以低维护地持续更新。使用时请尊重创作者的劳动成果与平台规则合规使用。【免费下载链接】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），仅供参考