抖音批量下载实操指南去水印、主页存档、直播录制10分钟跑通【免费下载链接】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-downloaderdouyin-downloader 是一个面向抖音批量下载的命令行工具视频、图文、合集、音乐默认无水印输出还能录制直播、采集评论。适合想长期存档自己或他人抖音内容的个人用户给它一个链接加一份 YAML 配置视频、封面、元数据就自动归档到本地去重和续跑都内置好了。默认并发 5失败自动重试 3 次SQLite 记录下载历史下次运行自动跳过已下内容。上图是内测中的桌面端 Douzy基于同一套后端可作功能参考本指南以命令行路线为主。10分钟跑通抖音批量下载只需要 Python 3.8macOS、Linux、Windows 都能跑。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.example.yml 里每个字段都有中文注释。接下来处理登录态。抖音大量内容只对登录用户可见Cookie 没配好请求基本都会失败这是跑通前最关键的一步pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml先装浏览器引擎再执行抓取脚本在弹窗里扫码登录回到终端按 EnterCookie 自动写入 config.yml不用手动复制。浏览器卡住时先确认 chromium 安装命令是否执行成功。最后启动下载python run.py -c config.yml模板默认带一条示例主页链接且只抓 1 条number.post: 1。成功标志终端出现完成统计且 Downloaded/ 下出现以作者名命名的目录里面是无水印 mp4。命令行参数也能临时覆盖配置-u追加链接、-t 8调并发无需改文件。抖音批量下载实战场景主页存档、直播录制、热搜导出抖音主页批量下载存档一个博主主页链接加 mode 勾选是最典型的存档用法。你会得到该博主的作品和合集按Downloaded/作者/post/、Downloaded/作者/mix/分层归档同一条作品跨模式不会下第二遍。link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - mix number: post: 50 mix: 20⚠️ 最易踩的坑收藏夹模式collect/collectmix必须单独使用不能和上面四种混写。另外抖音风控较严翻页可能被截断弹出浏览器窗口时手动过完验证码再关闭。抖音直播录制录一整场直播间链接填进 link 即可拉流不用开录屏软件。你会得到Downloaded/作者/live/下的 FLV 录像文件外加*_room.json房间元数据快照。主播下播、网络空闲或你 CtrlC已录的字节都会保留。link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 录到主播下播注意该接口被项目标注为 experimental极端场景可能有兼容问题重要场次建议同时人工录一份备份。抖音热搜与搜索导出只收数据不下文件只要数据不要视频文件时两条命令就够。你会得到Downloaded/hot_board/和Downloaded/search/下的 JSONL 快照用 jq 或 pandas 直接筛选。python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded这两条命令只采集元数据不产生视频文件。--search-max默认 50批量取样要显式给上限。抖音批量下载配置要点必填的只有三项link、path、cookies其余按需调。默认值可在 config/default_config.py 里逐项核对。配置项默认值改了会发生什么mode[post]决定抓主页的哪几类内容post/like/mix/music 可混选number.post等0不限每种模式的数量上限测试期先给 1~5video/cover/music/json仅 video 开是否顺带保存视频本体、封面、原声、元数据start_time/end_time空按发布时间YYYY-MM-DD过滤方便分段抓取thread5并发数网络稳定可提到 8一上来拉满容易触发风控retry_times3失败按 1s/2s/5s 指数退避自动重试残文件自动清理databasetrue记录写入 SQLite配合increase构成去重双保险下次自动跳过increase.post等true磁盘上已存在的文件直接跳过删掉文件才会重下video_qualityhighest最高转码档original额外探测原画每条多一次探测请求browser_fallback开有窗口翻页被截断时自动开浏览器有窗口才能手动过验证码notifications关完成后推 Bark/Telegram/Webhook适合挂机跑长任务踩坑与排查现象 → 原因 → 解法新手基本卡在这 5 处按现象对号入座。主页只抓到 20~30 条翻页停了原因风控截断翻页。 解法确认browser_fallback.enabled: true且headless: false弹窗里手动过验证或用start_time/end_time分段抓。单条视频、合集、音乐下载报 403原因2026-08 起抖音 Argus 风控陆续封禁这些直连接口带不带 Cookie、重试多少次都一样。 解法按 README 提示改用桌面端 Douzy直播、热搜、搜索、评论接口目前仍可直连。跑了一段时间后大面积失败原因Cookie 过期。 解法重跑python -m tools.cookie_fetcher --config config.yml更新登录态脚本逻辑见 tools/cookie_fetcher.py。硬盘堆出重复文件或同一条反复下原因去重没开或只清了一侧文件在、库记录删了或反之。 解法database: trueincrease: true双保险想重下某一条本地文件夹和库记录要一起删如sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;。没生成 transcript 转写文件原因转写只对视频作品生效图文不转写或enabled、API Key 没配。 解法确认transcript.enabled: true且OPENAI_API_KEY可用。 上手建议先用单条链接验证 Cookie 和网络再上主页批量——首跑目的是验凭据不是冲量。测试期把number.post设 1~5跑通后再放开到 0——小量试错避免白跑一整轮。不同任务分配置config_test.yml、config_daily.yml——参数互不干扰出问题好定位。把 Cookie 过期当周期性维护项——抓取脚本随时可重跑耗时约 1 分钟。长任务加notifications推送——跑完手机就能收到不用守着终端。本项目仅用于技术学习与个人数据管理请在合法合规的前提下使用尊重内容版权与创作者权益。【免费下载链接】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），仅供参考
抖音批量下载实操指南：去水印、主页存档、直播录制，10分钟跑通
抖音批量下载实操指南去水印、主页存档、直播录制10分钟跑通【免费下载链接】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-downloaderdouyin-downloader 是一个面向抖音批量下载的命令行工具视频、图文、合集、音乐默认无水印输出还能录制直播、采集评论。适合想长期存档自己或他人抖音内容的个人用户给它一个链接加一份 YAML 配置视频、封面、元数据就自动归档到本地去重和续跑都内置好了。默认并发 5失败自动重试 3 次SQLite 记录下载历史下次运行自动跳过已下内容。上图是内测中的桌面端 Douzy基于同一套后端可作功能参考本指南以命令行路线为主。10分钟跑通抖音批量下载只需要 Python 3.8macOS、Linux、Windows 都能跑。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.example.yml 里每个字段都有中文注释。接下来处理登录态。抖音大量内容只对登录用户可见Cookie 没配好请求基本都会失败这是跑通前最关键的一步pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml先装浏览器引擎再执行抓取脚本在弹窗里扫码登录回到终端按 EnterCookie 自动写入 config.yml不用手动复制。浏览器卡住时先确认 chromium 安装命令是否执行成功。最后启动下载python run.py -c config.yml模板默认带一条示例主页链接且只抓 1 条number.post: 1。成功标志终端出现完成统计且 Downloaded/ 下出现以作者名命名的目录里面是无水印 mp4。命令行参数也能临时覆盖配置-u追加链接、-t 8调并发无需改文件。抖音批量下载实战场景主页存档、直播录制、热搜导出抖音主页批量下载存档一个博主主页链接加 mode 勾选是最典型的存档用法。你会得到该博主的作品和合集按Downloaded/作者/post/、Downloaded/作者/mix/分层归档同一条作品跨模式不会下第二遍。link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - mix number: post: 50 mix: 20⚠️ 最易踩的坑收藏夹模式collect/collectmix必须单独使用不能和上面四种混写。另外抖音风控较严翻页可能被截断弹出浏览器窗口时手动过完验证码再关闭。抖音直播录制录一整场直播间链接填进 link 即可拉流不用开录屏软件。你会得到Downloaded/作者/live/下的 FLV 录像文件外加*_room.json房间元数据快照。主播下播、网络空闲或你 CtrlC已录的字节都会保留。link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 录到主播下播注意该接口被项目标注为 experimental极端场景可能有兼容问题重要场次建议同时人工录一份备份。抖音热搜与搜索导出只收数据不下文件只要数据不要视频文件时两条命令就够。你会得到Downloaded/hot_board/和Downloaded/search/下的 JSONL 快照用 jq 或 pandas 直接筛选。python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded这两条命令只采集元数据不产生视频文件。--search-max默认 50批量取样要显式给上限。抖音批量下载配置要点必填的只有三项link、path、cookies其余按需调。默认值可在 config/default_config.py 里逐项核对。配置项默认值改了会发生什么mode[post]决定抓主页的哪几类内容post/like/mix/music 可混选number.post等0不限每种模式的数量上限测试期先给 1~5video/cover/music/json仅 video 开是否顺带保存视频本体、封面、原声、元数据start_time/end_time空按发布时间YYYY-MM-DD过滤方便分段抓取thread5并发数网络稳定可提到 8一上来拉满容易触发风控retry_times3失败按 1s/2s/5s 指数退避自动重试残文件自动清理databasetrue记录写入 SQLite配合increase构成去重双保险下次自动跳过increase.post等true磁盘上已存在的文件直接跳过删掉文件才会重下video_qualityhighest最高转码档original额外探测原画每条多一次探测请求browser_fallback开有窗口翻页被截断时自动开浏览器有窗口才能手动过验证码notifications关完成后推 Bark/Telegram/Webhook适合挂机跑长任务踩坑与排查现象 → 原因 → 解法新手基本卡在这 5 处按现象对号入座。主页只抓到 20~30 条翻页停了原因风控截断翻页。 解法确认browser_fallback.enabled: true且headless: false弹窗里手动过验证或用start_time/end_time分段抓。单条视频、合集、音乐下载报 403原因2026-08 起抖音 Argus 风控陆续封禁这些直连接口带不带 Cookie、重试多少次都一样。 解法按 README 提示改用桌面端 Douzy直播、热搜、搜索、评论接口目前仍可直连。跑了一段时间后大面积失败原因Cookie 过期。 解法重跑python -m tools.cookie_fetcher --config config.yml更新登录态脚本逻辑见 tools/cookie_fetcher.py。硬盘堆出重复文件或同一条反复下原因去重没开或只清了一侧文件在、库记录删了或反之。 解法database: trueincrease: true双保险想重下某一条本地文件夹和库记录要一起删如sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;。没生成 transcript 转写文件原因转写只对视频作品生效图文不转写或enabled、API Key 没配。 解法确认transcript.enabled: true且OPENAI_API_KEY可用。 上手建议先用单条链接验证 Cookie 和网络再上主页批量——首跑目的是验凭据不是冲量。测试期把number.post设 1~5跑通后再放开到 0——小量试错避免白跑一整轮。不同任务分配置config_test.yml、config_daily.yml——参数互不干扰出问题好定位。把 Cookie 过期当周期性维护项——抓取脚本随时可重跑耗时约 1 分钟。长任务加notifications推送——跑完手机就能收到不用守着终端。本项目仅用于技术学习与个人数据管理请在合法合规的前提下使用尊重内容版权与创作者权益。【免费下载链接】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），仅供参考
代码包深度解析与实践指南)
