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.8macOS / Linux / Windows 均可登录前置需要一次抖音扫码获取 Cookie约一周至两周有效过期需重扫可选依赖浏览器兜底与自动取 Cookie 需pip install playwright并装 chromium成本开源免费MIT License转写功能需自备 OpenAI Key按量计费合规边界仅用于个人数据管理与技术研究勿侵犯他人版权与隐私详见 README.zh-CN.md 免责声明 按你的使用场景选路场景痛点工具的解法配置核心详见单条内容保存带水印、画质缩水链接即下自动选无水印最高码率源基于video.bit_rate挑选link 可选video_quality: original最短闭环作者主页批量上百条作品手工保存不现实主页链接 mode: [post, like, mix, music]数量与时间范围可约束mode/number/start_time场景手册 1自己的收藏夹换设备后收藏对不上登录态下mode: [collect, collectmix]整体搬运仅支持当前 Cookie 账号须单独使用场景手册 1 备注挂机录制直播看完就没了live.douyin.com/{room_id}录 FLV/HLS下播保留已录数据live.max_duration_seconds场景手册 2自动化接入手动盯进度繁琐REST API 提交任务、完成推送通知、下载后转写--serve/notifications/transcript升级路径短链https://v.douyin.com/...会自动解析不用手动展开。最短闭环5 步拿到第一个无水印视频第 1 步获取代码并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt✅ 成功标志终端无报错依赖安装完毕。 网络慢时加-i https://pypi.tuna.tsinghua.edu.cn/simple换国内镜像。第 2 步复制配置文件cp config.example.yml config.yml✅ 成功标志目录下多出一个config.yml。第 3 步扫码获取 Cookiepython -m tools.cookie_fetcher --config config.yml浏览器弹出后扫码登录回到终端按回车凭证自动写入配置。✅ 成功标志config.yml的cookies段落被填充。第 4 步写一条最小配置link: - 你的视频或主页链接 path: ./Downloaded/其余保持模板默认即可默认thread: 5、retry_times: 3、database: true、video: true附带产物如封面/音乐/JSON 默认关闭按需打开。第 5 步运行python run.py -c config.yml✅ 成功标志Rich 进度条走到 100%Downloaded/作者名/post/日期_标题_aweme_id/目录出现无水印 mp4。分场景手册场景手册 1如何把整个作者主页批量搬回家最小配置片段link: - 创作者主页链接 mode: - post # 可选 like / mix / music number: post: 50 # 0 表示全量 start_time: 2024-06-01 end_time: 2024-06-30效果多模式可混写同一个 aweme_id 跨模式自动去重时间范围只搬区间内发布的作品。⚠️ 坑位提醒翻页停在几十个作品不动是风控限制。开启browser_fallback.enabled: trueheadless: false弹窗出现后手动完成验证再等它跑完别急着关窗口。另注意collect/collectmix收藏夹模式必须单独使用不能和post等混用。场景手册 2增量下载 直播录制增量去重已下载的作品 ID 落进 SQLite再跑同一作者自动跳过旧内容。database: true increase: post: true效果第二次运行时只拉新增作品。⚠️ 坑位提醒重下某条作品要同时删本地文件文件名含 aweme_id和数据库记录只删文件不删库、或只删库不删文件行为都和你预期不同。直播录制实验性link: - live.douyin.com/房间号 live: max_duration_seconds: 3600 # 0 录到主播下播效果FLV 直接可播下播、断网或 CtrlC 时已录字节全部保留保存在Downloaded/作者/live/并附*_room.json元数据。⚠️ 坑位提醒HLS 源只保存 playlist 文件需 ffmpeg 后处理webcast 接口未覆盖所有场景官方标注 experimental。桌面端补充同一套后端另有内测中的桌面客户端Douzy粘贴链接即可开始任务中心集中查看状态、重试失败项详见 README.zh-CN.md。任务中心每个下载任务的状态、数量与结果集中记录失败项可直接重试排错速查问反复提示登录失效或请求被拒Cookie 过期所致有效期约一周到两周。对策重跑python -m tools.cookie_fetcher --config config.yml扫码一次即可。问主页翻页停在几十个作品不再增加分页被风控限制。对策确认browser_fallback.enabled: true且headless: false弹窗手动过验证后等待跑完默认等待超时 600 秒。问任务中断后已下载的文件作废吗不会。SQLite 本地文件双重去重内置完整性校验Content-Length 比对不完整文件自动清理重试再次运行只补缺失部分。问批量任务跑得慢默认并发thread: 5、速率限制 2 请求/秒、重试退避 1s/2s/5s。对策降并发thread: 3单次任务控制在 50100 条磁盘留足余量progress.quiet_logs: true可减少进度刷屏。问开了转写却没有 transcript 文件依次检查transcript.enabled是否为true、下载的是否为视频图文不转写、OPENAI_API_KEY是否有效。升级路径按难度递进的三步加完成通知5 分钟在config.yml开启推送任务跑完手机即知notifications: enabled: true providers: - type: bark url: 你的推送地址支持 bark / telegram / webhook企业微信等 bot 地址单个推送失败不阻塞下载。接进自动化REST API 服务半天装可选依赖后以服务化运行pip install fastapi uvicorn python run.py --serve --serve-port 8000POST /api/v1/download提交 URL 拿job_idGET /api/v1/jobs/{job_id}查状态server.max_jobs默认 500与server.job_ttl_seconds默认 24h可调。内容生产链路按需用--hot-board 30导出热搜榜 JSONL、--search 关键词 --search-max 100导出搜索结果、comments.enabled: true逐作品采评论include_replies: true多拉二级回复请求量更大、transcript.enabled: true给每个视频附文字稿——做内容调研与检索时按需组合。跑通一条链接只是开始先用number和start_time/end_time约束一次小规模批量确认目录结构符合预期再打开增量模式长期维护你的本地档案。【免费下载链接】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），仅供参考