抖音下载工具 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/{id}、/gallery/{id}去水印优先自动挑选最高码率单个合集/collection/{id}、/mix/{id}整个合集的全部作品单个音乐原声/music/{id}优先下载原声文件作者主页批量下载/user/{sec_uid}支持 post发布、like喜欢、mix合集、music音乐四种模式自己账号的收藏夹/user/self?showTabfavorite_collection收藏作品collect与收藏合集collectmix直播录制live.douyin.com/{room_id}录成 FLV/HLS主播下播也保留已录数据评论 / 热搜 / 搜索配置文件或命令行评论可含二级回复热搜与搜索导出 JSONL短链v.douyin.com/...也能自动解析所以你平时在抖音里复制的分享口令链接直接丢给它就能用。二、三分钟拿到你的第一个视频工具分两个版本根目录下的DouYinCommand.pyV1.0 稳定版适合单个视频和downloader.pyV2.0 增强版适合用户主页与批量场景。新手建议从 V1.0 起步链路最短。第一步准备环境并安装依赖确保电脑有 Python 3.6 或更高版本然后把项目克隆到本地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第二步搞定 Cookie最关键的一步抖音接口需要登录凭证Cookie 就是那把通行证。工具提供了两种方式推荐自动获取python cookie_extractor.py运行后会自动打开浏览器引导你登录登录成功后 Cookie 自动写入配置文件全程不用手抄。喜欢手动操作的同学可以运行python get_cookies_manual.py脚本会一步步教你从浏览器开发者工具里复制 Cookie。小提醒Cookie 有时效性失效后重新跑一次上面的命令即可30 秒就能解决。第三步下载第一个视频python DouYinCommand.py默认读取config.yml把里面的link换成你想下载的视频链接保存后运行即可。也可以直接在命令行传参python DouYinCommand.py --cmd True -l https://v.douyin.com/你的短链接 -p ./Downloaded稍等片刻打开Downloaded/目录视频含封面、音乐、头像已经整整齐齐躺好了。三、新手最容易踩的四个坑帮你提前避开坑 1只配置了链接没配 Cookie症状程序能跑但提示需要登录或请求失败。解决先用python cookie_extractor.py完成登录再开始下载。坑 2批量下载时只能抓到 20 条作品这是抖音翻页风控的常见现象不是工具坏了。解决办法是开启浏览器兜底功能在配置文件中加入browser_fallback: enabled: true headless: false浏览器弹窗出现后手动完成一次验证别急着关窗口工具会继续翻页抓取通常就能拿到全部作品了。坑 3重复下载浪费时间和磁盘每次下载前工具都会用 SQLite 数据库 本地文件做双重去重检查同一作品不会重复下载。但注意只删数据库不删文件不会触发重新下载因为程序会扫描本地文件名中的作品 id 来判断。想重下某个作品需要同时清掉对应文件和数据库记录。坑 4进度条刷屏影响阅读默认配置已经开启了静默模式progress.quiet_logs: true如果调试时需要看详细日志再加--show-warnings或-v参数即可。四、批量备份作者主页真正的高频场景对创作者来说最实用的功能是批量下载作者主页。切到 V2.0 增强版一条命令搞定python downloader.py -u https://www.douyin.com/user/xxx默认下载该用户发布的所有作品。如果没配 Cookie直接加--auto-cookie参数工具会先帮你完成登录python downloader.py --auto-cookie -u https://www.douyin.com/user/xxx只想要最近 50 条在配置文件中加上number.post: 50或者用命令行参数指定。想同时备份他点赞过的内容把mode配成多个值mode: - post - like - mix - music工具会依次下载发布作品、点赞作品、合集和音乐而且跨模式自动去重——同一个作品不会在不同模式下重复下载放心大胆全开。运行界面会实时显示每个文件的下载进度、耗时和统计信息一目了然增量下载只下载新增的内容假设你每周都要备份某个博主的作品每次都全量下载太浪费了。开启增量模式即可increase: post: true database: true # 增量依赖数据库记录下次运行时工具会先查数据库只下载上次之后新增的作品已经存在的直接跳过。下载频率越高省下的时间越可观。多线程加速默认 5 个并发线程网络条件好可以适度调高python downloader.py -u 链接 -t 8建议不要超过 10给服务器留点余地也能降低触发风控的概率。按时间筛选只需要某段时间内的作品在配置里设置起止时间即可start_time: 2024-01-01 end_time: 2024-12-31适合整理年度总结、特定时期的创作记录。五、进阶玩法下载完成只是开始下载文件怎么组织的默认开启folderstyle每个作品一个独立文件夹结构清晰Downloaded/ └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── ...mp4 # 无水印视频 ├── ..._cover.jpg # 封面 ├── ..._music.mp3 # 原声音乐 ├── ..._avatar.jpg # 作者头像 └── ..._data.json # 元数据单个作品的完整附件长这样视频、封面、音乐、头像外加一份 JSON 元数据一个不落直播录制不错过任何一场追直播回放不方便工具支持录制直播内容python DouYinCommand.py --cmd True -l https://live.douyin.com/直播间号 -p ./Downloaded运行后工具会先展示直播间标题、在线人数、主播信息让你选择清晰度如 FULL_HD1随后生成流地址开始录制更贴心的是主播下播、网络中断甚至手动中断时已录制的字节会被保留不会白录一场。评论采集与热搜快照想分析某个作品的评论区配置开启后会在媒体文件旁生成*_comments.json可含二级回复。想追踪热点一条命令导出热搜榜python run.py --hot-board 30 -p ./Downloaded # 输出./Downloaded/hot_board/20260424_221530.jsonl关键词搜索也一样方便python run.py --search 猫咪 --search-max 100 -p ./Downloaded下载完自动通知批量任务跑完人却不在电脑前配置 Bark / Telegram / Webhook 推送下载完成后自动通知你手机一响就知道结果了。六、进阶用户再看一眼数据库管理工具的下载历史都记录在 SQLite 数据库里默认dy_downloader.db除了去重还能做很多事查看最近下载的作品sqlite3 dy_downloader.db SELECT aweme_id, title, author_name, datetime(download_time, unixepoch, localtime) FROM aweme ORDER BY download_time DESC LIMIT 20;统计每个作者下载了多少作品SELECT author_name, COUNT(*) FROM aweme GROUP BY author_name;想彻底清空重来删掉Downloaded/目录和dy_downloader.db即可所有逻辑都会从零开始。七、常见问题速查表问题一句话解决Cookie 失效重跑python cookie_extractor.py或python -m tools.cookie_fetcher --config config.yml只能抓到 20 条开启browser_fallback.enabled: true手动过验证码下载很慢适当调低线程数、检查网络、或配置proxy代理特定视频无法下载检查是否被删除或设为私密工具会在 API 失败时自动走浏览器兜底想重下一个作品同时删除本地文件夹和数据库中的对应记录视频下载后想转文字稿开启transcript.enabled调用 OpenAI 转写接口生成 txt/json 字幕文件下一步从今天开始动手到这里douyin-downloader 的核心玩法你已经全部掌握了从下载第一个视频到批量备份作者主页再到直播录制、增量更新、评论采集。建议你现在就动手把喜欢的内容或自己的作品备份一份你会立刻感受到素材真正属于自己的踏实感。还想探索更多项目文档如README.zh-CN.md、USAGE.md和核心源码目录apiproxy/douyin/strategies/下的策略实现、douyin-downloader/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），仅供参考 抖音下载工具 douyin-downloader 完整上手：从去水印下载到批量备份一次讲透
抖音下载工具 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/{id}、/gallery/{id}去水印优先自动挑选最高码率单个合集/collection/{id}、/mix/{id}整个合集的全部作品单个音乐原声/music/{id}优先下载原声文件作者主页批量下载/user/{sec_uid}支持 post发布、like喜欢、mix合集、music音乐四种模式自己账号的收藏夹/user/self?showTabfavorite_collection收藏作品collect与收藏合集collectmix直播录制live.douyin.com/{room_id}录成 FLV/HLS主播下播也保留已录数据评论 / 热搜 / 搜索配置文件或命令行评论可含二级回复热搜与搜索导出 JSONL短链v.douyin.com/...也能自动解析所以你平时在抖音里复制的分享口令链接直接丢给它就能用。二、三分钟拿到你的第一个视频工具分两个版本根目录下的DouYinCommand.pyV1.0 稳定版适合单个视频和downloader.pyV2.0 增强版适合用户主页与批量场景。新手建议从 V1.0 起步链路最短。第一步准备环境并安装依赖确保电脑有 Python 3.6 或更高版本然后把项目克隆到本地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第二步搞定 Cookie最关键的一步抖音接口需要登录凭证Cookie 就是那把通行证。工具提供了两种方式推荐自动获取python cookie_extractor.py运行后会自动打开浏览器引导你登录登录成功后 Cookie 自动写入配置文件全程不用手抄。喜欢手动操作的同学可以运行python get_cookies_manual.py脚本会一步步教你从浏览器开发者工具里复制 Cookie。小提醒Cookie 有时效性失效后重新跑一次上面的命令即可30 秒就能解决。第三步下载第一个视频python DouYinCommand.py默认读取config.yml把里面的link换成你想下载的视频链接保存后运行即可。也可以直接在命令行传参python DouYinCommand.py --cmd True -l https://v.douyin.com/你的短链接 -p ./Downloaded稍等片刻打开Downloaded/目录视频含封面、音乐、头像已经整整齐齐躺好了。三、新手最容易踩的四个坑帮你提前避开坑 1只配置了链接没配 Cookie症状程序能跑但提示需要登录或请求失败。解决先用python cookie_extractor.py完成登录再开始下载。坑 2批量下载时只能抓到 20 条作品这是抖音翻页风控的常见现象不是工具坏了。解决办法是开启浏览器兜底功能在配置文件中加入browser_fallback: enabled: true headless: false浏览器弹窗出现后手动完成一次验证别急着关窗口工具会继续翻页抓取通常就能拿到全部作品了。坑 3重复下载浪费时间和磁盘每次下载前工具都会用 SQLite 数据库 本地文件做双重去重检查同一作品不会重复下载。但注意只删数据库不删文件不会触发重新下载因为程序会扫描本地文件名中的作品 id 来判断。想重下某个作品需要同时清掉对应文件和数据库记录。坑 4进度条刷屏影响阅读默认配置已经开启了静默模式progress.quiet_logs: true如果调试时需要看详细日志再加--show-warnings或-v参数即可。四、批量备份作者主页真正的高频场景对创作者来说最实用的功能是批量下载作者主页。切到 V2.0 增强版一条命令搞定python downloader.py -u https://www.douyin.com/user/xxx默认下载该用户发布的所有作品。如果没配 Cookie直接加--auto-cookie参数工具会先帮你完成登录python downloader.py --auto-cookie -u https://www.douyin.com/user/xxx只想要最近 50 条在配置文件中加上number.post: 50或者用命令行参数指定。想同时备份他点赞过的内容把mode配成多个值mode: - post - like - mix - music工具会依次下载发布作品、点赞作品、合集和音乐而且跨模式自动去重——同一个作品不会在不同模式下重复下载放心大胆全开。运行界面会实时显示每个文件的下载进度、耗时和统计信息一目了然增量下载只下载新增的内容假设你每周都要备份某个博主的作品每次都全量下载太浪费了。开启增量模式即可increase: post: true database: true # 增量依赖数据库记录下次运行时工具会先查数据库只下载上次之后新增的作品已经存在的直接跳过。下载频率越高省下的时间越可观。多线程加速默认 5 个并发线程网络条件好可以适度调高python downloader.py -u 链接 -t 8建议不要超过 10给服务器留点余地也能降低触发风控的概率。按时间筛选只需要某段时间内的作品在配置里设置起止时间即可start_time: 2024-01-01 end_time: 2024-12-31适合整理年度总结、特定时期的创作记录。五、进阶玩法下载完成只是开始下载文件怎么组织的默认开启folderstyle每个作品一个独立文件夹结构清晰Downloaded/ └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── ...mp4 # 无水印视频 ├── ..._cover.jpg # 封面 ├── ..._music.mp3 # 原声音乐 ├── ..._avatar.jpg # 作者头像 └── ..._data.json # 元数据单个作品的完整附件长这样视频、封面、音乐、头像外加一份 JSON 元数据一个不落直播录制不错过任何一场追直播回放不方便工具支持录制直播内容python DouYinCommand.py --cmd True -l https://live.douyin.com/直播间号 -p ./Downloaded运行后工具会先展示直播间标题、在线人数、主播信息让你选择清晰度如 FULL_HD1随后生成流地址开始录制更贴心的是主播下播、网络中断甚至手动中断时已录制的字节会被保留不会白录一场。评论采集与热搜快照想分析某个作品的评论区配置开启后会在媒体文件旁生成*_comments.json可含二级回复。想追踪热点一条命令导出热搜榜python run.py --hot-board 30 -p ./Downloaded # 输出./Downloaded/hot_board/20260424_221530.jsonl关键词搜索也一样方便python run.py --search 猫咪 --search-max 100 -p ./Downloaded下载完自动通知批量任务跑完人却不在电脑前配置 Bark / Telegram / Webhook 推送下载完成后自动通知你手机一响就知道结果了。六、进阶用户再看一眼数据库管理工具的下载历史都记录在 SQLite 数据库里默认dy_downloader.db除了去重还能做很多事查看最近下载的作品sqlite3 dy_downloader.db SELECT aweme_id, title, author_name, datetime(download_time, unixepoch, localtime) FROM aweme ORDER BY download_time DESC LIMIT 20;统计每个作者下载了多少作品SELECT author_name, COUNT(*) FROM aweme GROUP BY author_name;想彻底清空重来删掉Downloaded/目录和dy_downloader.db即可所有逻辑都会从零开始。七、常见问题速查表问题一句话解决Cookie 失效重跑python cookie_extractor.py或python -m tools.cookie_fetcher --config config.yml只能抓到 20 条开启browser_fallback.enabled: true手动过验证码下载很慢适当调低线程数、检查网络、或配置proxy代理特定视频无法下载检查是否被删除或设为私密工具会在 API 失败时自动走浏览器兜底想重下一个作品同时删除本地文件夹和数据库中的对应记录视频下载后想转文字稿开启transcript.enabled调用 OpenAI 转写接口生成 txt/json 字幕文件下一步从今天开始动手到这里douyin-downloader 的核心玩法你已经全部掌握了从下载第一个视频到批量备份作者主页再到直播录制、增量更新、评论采集。建议你现在就动手把喜欢的内容或自己的作品备份一份你会立刻感受到素材真正属于自己的踏实感。还想探索更多项目文档如README.zh-CN.md、USAGE.md和核心源码目录apiproxy/douyin/strategies/下的策略实现、douyin-downloader/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），仅供参考