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 是一个开源抖音下载器支持单条视频、图集、合集、音乐与直播回放的本地保存自带去水印、SQLite 去重、进度显示和浏览器兜底。接下来的内容会按照为什么用它 → 第一次下载 → 按目标找玩法 → 参数速查 → 避坑 → 进阶延伸的顺序展开让你用一个晚上建立起自己的本地内容库。一、先做一道选择题手动下载还是交给工具把抖音内容搬到本地通常有三条路方案单条视频批量主页直播回放去水印命名规范增量去重浏览器右键另存可以不现实不可以否混乱无在线解析网站可以多数不支持很少支持部分无无douyin-downloader支持支持支持支持模板化SQLite 记录手动下载在偶尔存一条的场景下够用但一旦涉及两位数以上的作品痛点会立刻放大文件名千奇百怪、作者混在一起、重复内容反复占用空间。工具的价值不在于替代你的判断而在于把下载、命名、归类、去重这套重复劳动打包成一条命令。项目本体放在仓库根目录下核心源码在core/目录包含下载器工厂、URL 解析、各类型下载器与重试执行器storage/负责数据库与文件管理utils/naming.py处理命名模板。想看实现细节直接从这些目录入手即可。二、四步完成第一次下载最小可行演示拿到项目的路径只有两条git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader之后pip install -r requirements.txt。装完依赖往下走四步。第一步准备登录态。抖音接口需要 Cookie手动复制粘贴既麻烦又容易漏字段。项目自带的tools/cookie_fetcher.py会拉起浏览器让你完成登录然后自动把 Cookie 写入配置python tools/cookie_fetcher.py --config config.yml第二步复制配置模板。根目录的config.example.yml是完整的参数说明建议复制一份再改cp config.example.yml config.yml第三步填入链接。打开config.yml把link下的占位链接换成你真正想保存的内容地址视频页、用户主页、直播页都支持link: - https://www.douyin.com/video/7412345678901234567 path: ./Downloaded/ mode: - post第四步运行。一条命令开始下载python run.py -c config.yml第一次跑通后你会看到类似下面的结果——进度、耗时、成功与失败数量一目了然下载完成后内容按作者与类型自动分好文件夹每一条作品还附带 JSON 元数据作者、发布时间、标题等方便日后检索三、按目标找玩法你要的是哪一种结果工具的功能很多与其逐个记忆不如从我想得到什么出发反过来找对应的配置。想完整备份一位创作者的主页这是最常用的场景。抖音的创作主页一般包含四种内容发布的作品、点赞过的内容、合集、音乐原声。在配置里把这些模式全开并指定每类的数量上限link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like - mix - music number: post: 50 like: 20 mix: 10 music: 20配合increase增量开关和database: true第二次运行只会补齐新增作品不会把整个主页重新拉一遍。author_dir支持nickname、sec_uid、nickname_uid三种作者目录命名方式重度用户建议选nickname_uid既直观又不会因作者改名而分裂目录。想留住一场直播直播是抖音最难保存的内容类型——播完基本就没了。把直播间的链接放进link开启live配置段即可live: max_duration_seconds: 0 # 0 一直录到主播下播 idle_timeout_seconds: 30max_duration_seconds设为 0 表示录到主播下播也可指定具体秒数只录一段时间。录制时会先探测直播流地址与清晰度选项主播中途下播也会保留已录数据想收集某位博主的背景音乐把链接指向用户主页mode里带上musicnumber里给出music的条数原声作品会被单独归入音乐目录适合给视频剪辑攒素材库。想分析评论区反馈打开comments开关每个作品会额外生成一份*_comments.json包含评论正文、作者等信息comments: enabled: true include_replies: false max_comments: 0 # 0 不限制数量 page_size: 20这层数据对做内容运营或用户调研的人比较有用普通用户保持关闭即可。四、参数速查表常用配置项一览不需要背收藏本文用到时回来查配置项作用常用取值link待下载链接列表支持视频/主页/直播间/短链数组形式mode/number下载模式与各模式数量上限post / like / mix / musicthread并发线程数影响下载速度5 ~ 10retry_times单条失败重试次数3increase各模式的增量下载开关true / falsedatabaseSQLite 去重与历史记录truefilename_template文件命名模板必须包含{id}{date}_{title}_{id}folder_template作品子目录命名{date}_{title}_{id}start_time/end_time只下载时间范围内的作品2024-01-01proxyHTTP 代理网络受限时使用http://127.0.0.1:7890browser_fallback接口被限时用浏览器兜底抓取enabled: true一个容易忽略的细节filename_template里至少要保留{id}否则标题相同例如两期节目同名会互相覆盖。五、三条锦上添花的扩展命令除了常规下载CLI 还内置了几个独立子命令适合特定场景。拉热搜榜。导出抖音当前热搜前 30 条到本地 JSONL 文件做选题或追热点时有用python run.py --hot-board 30关键词搜索。按关键词搜索作品并导出结果想摸底某个话题的内容量时可以试试python run.py --search 猫咪 --search-max 100REST API 服务。装好可选依赖后可以把下载器变成 HTTP 服务供其他系统调用pip install fastapi uvicorn python run.py --serve --serve-port 8000批量下载过程中终端会实时显示每个作品的进度条与耗时长任务挂着看也不慌六、避坑指南几个新手容易踩的坑一次只能拿到 20 条作品这是抖音接口的翻页限制不是 bug。确保browser_fallback.enabled: true程序会在接口受限时切换到浏览器模式继续抓取如果弹出验证码手动完成一次即可。Cookie 失效、下载报登录错误重新跑一遍python tools/cookie_fetcher.py --config config.yml工具会重开浏览器让你登录完事后自动更新配置。下载内容重复打开increase增量开关并保持database: trueSQLite 会记录已下载作品的 ID重复内容直接跳过。想要的通知没收到notifications支持 bark、telegram、webhook 三类渠道配置好 provider 后成功与失败都会推送摘要。七、如果命令行让你头疼试试桌面版命令行工具适合自动化与批量操作但如果你更习惯图形界面项目还配套了一款桌面版应用 Douzy它复用同一套后端界面上的核心入口是下载、批量下载、任务中心与作品档案四个模块。粘贴链接即可开始任务状态、今日成功/失败数量都有可视化展示关注列表同步、文件命名规则设置、下载历史档案也都做了可视化处理对不熟悉终端操作的用户友好很多。命令行与桌面版共用底层逻辑切换成本很低。八、写在最后从一条视频开始回到开头那个问题。工具能解决的是内容还在的时候把它留下来这件事。它不能替你决定存什么、删什么但可以保证你想留的一定能留成结构清晰、命名规范、可随时翻阅的本地文件。建议的入门路径很简单先存一条视频跑通流程再试着备份一位创作者的主页然后按需开启增量、评论或直播录制。完整参数说明可以随时回看根目录的config.example.yml与USAGE.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），仅供参考