10 分钟跑通 douyin-downloader：抖音无水印视频与主页批量下载实操指南

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收藏夹里存了几百条抖音视频博主删号、接口一换就全找不回了。录屏糊还带水印在线解析站广告多、Cookie 外泄没保障。douyin-downloader 是一个开源抖音下载工具直接走抖音接口拿无水印源支持视频、图文、合集、原声批量下载还能增量追更、录直播、采评论跑通后基本不用再手动操作。 项目速览它到底能干什么douyin-downloader 是一个面向实用场景的命令行抖音下载器给想批量留存作品的个人用户和做内容调研的运营同学用。核心逻辑一句话不靠网页模拟点击而是直接调用抖音接口拿无水印源把解析、下载、去重、重试全部自动化。选它的理由有三个无水印优先且自动挑最高码率基于video.bit_rate数组、SQLite 数据库加本地文件双重去重、翻页受限时可切浏览器兜底。能力总览如下能力支持内容关键配置 / 参数单条下载/video、/note、/collection、/music链接短链自动解析link列表主页批量备份作品 / 点赞 / 合集 / 音乐四种模式modenumber收藏夹备份当前登录账号的收藏与收藏合集mode: [collect]须单独使用增量追更只下载上次之后的新作品increasedatabase: true直播录制FLV下播保留已录数据live.douyin.com/{room_id}评论采集每个作品旁生成*_comments.jsoncomments块热搜 / 搜索导出结果落 JSONL--hot-board/--search完成通知Bark / Telegram / Webhooknotifications块REST API 服务提交 URL 异步排队下载--serve --serve-port 8000默认并发 5、重试 3 次1s/2s/5s 指数退避、速率限制 2 请求/秒这些参数在config.example.yml里都有默认值不改也能跑。 选型依据和录屏、在线解析站比差在哪不吹更强大直接按四个维度摆事实对比维度录屏在线解析站douyin-downloader上手成本零零装一次依赖Cookie 有自动获取脚本数据归属带水印、画质压缩一次一条取决于站点随时可能挂本地按作者 → 模式 → 日期_标题归档含封面、音乐、元数据 JSON隐私与稳定低链接和登录态流向第三方站点Cookie 留在本地配置请求直连扩展性无无重试、去重、直播、评论、热搜、通知、REST API结论很直接单条图方便用录屏没问题但只要想整个主页搬回家或长期追更只有本地工具这条路线能走通。 从零跑通3 步到第一次下载成功第 1 步装环境和依赖Python 3.8macOS / Linux / Windows 都行git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt作用拉源码、装全部依赖通常一两分钟。后面要用到浏览器兜底和 Cookie 自动获取再补两条pip install playwright python -m playwright install chromium第 2 步自动获取 Cookie唯一的硬门槛cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml换句话说复制一份配置模板然后脚本弹出浏览器你正常登录一次抖音回终端按回车Cookie 就被写进config.yml不用手抄 msToken、ttwid 这些字段。这个脚本在tools/cookie_fetcher.py失效后重跑同一行即可。第 3 步填一个链接跑第一次下载编辑config.yml把link换成任意一条视频link: - https://www.douyin.com/video/7604129988555574538然后执行python run.py -c config.yml这一步会解析链接类型、派发给对应下载器终端用 Rich 进度条实时展示完成品落在Downloaded/里按作者名 → post → 日期_标题_aweme_id三层归档默认附带封面、音乐、头像和元数据 JSON。截图里跳过已存在[视频]/[音乐]/[封面]/[头像]就是双重去重在生效——第二次跑同一个链接什么都不会重下。 功能深潜五个能力域逐个过如何整站备份作者主页的全部作品把link从视频链接换成主页链接number.post设 0 表示不限量link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0真实跑起来的效果终端先输出已获取全部作品274 个再逐条批量下载视频、图集通吃。文件最终归位成这种结构找起来一目了然Downloaded/作者名/post/2024-02-07_作品标题_aweme_id/ ├── xxx.mp4 ├── xxx_cover.jpg ├── xxx_music.mp3 └── xxx_data.json增量追更怎么开第二次运行只下新作品全量备份过一次之后想持续跟进博主更新只需两个开关increase: post: true database: true作用借助dy_downloader.db里的历史记录比对只下载上次之后的新作品。注意两点——database: true必须保留增量依赖数据库增量目前支持post/like/mix/music四种模式收藏夹模式不支持增量截断。点赞、收藏、合集、原声把你喜欢的本地化四条入口都写在config.example.yml里点赞作品mode: [like]number.like: 0即全量当前账号收藏夹link填https://www.douyin.com/user/self?showTabfavorite_collectionmode: [collect]收藏合集mode: [collectmix]原声音乐/music/{music_id}链接优先下原声文件缺失时回退到该音乐下的首条作品合集则是/collection/{mix_id}或/mix/{mix_id}两条硬规则必须记住collect/collectmix只能单独使用不能和post/like/mix/music混排且只支持当前 Cookie 对应的登录账号。想同时下作品和收藏分两次跑。抖音直播录制怎么配下播自动收工link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 录到主播下播这一步会解析直播间、录制 FLV保存在Downloaded/{作者}/live/下并附带*_room.json元数据快照。主播下播、断流或你手动 CtrlC已录制的字节都会保留.tmp 文件自动提升为正式文件不会白录。项目把 webcast 直播接口标注为 experimental属于实验性能力覆盖不了所有场景。评论采集与热搜导出顺手当数据雷达用comments: enabled: true include_replies: false # true 会多拉二级回复请求量更大 max_comments: 500python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded前者给每个已下载作品旁边生成{date}_{title}_{aweme_id}_comments.json后两条命令分别抓取热搜前 30 条和关键词搜索结果落在Downloaded/hot_board/与Downloaded/search/的 JSONL 文件里任何文本工具或脚本都能接着分析。 组合工作流全量备份 → 增量同步 → 完成通知单看每个功能都不复杂串起来才是这套工具最顺手的地方。一条完整链路首次全量number.post: 0跑完博主主页274 个作品几分钟内落盘封面、音乐、元数据齐全。切换增量把increase.post改成true之后每周跑一次同样的命令只补新作品终端里看到的基本全是跳过已存在。加通知追加一段配置批量任务跑完直接推到手机不用守在终端notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEYBark、Telegram、Webhook企业微信/飞书/钉钉的 bot URL 同样能用可混配所有 provider 并发推送单个失败不阻塞下载主流程。想再往服务化走一步pip install fastapi uvicorn后执行python run.py --serve --serve-port 8000提交{url: ...}即可异步排队下载实现见server/目录。不想碰终端的话仓库还带了基于同一套后端的桌面客户端 Douzy当前处于内测期粘贴链接开始下载、同步关注列表、任务中心逐条跟踪进度都在图形界面里完成。 排错手册6 个高频问题一行一个解法现象主页批量只抓到 20 条就停了原因API 翻页触发风控。 解法确认browser_fallback.enabled: true且headless: false弹窗出现后手动过一下验证码别急着关窗口。注意浏览器兜底目前主要对post模式完整生效。现象跑到一半提示登录态失效Cookie 突然不好使原因抖音 Cookie 有时效属正常现象。 解法重跑python -m tools.cookie_fetcher --config config.yml别手抄。现象明明删了文件重下时还是被跳过原因去重是数据库记录 本地文件双重判定只删一侧不算数。 解法删掉本地同名文件夹后再执行sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;。现象进度条疯狂刷屏终端看不清输出原因进度阶段日志太啰嗦。 解法progress.quiet_logs: true配置模板默认已开调试时再临时加--show-warnings或-v。现象开了转写却没有 transcript 文件原因四种可能——没启用、下的是图文不转写、密钥无效、格式没选对。 解法核对transcript.enabled: true、确认是视频、OPENAI_API_KEY有效、response_formats含txt或json四项全过就有输出。现象收藏夹模式collect直接报错原因collect/collectmix必须单独使用且仅限当前登录账号。 解法收藏和作品分成两次运行link都指向showTabfavorite_collection主页。 速查表douyin-downloader 抖音下载功能一表全收功能命令 / 配置一句话说明单视频下载link: 视频链接自动无水印、自动挑最高码率主页全量备份mode: [post]number.post: 0不限量图集视频通吃增量追更increase.post: truedatabase: true只下上次之后的新作品点赞 / 收藏mode: [like]/[collect]collect 必须单独使用合集 / 原声/collection/、/music/链接整包拉取原声缺失自动回退直播录制live.douyin.com/{room_id}live块下播保留已录数据评论采集comments.enabled: true每作品一份独立 JSON热搜 / 搜索--hot-board 30/--search 关键词导出 JSONLCookie 刷新python -m tools.cookie_fetcher --config config.yml弹浏览器登录一次即可服务化python run.py --serve --serve-port 8000REST API 异步排队下载接下来分三步推进今天复制config.example.yml、跑一遍 Cookie 脚本用一个视频链接完成首次下载本周挑一个常追的博主跑全量备份再切增量模式加个定时任务之后把通知接上手机顺手试试评论采集和热搜导出用出问题了也欢迎回仓库提 Issue。最后提醒一句项目声明仅用于技术研究、学习交流与个人数据管理请尊重创作者版权别把下载来的内容二次分发。核心关键词douyin-downloader 抖音无水印视频批量下载工具 长尾关键词抖音主页作品全量备份、抖音增量追更下载、抖音直播间 FLV 录制、抖音收藏夹批量下载、抖音评论采集 JSONL、Cookie 自动获取脚本【免费下载链接】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），仅供参考