douyin-downloader:10分钟跑通抖音无水印批量下载的完整指南
发布时间:2026/9/16 21:48:33 作者:尧图编辑部 阅读量:1,286

douyin-downloader10分钟跑通抖音无水印批量下载的完整指南【免费下载链接】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 是一个命令行抖音批量下载工具粘贴链接就能拿到无水印视频也支持视频、图文、合集、音乐和作者主页的批量下载默认带进度展示、失败重试、SQLite 去重和浏览器兜底。桌面版 Douzy 的链接下载页粘贴链接、识别类型、一键开始下载它是什么一句话一个 Python 写的抖音下载器核心是把链接变成你磁盘上的无水印文件和结构化元数据。 单条视频、图文note、合集、音乐原声的去水印下载 作者主页批量下载作品、点赞、合集、音乐四种模式 每个作品附_data.json元数据可选下载历史记录在 SQLite 里 可跑成 REST API 服务也能接 Bark / Telegram / Webhook 完成通知它不做什么没有官方网页控制台主交互方式是命令行 YAML 配置桌面客户端 Douzy 目前还在内测。collect/collectmix收藏夹模式只对你登录 Cookie 对应的账号生效且必须单独使用不能和post/like/mix/music混用。快速上手如何安装 douyin-downloader 并跑通第一条下载环境要求 Python 3.8macOS / Linux / Windows 均可。克隆仓库后pip install -r requirements.txt # 安装核心依赖 pip install playwright # 可选浏览器兜底与 Cookie 自动获取 python -m playwright install chromium然后复制仓库自带的 config.example.yml 为config.yml填一个最小可用配置link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 要下载的链接 path: ./Downloaded/ # 下载目录 mode: - post # post/like/mix/music收藏夹模式为 collect/collectmix thread: 5 number: post: 1 # 该模式下最多下几条0 不限 cookies: ttwid: 填你的TTWID # 跑 Cookie 获取工具后会自动写入获取 Cookie 有两条路推荐自动方式python -m tools.cookie_fetcher --config config.yml浏览器里登录抖音后回到终端按 EnterCookie 自动写回配置文件也可以手动从浏览器开发者工具复制 Cookie 字符串粘贴进去。最后一条命令python run.py -c config.yml下载完成时文件按Downloaded/作者名/模式/日期_标题_ID/落盘dy_downloader.db是默认数据库位置。每个作品默认只保存视频本体封面、音乐、头像、JSON 在配置里按需打开。核心功能从单条下载到家页批量存档单条链接下载如何下载一个视频或图文link里放/video/{aweme_id}、/note/{note_id}、/gallery/{note_id}、/collection/{mix_id}、/music/{music_id}都可以https://v.douyin.com/...这类短链也能自动解析。不想改配置文件时直接用命令行参数追加python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538 -t 8 -p ./Downloaded-u追加链接可重复-t调并发-p指定目录。这是最常用的入口手上有一个链接一条命令拿走。批量下载作者主页mode 与 number 怎么配链接换成https://www.douyin.com/user/{sec_uid}把mode设为post、like、mix、music的任意组合number字段按模式分别限数0 表示全量。同一个作品在多个模式里重复出现时跨模式自动去重只下一次。什么时候用你想长期存档一个博主或者做竞品内容分析时。增量更新increase 字段与每日定时存档increase默认对post/like/mix/music全部为true工具只跳过主媒体文件已存在且非空的作品重跑同一配置就是增量下载。什么时候用配合 crontab 做每日更新。注意它的判断依据是磁盘文件删掉本地文件重跑会自动补齐反过来只删数据库不删文件不会触发重下这是 README 里专门强调过的坑。浏览器兜底翻页被风控拦下时怎么继续API 翻页被平台风控拦下时典型现象是只抓到约 20 条工具会按browser_fallback配置启动浏览器模拟滚动加载max_scrolls: 240、idle_rounds: 8、wait_timeout_seconds: 600是默认值。headless: false时会弹出浏览器窗口你在窗口里手动完成验证它会自动继续。浏览器兜底目前只对post模式做过完整验证like/mix/music仍主要依赖 API 正常分页。其余能力一句话带过还能下载封面、音乐原声、头像和_data.json元数据comments字段可采集作品评论含可选二级回复为*_comments.jsonlive.douyin.com/{room_id}链接触发直播录制主播下播或 CtrlC 时已录数据保留为 FLV--hot-board 30和--search 关键词可把热搜榜和搜索结果导出为 JSONLtranscript字段可调用 OpenAI 转写 API 为视频生成文本图文不生成转写。进阶用法画质、时间过滤与 API 服务画质video_quality支持original探测上传原片失败退回最高转码档、highest默认只从码率阶梯里挑最高档、lowest以及1440p/1080p/720p等指定分辨率匹配不到时自动降级到最接近的档。时间过滤start_time/end_time用YYYY-MM-DD格式过滤作品发布时间做定向样本采集时用。完成通知notifications.providers支持 bark / telegram / webhook企业微信、飞书、钉钉的 bot 地址同样可用多个渠道并行推送某个渠道失败不会阻塞下载流程。REST API 服务装好fastapiuvicorn后运行python run.py --serve --serve-port 8000默认监听127.0.0.1:8000。POST /api/v1/download提交{url: ...}得到 job_idGET /api/v1/jobs/{job_id}查进度完成态任务保留 24 小时、内存里最多留 500 条。常见问题只抓到 20 条左右的作品→ 这是抖音翻页风控的典型表现。确认browser_fallback.enabled: true、browser_fallback.headless: false浏览器弹窗出现后手动完成验证别急着关窗口。Cookie 失效、请求开始报错→ 重跑python -m tools.cookie_fetcher --config config.yml重新登录后 Cookie 会自动写回config.yml。删了数据库却不会重新下载→ 去重判断是数据库记录 本地文件双重检查只删数据库保留文件时文件存在就不会重下只删文件保留数据库时工具会把库里记录但本地缺失当作需要重试会重新下载。想让某条作品重新下载本地文件和数据库记录要一起清。进度输出刷屏、日志重复→ 默认progress.quiet_logs: true会压制进度阶段的日志调试时临时加--show-warnings或-v看完整日志。转写文件没生成→ 按顺序检查transcript.enabled是否为true、下载的是否为视频图文不生成转写、OPENAI_API_KEY或transcript.api_key是否有效、response_formats里是否包含txt或json。桌面版任务中心每条任务显示状态、成功/失败数可重试失败项并打开输出目录使用边界项目采用 MIT 协议源码和再分发需保留许可声明。README 的 Disclaimer 写明仅用于技术研究、学习和个人数据管理不得侵犯他人隐私、版权或其他合法权益不得用于非法用途使用产生的风险和法律责任由使用者自行承担。平台接口或政策变动导致功能失效属于正常技术风险不算 bug。工具内置了速率限制默认 2 请求/秒、指数退避重试1s、2s、5s和默认 5 并发请保持这些默认值不要为了快去高频全量抓取更不要商业性再分发下载内容。接下来可以做的事复制config.example.yml为config.yml跑python -m tools.cookie_fetcher --config config.yml写入 Cookie。先用单条视频链接跑一次python run.py -c config.yml确认文件和目录结构符合预期。把link换成某个作者主页配好mode/number/increase跑一次批量下载。需要评论和时间过滤时再打开comments与start_time/end_time字段。卡住时先对照上面常见问题配置字段含义查 README.md配置模板看 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),仅供参考