把喜欢的内容留在本地:一个抖音视频下载工具的使用手记
【免费下载链接】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——一个开源的抖音视频下载工具,把喜欢的作品原样存进本地硬盘。从那以后,她的收藏才算真正属于自己。
它像一台"把书架搬回家"的小推车
如果非要打个比方,我觉得这个工具像一台搬运书架的小推车。抖音是那个随时可能撤展的展厅,它负责把你看中的每件作品——视频、原声音乐、封面图,连同一份作品信息说明——安稳地搬回你自己家。
它不需要你懂代码。你要做的只是把作品链接交给它,剩下的解析、找无水印源、挑最高清画质、下载、存文件,全由它完成。命令行版本适合愿意多敲几行字的用户;它还配了一版图形界面的桌面客户端(Douzy),把"粘贴链接、检测、下载"做成了几个按钮,老人小孩都能上手。
把链接粘进去,点一下检测,剩下交给它
第一次下载:这几步,把无水印视频下载到本地
万事开头难,但这条路我已经替你走通了,整个过程用不了一杯咖啡的时间。
第一步,把项目拿下来并装好依赖:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt第二步,准备一份配置文件。在抖音里复制一条作品的分享链接,粘进config.yml:
link: - https://v.douyin.com/xxxxxxx/ # 你复制的那条作品链接 path: ./Downloaded/ # 文件保存的位置第三步,告诉工具你的身份。抖音需要有效的登录凭据(Cookie)才能访问内容,工具提供了自动获取的方式:
python -m tools.cookie_fetcher --config config.yml运行后浏览器会自动打开,你扫码登录一次,Cookie 就被加密保存到本地配置里,不会上传到任何服务器。
最后运行它:
python run.py -c config.yml等进度条走完,去Downloaded文件夹看一眼——无水印的视频、原声音乐、封面图都在那里等着你 🎉。
下载时能看到每一步在做什么,心里踏实
四种身份,四种打开方式
熟悉了最基础的一条路之后,你可以按自己的需求挑一条走。
只想下几个视频的普通用户。复制短链接,粘进配置,运行,收工。不需要任何额外设置。
想备份某位博主全部作品的收藏党。把用户主页链接放进配置,再指定要作品还是喜欢列表:
link: - https://www.douyin.com/user/这里填博主的ID mode: - post # post 是主页作品,like 是点赞过的 number: post: 50 # 下载最近50个,填0则全部下载想拿评论做分析的研究者。在配置里打开评论采集开关,每个作品会额外生成一份*_comments.json,支持抓二级回复,方便做后续统计。
想录直播的人。把直播间链接放进去,工具会录制 FLV/HLS 流;主播下播时,已录制的部分依然保留,不会白等。
几个我踩过的坑,和它们的解药
作为过来人,分享几个最常见的失败情形,你可以少走这些弯路。
坑一:Cookie 过期。表现是下载时报"未登录"或 403。解药很简单——重新跑一次自动获取 Cookie 的命令。它的有效期一般是 7 到 15 天,养成每周更新一次的习惯就好。
坑二:翻页到 20 条左右就停了。这是抖音对高频请求的风控。解决方法是打开配置文件里的浏览器兜底:
browser_fallback: enabled: true headless: false遇到验证时浏览器窗口会自己弹出来,手动完成验证再放它继续跑,别急着关窗口。
坑三:批量下载中途断线。工具自带失败重试和进度记录,中断后重新运行,已完成的文件会自动跳过。要是觉得不稳,把线程数从默认的 5 调小一点通常就顺了。
让它更顺手:自动去重、完成通知,还有一点小惊喜
用得越久,你越会发现一些贴心的细节。
最让我省心的是自动去重。工具用 SQLite 数据库记录每一次下载,第二次下载同一个博主时,它会自动跳过已存在的作品,只补新增的内容。对经常更新的创作者来说,这几乎就是一台"追更机器"。
下载完成后,它还能把结果推送到你的手机——支持 Bark 和 Telegram,在配置里填上自己的设备地址即可。就算任务跑在服务器上,你也能第一时间知道结果。
给文件起好名字,以后找起来不费劲
想再挖一挖的话,它还支持关键词搜索、热搜榜抓取、REST API 接口,甚至能用语音识别把视频转成文字稿。这些玩法的详细说明都在项目文档里:README.zh-CN.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),仅供参考