三步跑通抖音批量下载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 去重和浏览器兜底。你只需贴一个主页链接作品列表就能整个搬进本地文件夹。三步跑通首次下载第一步装环境工具只依赖 Python 3.9Windows / macOS / Linux 均可加一个 Chromium全部走 pipgit 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建议先用虚拟环境隔离依赖。装完 Chromium 是为了 Cookie 登录和浏览器兜底功能不是可选项。第二步登录拿到 Cookie把示例配置复制成本地配置再用内置的登录工具完成一次扫码cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml浏览器弹出后按正常方式登录回终端按 EnterCookie 就写进配置文件了。Windows PowerShell 下把复制命令换成Copy-Item config.example.yml config.yml即可。第三步跑通第一条命令编辑config.yml把link换成目标博主主页地址然后执行python run.py -c config.yml几个常用参数参数用途-c, --config指定配置文件默认config.yml-u, --url追加链接不替换配置里的可重复使用-p, --path覆盖保存目录-t, --thread覆盖并发线程数-v, --verbose打开详细日志进度条、每条的耗时、最终的成功/失败/跳过统计都在终端实时显示跑完还有总体汇总。同一套下载后端也有 Douzy 桌面版见 README.zh-CN.md支持抖音、TikTok、YouTube、Telegram、X日常点击式下载可以优先考虑它本文聚焦命令行版。功能拆解贴短链也行链接类型怎么识别麻烦抖音分享出来的链接五花八门——短链、主页、合集、直播手工分类容易出错。原理URLParser把输入自动归为 7 类单条视频、图集、博主主页、合集、音乐、直播、直播回放见 core/url_parser.pyv.douyin.com这类短链会先还原成完整 URL 再匹配 ID。用法把 APP 里复制的原始短链直接丢进link列表不需要任何前处理。下过就不重下增量去重靠 SQLite麻烦重复跑同一个主页几百个视频又下了一遍。原理默认开启database: true下载历史写进dy_downloader.db默认路径increase控制各模式行为——post: true跳过已下载作品改成false则强制重下并原子覆盖当前筛选范围内的文件无需手动清库。用法默认配置下直接反复运行即可number.post控制下载条数0表示不限。快不快和稳不稳分开调并发与限流麻烦线程开多了容易触发风控开少了又慢。原理队列里每个任务要过一层速率限制器请求默认 2 次/秒下载失败按retry_times自动重试见 control/。用法-t 3压低线程、rate_limit放宽到 5 左右两者一起调比单拉线程数更稳。只下某段时间的作品日期筛选start_time/end_time按YYYY-MM-DD圈定范围结束日当天包含在内。按时间段收集素材时这一项配合number上限很实用。调优进阶参数怎么设更稳完整配置见 config.example.yml以下是最常动的一档参数作用建议值thread并发下载线程数默认5网络一般先降到 3retry_times单任务失败重试次数默认3保持即可rate_limit每秒最大请求数默认2频繁风控就再压到 1video_quality视频画质默认highest最高转码档original尝试原片、失败自动回退number.post主页作品下载上限0不限首次建议设小值试跑start_time/end_time日期范围筛选按素材时间窗填写含结束日当天path保存目录默认./Downloaded/redownload_missing_files磁盘文件缺失时是否补下默认true保持即可proxy出站代理默认空需要时填http://host:port避坑排错高频问题逐个说清现象常见原因处理方式跑着跑着报登录失效Cookie 过期重跑python -m tools.cookie_fetcher --config config.yml重新登录单条视频 / 合集链接提示被风控抖音接口风控与 Cookie 无关反复重试无效主页作品可保留browser_fallback.enabled: true走浏览器兜底并在弹窗中手动完成验证仍不行就换 Douzy 桌面版详见 README.zh-CN.md 的命令行版现状提示文件缺失上次下载未完成或文件被移动redownload_missing_files默认true会自动补下设false则依赖数据库记录跳过想看下载细节控制台默认静默日志progress.quiet_logs: true加-v看 INFO 级日志或--show-warnings看警告写在最后适合三类人要整页搬走博主作品的创作者、按时间段收集素材的讲师、想给自己建本地视频档案的普通用户——一次配置重复运行只补增量。先拿一个账号小批量试跑确认目录结构和画质符合预期再放开number上限。想继续深挖配置细节直接翻 config.example.yml每个字段都有注释。【免费下载链接】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），仅供参考