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 数据库去重、并发重试、时间过滤和浏览器兜底翻页覆盖单个作品到整个主页的常见批量下载场景。 先搞清楚这个工具能做什么在动手之前先把能力边界理清楚避免配置半天发现需求不支持。根据 README.zh-CN.md 的功能清单它支持单条视频、图文、合集、音乐链接下载https://v.douyin.com/...短链可自动解析作者主页批量下载模式包括post发布、like喜欢、mix合集、music音乐当前登录账号的收藏夹与收藏合集下载collect/collectmix无水印源优先、按码率自动挑选最高清、封面/音乐/头像/JSON 元数据可选保存并发下载默认 5 线程、指数退避重试1s/2s/5s、默认 2 请求/秒限速直播录制实验性、评论采集、热搜榜导出、关键词搜索、REST API 服务模式它不适合的场景也写得很直白collect/collectmix只支持当前登录账号且不能和post/like等模式混用浏览器兜底目前只对post模式做了完整验证。 三步跑通第一个下载这一步的目标是让你 10 分钟内看到第一个落地的文件。第 1 步拿到代码并装依赖。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt环境要求是 Python 3.8macOS、Linux、Windows 都可以。第 2 步准备配置文件。仓库自带的 config.example.yml 注释非常全直接复制一份使用cp config.example.yml config.yml第 3 步获取 Cookie。抖音接口需要登录态最省事的方式是自动抓取python -m tools.cookie_fetcher --config config.yml会弹出一个浏览器窗口登录后回到终端按 Enter程序会自动把 Cookie 写回配置。这个脚本位于 tools/cookie_fetcher.py内部依赖 Playwright需要先安装pip install playwright python -m playwright install chromium第 4 步运行下载。python run.py -c config.yml命令行参数可以覆盖配置文件比如临时追加一条链接、改成 8 线程、指定输出目录python run.py -c config.yml \ -u https://www.douyin.com/video/7604129988555574538 \ -t 8 \ -p ./Downloaded 读懂 config.yml常用配置项逐个过配置文件决定了下载行为但真正常用的字段没几个。下面按重要性排序。必改项link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 要下载的链接可多条 path: ./Downloaded/ # 输出目录 mode: - post # 主页批量下载的模式 number: post: 50 # 每种模式下载多少条0 不限number为 0 表示全量抓取建议第一次运行先设个小数字试试水。按需开启的产物开关video: true # 是否保存视频本体 music: false # 是否保存音乐 cover: false # 是否保存封面 json: false # 是否保存原始 JSON 元数据画质与命名video_quality支持original探测上传原片、highest默认最高转码档、lowest或指定分辨率如1080p、720p。命名由filename_template和folder_template控制可用变量包括{date} {title} {author} {id}等要求模板里包含{id}防止重名覆盖。行为控制配置项作用thread并发数默认 5retry_times失败重试次数默认 3start_time/end_time按作品发布时间过滤格式YYYY-MM-DDincrease各模式增量开关跳过已下载内容database启用 SQLite 去重与历史默认 trueproxy为 API 请求和媒体下载设置代理完整的字段和注释都在 config.example.yml 里改配置前先翻一遍它比查任何文档都快。 核心场景不同链接对应不同玩法链接类型决定走哪条下载流程这部分逻辑在 core/ 目录里DownloaderFactory会把 URL 解析结果映射到对应的下载器。下面是几种典型场景的最小配置。下载单个视频 / 图文 / 合集 / 音乐直接把链接放进link即可工具会自动识别link: - https://www.douyin.com/video/7604129988555574538 - https://www.douyin.com/note/7341234567890123456 - https://www.douyin.com/collection/7341234567890123456 - https://www.douyin.com/music/7341234567890123456单音乐链接会优先下载原声文件缺失时回退到该音乐下的首条作品。批量下载作者主页多模式可以同时启用同一个aweme_id跨模式自动去重不会重复下载link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like - mix number: post: 0 like: 0 mix: 0下载自己账号的收藏夹链接固定为 self 形式且collect/collectmix必须单独使用link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect采集评论与热搜评论按作品生成*_comments.json文件热搜和搜索走命令行python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded结果分别落到Downloaded/hot_board/和Downloaded/search/下的 JSONL 文件。录制直播把link指向直播间即进入录制模式live.max_duration_seconds设为 0 表示录到主播下播。中断或下播时已录制的字节会被保留不会白录。 进阶玩法增量、去重与自动化批量下载跑过一次之后第二次、第三次运行才是真正省时间的环节。增量下载。开启increase后已判定下载过的作品会被跳过只补新内容increase: post: true like: true mix: true music: true database: true去重逻辑由 storage/database.py 维护的 SQLite 记录和本地文件名双重校验默认库文件是dy_downloader.db。时间过滤。只要某个时间段的作品start_time: 2026-01-01 end_time: 2026-06-30任务完成通知。批量任务通常耗时较长可以配置 Bark / Telegram / Webhook下载成功或失败时推送到手机notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY sound: bellREST API 服务模式。想把它集成到自己的系统里可以起一个 HTTP 服务pip install fastapi uvicorn python run.py --serve --serve-port 8000提交POST /api/v1/download拿job_id再轮询GET /api/v1/jobs/{job_id}查进度。完成态的 job 按 24 小时 TTL 自动剪裁。Docker 部署。仓库根目录提供了 Dockerfiledocker build -t douyin-downloader . docker run -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/Downloaded:/app/Downloaded douyin-downloader️ 桌面版不想碰命令行的选择如果你不习惯 YAML 和终端项目还提供了基于同一套后端的桌面客户端 Douzy支持抖音、TikTok、YouTube 三个平台的链接粘贴下载。目前处于内测期从 Releases 页面下载安装文件即可。粘贴链接后会自动识别作品类型点「下载」即可。它还有几个对批量用户很实用的视图任务中心显示每个任务的成功/失败件数失败项可以单独重试也能直接打开输出目录。关注页会同步博主、标记新作品数量适合持续跟踪固定创作者的更新收藏与喜欢页则可以把收藏合集整体同步下来再批量下载。 常见坑与排错跑批量任务时这四个问题出现频率最高README 里都有对应说明。只抓到 20 条作品就停了。这是翻页触发了风控。确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证不要立即关窗。注意兜底目前只对post模式验证过。Cookie 失效。症状通常是请求被拒或返回异常。重新执行python -m tools.cookie_fetcher --config config.yml刷新即可。想重新下载某个作品却不触发。去重是「数据库 本地文件」双重判断只删数据库不删文件不会重下只删文件不删数据库才会重下文件缺失会被视为需要重新下载。彻底重来就删Downloaded/目录和dy_downloader.db。进度条刷屏。默认progress.quiet_logs: true已静默调试时再临时加--show-warnings或-v。另外提醒一句这个项目定位为技术研究与个人数据管理用途请在合法合规的前提下使用尊重创作者版权勿用于商业用途。【免费下载链接】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 是一个值得上手的开源命令行工具。它支持去水印下载、SQLite 数据库去重、并发重试、时间过滤和浏览器兜底翻页覆盖单个作品到整个主页的常见批量下载场景。 先搞清楚这个工具能做什么在动手之前先把能力边界理清楚避免配置半天发现需求不支持。根据 README.zh-CN.md 的功能清单它支持单条视频、图文、合集、音乐链接下载https://v.douyin.com/...短链可自动解析作者主页批量下载模式包括post发布、like喜欢、mix合集、music音乐当前登录账号的收藏夹与收藏合集下载collect/collectmix无水印源优先、按码率自动挑选最高清、封面/音乐/头像/JSON 元数据可选保存并发下载默认 5 线程、指数退避重试1s/2s/5s、默认 2 请求/秒限速直播录制实验性、评论采集、热搜榜导出、关键词搜索、REST API 服务模式它不适合的场景也写得很直白collect/collectmix只支持当前登录账号且不能和post/like等模式混用浏览器兜底目前只对post模式做了完整验证。 三步跑通第一个下载这一步的目标是让你 10 分钟内看到第一个落地的文件。第 1 步拿到代码并装依赖。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt环境要求是 Python 3.8macOS、Linux、Windows 都可以。第 2 步准备配置文件。仓库自带的 config.example.yml 注释非常全直接复制一份使用cp config.example.yml config.yml第 3 步获取 Cookie。抖音接口需要登录态最省事的方式是自动抓取python -m tools.cookie_fetcher --config config.yml会弹出一个浏览器窗口登录后回到终端按 Enter程序会自动把 Cookie 写回配置。这个脚本位于 tools/cookie_fetcher.py内部依赖 Playwright需要先安装pip install playwright python -m playwright install chromium第 4 步运行下载。python run.py -c config.yml命令行参数可以覆盖配置文件比如临时追加一条链接、改成 8 线程、指定输出目录python run.py -c config.yml \ -u https://www.douyin.com/video/7604129988555574538 \ -t 8 \ -p ./Downloaded 读懂 config.yml常用配置项逐个过配置文件决定了下载行为但真正常用的字段没几个。下面按重要性排序。必改项link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 要下载的链接可多条 path: ./Downloaded/ # 输出目录 mode: - post # 主页批量下载的模式 number: post: 50 # 每种模式下载多少条0 不限number为 0 表示全量抓取建议第一次运行先设个小数字试试水。按需开启的产物开关video: true # 是否保存视频本体 music: false # 是否保存音乐 cover: false # 是否保存封面 json: false # 是否保存原始 JSON 元数据画质与命名video_quality支持original探测上传原片、highest默认最高转码档、lowest或指定分辨率如1080p、720p。命名由filename_template和folder_template控制可用变量包括{date} {title} {author} {id}等要求模板里包含{id}防止重名覆盖。行为控制配置项作用thread并发数默认 5retry_times失败重试次数默认 3start_time/end_time按作品发布时间过滤格式YYYY-MM-DDincrease各模式增量开关跳过已下载内容database启用 SQLite 去重与历史默认 trueproxy为 API 请求和媒体下载设置代理完整的字段和注释都在 config.example.yml 里改配置前先翻一遍它比查任何文档都快。 核心场景不同链接对应不同玩法链接类型决定走哪条下载流程这部分逻辑在 core/ 目录里DownloaderFactory会把 URL 解析结果映射到对应的下载器。下面是几种典型场景的最小配置。下载单个视频 / 图文 / 合集 / 音乐直接把链接放进link即可工具会自动识别link: - https://www.douyin.com/video/7604129988555574538 - https://www.douyin.com/note/7341234567890123456 - https://www.douyin.com/collection/7341234567890123456 - https://www.douyin.com/music/7341234567890123456单音乐链接会优先下载原声文件缺失时回退到该音乐下的首条作品。批量下载作者主页多模式可以同时启用同一个aweme_id跨模式自动去重不会重复下载link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like - mix number: post: 0 like: 0 mix: 0下载自己账号的收藏夹链接固定为 self 形式且collect/collectmix必须单独使用link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect采集评论与热搜评论按作品生成*_comments.json文件热搜和搜索走命令行python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded结果分别落到Downloaded/hot_board/和Downloaded/search/下的 JSONL 文件。录制直播把link指向直播间即进入录制模式live.max_duration_seconds设为 0 表示录到主播下播。中断或下播时已录制的字节会被保留不会白录。 进阶玩法增量、去重与自动化批量下载跑过一次之后第二次、第三次运行才是真正省时间的环节。增量下载。开启increase后已判定下载过的作品会被跳过只补新内容increase: post: true like: true mix: true music: true database: true去重逻辑由 storage/database.py 维护的 SQLite 记录和本地文件名双重校验默认库文件是dy_downloader.db。时间过滤。只要某个时间段的作品start_time: 2026-01-01 end_time: 2026-06-30任务完成通知。批量任务通常耗时较长可以配置 Bark / Telegram / Webhook下载成功或失败时推送到手机notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY sound: bellREST API 服务模式。想把它集成到自己的系统里可以起一个 HTTP 服务pip install fastapi uvicorn python run.py --serve --serve-port 8000提交POST /api/v1/download拿job_id再轮询GET /api/v1/jobs/{job_id}查进度。完成态的 job 按 24 小时 TTL 自动剪裁。Docker 部署。仓库根目录提供了 Dockerfiledocker build -t douyin-downloader . docker run -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/Downloaded:/app/Downloaded douyin-downloader️ 桌面版不想碰命令行的选择如果你不习惯 YAML 和终端项目还提供了基于同一套后端的桌面客户端 Douzy支持抖音、TikTok、YouTube 三个平台的链接粘贴下载。目前处于内测期从 Releases 页面下载安装文件即可。粘贴链接后会自动识别作品类型点「下载」即可。它还有几个对批量用户很实用的视图任务中心显示每个任务的成功/失败件数失败项可以单独重试也能直接打开输出目录。关注页会同步博主、标记新作品数量适合持续跟踪固定创作者的更新收藏与喜欢页则可以把收藏合集整体同步下来再批量下载。 常见坑与排错跑批量任务时这四个问题出现频率最高README 里都有对应说明。只抓到 20 条作品就停了。这是翻页触发了风控。确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证不要立即关窗。注意兜底目前只对post模式验证过。Cookie 失效。症状通常是请求被拒或返回异常。重新执行python -m tools.cookie_fetcher --config config.yml刷新即可。想重新下载某个作品却不触发。去重是「数据库 本地文件」双重判断只删数据库不删文件不会重下只删文件不删数据库才会重下文件缺失会被视为需要重新下载。彻底重来就删Downloaded/目录和dy_downloader.db。进度条刷屏。默认progress.quiet_logs: true已静默调试时再临时加--show-warnings或-v。另外提醒一句这个项目定位为技术研究与个人数据管理用途请在合法合规的前提下使用尊重创作者版权勿用于商业用途。【免费下载链接】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），仅供参考
