5 分钟上手 douyin-downloader：抖音无水印下载从单条到主页批量的完整指南

5 分钟上手 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 是一款免费的命令行抖音无水印下载工具粘贴视频或主页链接即可批量保存无水印视频、图文、合集与原声音乐并自带 SQLite 下载历史和去重能力 。它适合两类人——想整页备份某位作者作品的个人用户以及需要把抖音数据纳入自己脚本的开发者。下面按先跑通、再展开的顺序带你走完第一遍。如何跑通第一次下载安装、配置与认证环境要求与完整安装流程需要 Python 3.9 及以上版本支持 Windows、macOS 和 Linux。执行下面四行完成拉源码、进目录、装依赖、装浏览器兜底组件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前两句是获取代码和依赖第三句playwright用于浏览器兜底——当接口翻页被风控限制时工具会自动启动浏览器继续加载这是后面排错会反复用到的开关。如何复制配置文件cp config.example.yml config.yml把仓库自带的模板 config.example.yml 复制为config.yml。之后所有修改都只动config.yml模板保持原样升级或对照文档时不会被自己改过的文件干扰。如何获取 Cookie登录通行证python -m tools.cookie_fetcher --config config.ymlCookie 是抖音在浏览器中发放的登录凭证相当于一张有时效的通行证没有它接口拒绝返回需要登录态的数据放久了还会过期。上面这条命令会弹出浏览器你在浏览器里登录一次抖音回到终端按回车Cookie 就自动写入了本地配置全程不用手动复制任何字符串。填入链接并运行第一条下载打开config.yml把link字段换成你的目标链接number.post设为 1 表示先只下 1 条验证流程link: - https://www.douyin.com/video/7604129988555574538 number: post: 1只保留最小可用字段是为了先确认链接→解析→落盘这条主链路能走通出问题也更容易定位。然后运行python run.py -c config.yml终端会实时显示解析与下载进度成品默认落在path指定的./Downloaded/目录文件名带作品发布时间前缀方便日后核对。它还能干什么批量、增量、直播与数据导出无水印原片提取接口返回多档码率video_quality: highest时自动挑选最高转码档改为original会额外探测上传原片更大则下载原片失败自动回退。典型用法单条视频链接直接进link。主页批量备份mode: [post]number.post: 0表示不限条数作者全部作品连同封面、音乐、元数据 JSON 一起落盘目录按作者 → 日期_标题归档仓库还附带 Douzy 图形界面批量任务可视化配置如右图。增量追更database: true开启后下载历史写入本地 SQLitedy_downloader.db配合increase.post: true二次运行只处理新增内容。典型用法每天跑一次同一份配置。直播录制link填live.douyin.com/{房间号}live.max_duration_seconds: 0表示录到主播下播。典型用法挂机录整场直播断流时已录部分保留。评论采集与热搜导出comments.enabled: true后每个作品额外生成*_comments.json--hot-board与--search子命令直接把热搜榜和关键词搜索结果存成 JSONL。典型用法为作品做舆情分析。和常见替代方案横向对比一下维度手机录屏在线解析网站douyin-downloader画质带水印与控制台痕迹依赖站点解析参差不齐无水印多档码率可选批量能力逐条操作多数限单条主页/合集整包、日期范围筛选隐私低高Cookie 交给第三方站点低Cookie 只存在本地自动化无弱命令行参数化可接 REST API高频场景实操最小配置与预期产物抖音主页备份的最小配置整页抓取作者作品link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [post] number: post: 0number.post: 0表示不限条数。预期产物Downloaded/作者昵称/下按发布时间归档的无水印视频、图文另附download_manifest.jsonl清单文件记录每条作品的标题、标签和落盘路径。⚠️ 易踩的坑作者改名后新下载会生成新的作者目录旧目录不迁移在意长期归档的用户可把author_dir设为nickname_uid用昵称_sec_uid保证目录稳定唯一。抖音增量追更的最小配置只下上次之后的新作品increase: post: true database: true预期产物只有新增内容被下载已存在的跳过。⚠️ 易踩的坑需要强制重下时不要清数据库把increase.post改为false即可覆盖当前筛选范围内的文件——增量跳过判断的依据是磁盘上的主媒体文件改这个开关就够了。抖音直播录制的完整流程链接与时长配置link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0预期产物断流或下播时任务自动收尾已录分片保留。⚠️ 易踩的坑直播录制在 README 中标注为实验功能HLS 源只保存播放列表不是开箱即播的成品视频重要场次建议同时用本地方式留一手。热搜与搜索导出的命令不下载、只收数据python run.py --hot-board 30 python run.py --search 猫咪 --search-max 100预期产物JSONL 文件每行一条记录可用任意文本工具或 pandas 继续分析。⚠️ 易踩的坑--search-max默认 50不显式传参会只拿到前 50 条别以为结果不全。常见卡点表现、定位与修复动作主页翻几页就提前停只拿到二三十条→ 接口分页触发了抖音风控。保持browser_fallback.enabled: true与headless: false重跑后受限时会自动弹出浏览器滚动加载出现验证码手动完成即可。报登录态失效或大量作品解析失败→ Cookie 过期时效到了。重跑python -m tools.cookie_fetcher --config config.yml刷新一次无需手抄字段。删掉了本地视频再运行仍显示已存在→ 跳过逻辑同时看磁盘文件和数据库记录两边状态不一致。把increase.post改为false强制覆盖或把对应本地目录清干净再跑。mode里同时写post和collect报错→ 收藏数据只能来自当前登录账号本身且不能与作品模式混跑。分两次运行一次下作品一次单独跑收藏。下载一半断了要重头来吗 / 进度刷屏太吵 / 转写文件没生成→ 合并到这里一次说清断网中断的文件有完整性校验损坏的自动清理并按重试次数默认 3 次重试不用重头下刷屏保持progress.quiet_logs: true、运行时不加-v即可转写缺失则依次核对transcript.enabled是否为 true、对象是否为视频图文不转写、OPENAI_API_KEY是否有效。进阶入口API 服务、通知与数据导出REST API 服务化pip install fastapi uvicorn后运行python run.py --serve --serve-port 8000POST 一条 URL 返回job_id轮询状态实现见 server/app.py。完成通知notifications.enabled: true并配置providers支持 Bark、Telegram 和通用 webhook字段示例就在 config.example.yml 里。视频转写transcript.enabled: true时视频先抽音轨再上传转录产出 txt/json入口在 core/transcript_manager.py。二次开发核心模块在 core/配置加载在 config/跑测试与代码检查用python -m pytest tests/和ruff check .设计文档在 docs/。三步行动路线第一次下载照先跑通一节装依赖、复制模板、刷新 Cookie用一条视频链接验证链路。第一个批量任务换成目标作者主页链接number.post: 0全量备份确认Downloaded/归档结构符合预期。日常追更与扩展打开increase每日增量运行再按需挑直播录制、评论采集或 REST API 中的一个场景接入自己的工作流。最后提醒一句下载的内容建议仅用于个人学习、研究与数据备份请尊重创作者版权与平台规则商业用途前务必确认授权。核心关键词抖音无水印下载长尾关键词抖音批量下载、抖音主页备份、抖音直播录制、抖音评论采集【免费下载链接】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），仅供参考