10分钟上手 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 是一款基于 Python 的抖音批量下载工具它能按用户主页批量抓取无水印视频、图文和原声音频自带增量跳过、失败重试和 SQLite 记录适合需要定期归档抖音内容的内容创作者与数据分析者。上图是该项目图形化桌面版 Douzy 的抖音下载选项界面。本文以更灵活的 Python 命令行版为主它只支持抖音但配置全部集中在一个 YAML 文件里上手成本很低。 先说清楚现状自 2026-08 起抖音风控收紧命令行版的单个视频/图文、合集、音乐、喜欢、收藏等接口目前已被限制主页作品批量下载仍可用并可开启 Playwright 浏览器兜底但不保证成功。开始之前建议先扫一遍文末的踩坑与 FAQ。从安装到首次下载的最短路径三步这一节大约 10 分钟给你装好环境并跑通第一个下载任务只需要 Python 3.9Windows、macOS、Linux 均可。第一步安装git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip3 install -r requirements.txt pip3 install playwright python -m playwright install chromium cp config.example.yml config.ymlplaywright 两行是给 Cookie 获取和浏览器兜底用的后面排障会用上。第二步登录获取 Cookiepython -m tools.cookie_fetcher --config config.yml命令会打开一个浏览器扫码登录抖音后回到终端按 EnterCookie 就写入配置文件了。这是后面所有下载的关键前提没有登录态多数接口调不通。第三步改链接并运行把config.yml里的示例link换成目标博主的主页地址在抖音网页端点分享主页复制然后python run.py -c config.yml终端会出现进度条跑完后文件落在Downloaded/目录。全部参数可执行python run.py --help查看最常用的-u追加链接、-p指定保存目录、-t并发数、-v输出详细日志。核心功能拆解按你要做的事看它能干什么读完这节你会清楚这个工具能承接哪些任务以及各自需要打开哪个开关。批量下载主页作品二次运行只拉新增配置里写入主页链接、mode: [post]即可逐页拉取作品。关键是增量下载increase.post: true默认开启会自动跳过已下载的作品——先检查磁盘上的主文件是否存在且非空文件缺失时redownload_missing_files: true默认会重新补下。也就是说你只需定期跑同一个命令就能持续归档新作品不用自己记上次存到哪了。下载目录按作者名/post/发布日期_标题_作品ID分层组织日期取作品发布时间而非下载时间文件天然按时间排好。每次任务还会生成download_manifest.jsonl清单逐条记录作品日期、作者、标签和文件路径事后核对很方便。日期与数量控制只归档某段时间的内容start_time/end_time按发布时间过滤作品格式YYYY-MM-DD包含结束日期当天number.post限制条数0表示不限。两者配合很实用比如只拉最近三个月、最多 50 条比全量下载再人工筛选更稳也省磁盘。原声、封面、元数据一个开关带出来默认只保存视频本体music、cover、avatar、json全关——全开会平白多出几倍文件和请求。需要原声时把music: true打开每个作品会附带存一份 mp3需要封面或作品原始数据 JSON 就打开对应开关。文件命名走filename_template模板文档建议模板里始终包含{id}避免重名覆盖。稳定性机制并发、限速、重试、兜底默认配置里已经内置了四层保障thread: 5并发下载、rate_limit: 2每秒请求限速、retry_times: 3失败自动重试API 翻页受限时还能自动退回 Playwright 开一个真实浏览器滚动页面采集作品并补全详情。与此同时SQLite 数据库默认dy_downloader.db记录每条作品明细和每次任务历史供事后查询。关键配置详解看懂这 5 项就够用完整模板在 config.example.yml每项都有中文注释。下面挑出最直接影响使用体验的几项link: - https://www.douyin.com/user/YOUR_SEC_UID # 目标博主主页 path: ./Downloaded/ # 保存目录 mode: [post] # post主页作品 number: post: 0 # 0不限数量 start_time: 2025-01-01 # 日期范围可选 end_time: 2025-12-31 video_quality: highest # 画质档位见下video_quality默认highest取最高转码档original会多一次探测请求超时 10 秒去找上传原片原片可能比最高转码档大数倍探测失败自动回退也可以直接写1080p、720p等固定档位匹配不到时自动降级到最接近的可用档。increaseredownload_missing_files两者共同控制要不要重下。想强制重下当前筛选范围把对应increase设为false即可不需要清空数据库。browser_fallback默认enabled: true且headless: false弹窗验证时可以在跳出的浏览器窗口里手动完成。注意无显示器的服务器上这个兜底基本失效。author_dir作者目录默认用昵称重名博主会合并重度用户建议改nickname_uid。proxy网络不稳时可填代理地址留空即直连。进阶实战批量归档某博主 2025 年作品一个高频真实场景某博主主页几百条作品你只要 2025 年发布的并且三个月后再跑时不要重复下载。在config.yml中把link指向主页并设置mode: [post] start_time: 2025-01-01 end_time: 2025-12-31 number: post: 0 # 不限数量 video_quality: 1080p thread: 5 increase: post: true # 重跑只补新增运行python run.py -c config.yml。首次跑完得到全部 2025 年作品三个月后执行同一条命令只会补下日期范围内新发布的内容。如果还想统计每条评论热度打开comments.enabled: true每个作品会多生成一份*_comments.json任务完成想收到通知配置notifications支持 bark / telegram / webhook。顺带一提命令行版还有两个轻量的取数入口python run.py --hot-board 30拉热搜榜、python run.py --search 关键词 --search-max 50搜索相关作品结果都输出为 JSONL 文件适合做选题分析的种子清单。踩坑与 FAQ3 个高频问题与排查方法Q1提示登录态失效或主页只抓到几条作品先重跑python -m tools.cookie_fetcher --config config.yml刷新 Cookie。主页作品量少时保持browser_fallback.enabled: true、headless: false在弹出的浏览器里手动完成验证。仍被拦截就是平台风控——反复换 Cookie 解决不了这正是开头的已知限制日常高频下载官方建议改用同项目的 Douzy 桌面版。Q2下载到的画质和预期不符检查video_quality。原片档位取决于作者上传质量低清源即使选original也不会变高清。加-v参数运行可以看到每条作品实际选中的档位的详细日志。Q3手动删了一些文件重跑会补吗取决于redownload_missing_filestrue默认时缺失文件会补下改成false后只要数据库还有有效记录就跳过。注意 SQLite 只记历史跳不跳过实际由磁盘文件判断。写在最后douyin-downloader 把打开主页→翻遍作品→存无水印文件→去重复查压缩成一个配置文件加一条命令最实用的价值在增量下载和日期筛选它更像一个可以定期跑的归档工具。它也没有回避风控限制把话说在前面而不是包装成万能工具。下一步建议完整配置模板config.example.yml主流程与调度CLI 入口、并发/限速/重试模块、SQLite 与文件管理Cookie 获取工具与设计文档tools/、README.zh-CN.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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考