抖音无水印下载工具 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.bit_rate码率选最高清版本,不用手动挑画质 - 内容类型全:视频、图文、合集、原声音乐、直播录制,封面、头像、作品元数据(data.json)一并带走
- 作者主页批量保存:发布作品 / 点赞 / 合集 / 音乐四种模式,外加当前账号收藏夹
- 双重去重 + 增量下载:SQLite 数据库和本地文件一起核对,重跑只下新作品
- 抗坏情况:失败指数退避重试、完整性校验,API 受限自动切浏览器翻页
环境准备:三条命令跑通第一次下载
需要 Python 3.8+,Windows、macOS、Linux 都可以。先克隆代码:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader安装依赖并复制一份示例配置:
pip install -r requirements.txt cp config.example.yml config.yml关键是拿到 Cookie——抖音内容需要登录态,手动去浏览器翻 Cookie 容易出错,项目自带获取工具,运行后会自动打开浏览器:
python -m tools.cookie_fetcher --config config.yml扫码登录、回到终端按回车,Cookie 自动写入配置文件。然后在 config.yml 里填第一条链接,v.douyin.com短链可以直接用,会自动解析:
link: - https://v.douyin.com/你的短链/ path: ./Downloaded/ thread: 5 retry_times: 3运行(完整参数说明见 README.zh-CN.md):
python run.py -c config.yml终端里的进度条走完,无水印视频、封面、音乐、元数据就会按作者名放进 Downloaded 文件夹,第一次下载完成。
核心使用场景
单条视频、图文怎么保存
config.yml 里的链接换成对应类型即可:视频/video/{aweme_id}、图文/note/{note_id}、合集/collection/{mix_id}。不想编辑配置也可以直接在命令行追加:python run.py -u "https://www.douyin.com/video/xxxx" -p ./Downloaded。工具自动识别类型、选无水印源、按码率选最高清。
抖音作者主页作品批量保存怎么做
这是最好用的部分。把链接换成主页地址,用 mode 声明要哪些内容:
link: - https://www.douyin.com/user/xxxx mode: [post, like, mix, music] number: {post: 0, like: 0, mix: 0, music: 0}post是发布的作品,like是点赞过的视频,mix是合集,music是原声;number填 0 表示不限量全量拉取。几百条作品并发下载,终端里每个任务一条进度条:
同一条作品同时出现在"作品"和"点赞"里,会跨模式自动去重,只下一次。
收藏夹作品怎么一键清空
收藏夹有专门入口,链接指向自己的收藏页即可:https://www.douyin.com/user/self?showTab=favorite_collection,再配mode: [collect](收藏夹作品)或mode: [collectmix](收藏合集),你收藏过的内容一次搬空。注意该模式只对当前 Cookie 登录的账号生效,且要单独使用,不能和 post / like 混写。
这些细节可以放心交给它跑几百条任务
- 双重去重:下载前先查 SQLite 数据库(默认 dy_downloader.db)再扫一遍本地文件,两处都确认"没下过"才开始,终端会逐条打印"跳过已存在",重跑不浪费流量
- 完整性校验:每个文件按 Content-Length 头比对,中途断网留下的半截文件会被自动清理并重试,不会留一堆坏文件
- 浏览器兜底:API 翻页被风控时自动启动浏览器滚动翻页,可人工过验证码(配置里
browser_fallback.enabled: true) - 自动归档 + 历史可查:按"作者/类型"建文件夹,每条作品单独一个目录,命名模板含日期、标题、作品 ID,配置里可用变量改成自己习惯的格式;下载历史全记在数据库里,桌面版的作品档案页还能按作者、关键词、时间筛选
进阶选项
直播录制。把live.douyin.com/{room_id}放进配置,按提示选清晰度(FULL_HD1 / SD1 / SD2)开始录。主播下播或中途断网,已录部分都会保留,文件存到作者名/live/下并附带直播间元数据。
热搜榜与关键词搜索。找素材不用打开 App:python run.py --hot-board 30 -p ./Downloaded导出热搜快照,python run.py --search "猫咪" --search-max 100按关键词搜作品,结果都落 JSONL 文件,方便后续处理。
完成通知。长任务不用守着终端,配置 Bark、Telegram 或 Webhook(企业微信 / 飞书 / 钉钉机器人地址同样可用),完成或出错自动推送到手机,推送失败不阻塞下载。
服务化。想接入自己的自动化流程,python run.py --serve --serve-port 8000把它变成 REST API:POST 提交下载任务、GET 查状态;需要长期挂机跑,项目自带 Dockerfile。
避坑速查
主页几百条只拉到 20 条。是抖音的翻页风控,不是工具坏了。配置里开browser_fallback.enabled: true并把headless: false,弹窗后手动过一次验证码即可继续。
Cookie 失效,下载全失败。重新跑一遍python -m tools.cookie_fetcher --config config.yml,扫码按回车刷新即可。
想重新下载某条作品。双重去重会拦下来,只删文件不够,还要把 dy_downloader.db 里对应记录清掉,两处都删了再重跑。
HLS 直播文件播不了。HLS 源只保存了 playlist 文件,需要用 ffmpeg 后处理合并;FLV 源可以直接播放。
怎么开始
最短路径:克隆仓库装好依赖,运行一次 Cookie 获取命令,把最想存的一条视频链接填进 config.yml,跑python run.py -c config.yml。第一条跑通之后,再去看批量下载和增量更新。工具免费开源,请用在个人学习和合理使用范围内,尊重原创作者的版权,也遵守平台规则。
【免费下载链接】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),仅供参考