从单条视频到整页备份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 值得花五分钟了解一下。这是一款免费开源的抖音下载工具支持视频、图集、合集、音乐和直播回放的批量保存内置去重、增量、重试、浏览器兜底等细节功能把收藏这件事真正交给工具去完成。下面这份指南会从第一次运行讲到进阶玩法全程零基础可跟。一张表看懂它能把哪些内容搬回家先确认一件事这个工具到底能存什么下面的清单基本覆盖了日常会遇到的绝大多数情况。内容类型链接形态说明单个视频/video/{id}无水印优先自动挑选最高清源图集图文/note/、/gallery/图片与文字一并保存合集/collection/、/mix/整个系列一次拿下音乐原声/music/{id}优先保存原声文件作者主页/user/{sec_uid}作品/点赞/合集/音乐四种模式批量下载直播录制live.douyin.com/{room_id}FLV/HLS 双协议录制短链v.douyin.com/...自动解析无需手动还原也就是说从随手刷到的一条视频到追更数月的主页全量作品再到错过就后悔的直播现场它都能接住。第一次运行从零到第一条视频落盘第一步拉取代码并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt这段命令做的事很简单把项目源码下载到本地再装齐它运行时需要的第三方库。装完后不用急着写任何代码配置文件才是你唯一需要打交道的东西。第二步生成配置并填入目标链接cp config.example.yml config.yml复制出来的config.yml就是你的下载任务单。最少只需改动三处link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - postlink填你想下载的链接path决定文件保存到哪个目录mode在链接是作者主页时生效post表示下载主页发布的全部作品。第三步用自动脚本搞定最麻烦的 Cookie很多抖音接口需要登录态而手动复制 Cookie 既容易出错又容易过期。项目提供了一个自动获取脚本python -m tools.cookie_fetcher --config config.yml它会自动打开浏览器让你完成抖音登录登录后回到终端按一下回车Cookie 就自动写进配置了全程不需要手动粘贴任何字符串。第四步发起你的第一次下载python run.py -c config.yml如果不想改配置也可以直接用命令行追加链接单条视频、作者主页、直播间各有各的写法python run.py -c config.yml -u https://www.douyin.com/video/1234567890123456789 python run.py -c config.yml -u https://www.douyin.com/user/MS4wLjABAAAAxxxx python run.py -c config.yml -u https://live.douyin.com/123456789运行后终端会显示实时进度正在下载哪些视频、封面和头像已跳过哪些已存在文件最终统计成功数量与耗时。第一次下载成功你就完成了从手动收藏到自动化存档的转变。把整页作品搬回家批量下载的正确姿势批量下载作者主页是这个工具最常用的场景。核心是两个开关mode决定下什么number决定下多少。link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./我的抖音存档/ mode: - post # 主页发布的作品 - like # 作者点赞过的作品 - mix # 作者创建的合集 - music # 作者用过的音乐 number: post: 50 # 作品最多下 50 条 like: 0 # 0 表示不限制数量下载完成后工具会自动按作者 → 模式 → 单条作品组织目录每条作品单独一个文件夹视频、封面、原声、元数据 JSON 分门别类放好我的抖音存档/ └── 作者昵称/ ├── post/ │ └── 2024-02-07_作品标题_aweme_id/ │ ├── 视频.mp4 │ ├── 封面.jpg │ ├── 原声.mp3 │ └── 元数据.json ├── like/ ├── mix/ └── live/这样的结构配合 SQLite 数据库的去重记录就衍生出了另一个贴心功能——增量下载。开启increase.post: true和database: true后第二次运行同一任务时程序会自动比对已下载过的作品 ID只拉取新发布的内容不再重复劳动也不会浪费磁盘空间。顺带一提你还可以按自己的习惯定制一切thread: 5调整并发数、start_time/end_time按发布时间筛选、filename_template: {date}_{title}_{id}自定义文件命名。想让目录稳定不混乱可以把author_dir设为nickname_uid昵称加 ID直观且不会重名。直播回放错过开播也能完整保存直播是抖音最有信息量、也最难保存的内容形态。douyin-downloader 的录制功能专门为此设计在配置里加上一段即可link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 录 1 小时0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30 # 网络空闲多久视为结束录制支持 FLV 与 HLS 两种流主播下播、网络中断或你手动 CtrlC已录制的数据都会被保留下来不会白白丢掉。录完的 FLV 文件存放在Downloaded/作者名/live/下旁边还会附一份*_room.json直播间元数据快照方便日后整理归档。进阶工具箱评论、热搜、通知与接口化当基本下载已经熟练下面这些功能能让你的使用体验再上一个台阶。评论采集顺带把用户反馈也存下来开启comments.enabled: true后每个作品会额外生成一份*_comments.json包含全部评论及可选的三级回复适合做内容分析或舆情整理。comments: enabled: true include_replies: false max_comments: 0 # 0 不限条数 page_size: 20热搜与关键词搜索不靠推荐流找内容python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded前者拉取抖音热搜榜前 30 条后者按关键词搜索作品结果都会导出为 JSONL 文件供后续筛选或分析。完成通知下载结束不再盯着屏幕配置notifications后下载完成或失败时会通过 Bark、Telegram 或 Webhook 推送消息手机端实时收到结果适合挂机跑大批量任务时使用。REST API 与桌面版走向接口化和图形化pip install fastapi uvicorn python run.py --serve --serve-port 8000启动后可通过 HTTP 接口提交下载任务、查询任务状态方便集成进自己的自动化流程。如果你更习惯图形界面项目还提供了基于同一套后端打造的桌面版 Douzy粘贴链接即可开始下载任务中心、作品档案一应俱全。新手最容易踩的五个坑附解法1. 主页只能抓到 20 条作品这是翻页风控的常见现象。确保配置里browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证码别急着关窗口。2. 下载速度很慢调大thread并发数或配置proxy如http://127.0.0.1:7890走代理尽量选网络空闲时段跑。3. Cookie 又失效了重新跑一次自动获取命令即可python -m tools.cookie_fetcher --config config.yml4. 怎么查看下载历史数据库默认生成在当前目录的dy_downloader.db一行 SQL 就能查最近记录sqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;5. 下载的文件到底在哪默认在配置中path指定的目录每个作者按昵称 → 模式 → 作品层层归档视频、封面、原声、元数据一目了然。写在最后存得顺手也用得合规到这里你已经掌握了 douyin-downloader 从入门到进阶的完整用法一条命令保存单条视频一段配置批量备份整个主页一段参数留住整场直播再配合去重、增量、通知等细节足以支撑起一个井井有条的个人抖音资源库。想深入研究的读者可以直接翻阅项目里的config.example.yml注释和core/源码目录里面藏着更多可调的细节。最后提醒一句请遵守平台规则尊重创作者版权下载的内容仅用于个人学习研究。好的工具配上正确的使用方式才能让数字生活真正省时又省心。现在就打开终端跑通你的第一条下载命令吧。【免费下载链接】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），仅供参考