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-downloaderdouyin-downloader 是一个命令行抖音批量下载工具一条链接加一份 YAML 配置无水印视频、图文、合集、音乐与直播录制自动归档到本地内置重试、SQLite 去重与浏览器兜底适合长期存档抖音内容。装好环境拿到登录态这一节把拉代码、装依赖、扫码登录一次做完大约五分钟后面所有命令都建立在它之上。只需 Python 3.8macOS、Linux、Windows 均可。拉代码并安装依赖终端无红色报错即环境就绪git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt安装浏览器组件。浏览器兜底和自动获取 Cookie 都依赖 Playwrightpip install playwright python -m playwright install chromium拷贝配置模板并扫码登录模板里每个字段都有中文注释可先通读 config.example.ymlcp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml浏览器会弹出登录页扫码后回到终端按 EnterCookie 自动写入配置不用手动复制。弹窗后卡住的话先确认上一步 chromium 是否装好。自动抓取脚本的源码在 tools/cookie_fetcher.py。验证点打开config.ymlcookies下msToken、ttwid等字段不再是YOUR_...占位符。这一步别省抖音大量内容只对登录用户开放Cookie 没配对后面的请求基本都会失败。跑通第一条无水印视频这一节是全文的验证主线跑通它说明环境、登录态、网络都没问题。配置里真正必填的只有三项link、path、cookies。把link改成一条视频链接link: - https://www.douyin.com/video/760412345678901234567然后启动python run.py -c config.yml验证点终端末尾出现完成统计Downloaded/下生成以作者名命名的目录里面是可直接播放的无水印 mp4。默认每条作品放在{date}_{title}_{id}命名的文件夹里打开cover、music、json后会在旁边多出生成的封面、原声、元数据文件。命令行参数可以临时覆盖配置不用改文件python run.py -c config.yml -u https://www.douyin.com/video/760412345678901234567 -t 8-u追加链接、-t调并发、-p换输出目录。图文笔记同理链接换成/note/{note_id}即可图片按顺序归档。⚠️ 注意2026 年年中起抖音风控已拦截 CLI 的多数直连接口——点赞/收藏类 2026-08 起失效单个视频/图文、合集、音乐 2026-09 起失效主页作品直连翻页同样被拒只剩浏览器兜底一条路。运行时若遇到 403先看文末排障一节这类下载也可以改用桌面版 Douzy内置登录窗口代发请求目前内测中。备份一位博主的主页存某位博主的全部作品用批量模式而不是逐条粘贴。填主页链接在mode勾选要抓的类型number给每种类型设上限0表示不限link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - mix number: post: 50 # 只抓 50 条作品 mix: 20运行方式不变仍是python run.py -c config.yml。验证点跑完后内容按Downloaded/{作者}/post/、Downloaded/{作者}/mix/分层归档Downloaded/download_manifest.jsonl里能逐条对上作品清单。post作品、like喜欢、mix合集、music音乐可以混在同一次任务里跨模式自动去重同一条作品不会下两遍。易错点收藏夹和收藏合集collect/collectmix只能单独使用不能和上面四种模式混写且只认当前登录 Cookie 对应的账号。桌面版 Douzy 提供类似的关注同步 筛选新作品能力效果可以参考录下一场完整直播这一节解决整场直播录制不用开录屏软件。把直播间链接直接填进linklink: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 录到主播下播验证点FLV 文件和房间元数据 JSON 保存在Downloaded/{作者}/live/下FLV 可直接播放。主播下播、录满时长或你手动 CtrlC已录下的字节都会保留。边界要心里有数直播录制接口官方标注为 experimental未覆盖所有直播场景重要场次建议同时人工备份一份若拉的是 HLS 源只会保存 playlist 文件需要 ffmpeg 后处理。只导出数据不下载热搜与关键词只想收集数据、不落地文件时两条命令就够这两个接口目前不受风控影响2026-09 实测仍可直接连接python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded验证点分别在Downloaded/hot_board/和Downloaded/search/下生成带时间戳的 JSONL 文件搜索的文件名还含关键词可直接用 pandas 或 jq 做二次筛选。易错点--search默认只拉 50 条要更多就显式给--search-max。想顺手留评论把comments.enabled设为true每条作品的媒体文件旁会生成{date}_{title}_{id}_comments.jsoninclude_replies: true可多拉二级回复。进阶调优去重、增量与通知批量任务跑几十分钟最怕中途崩掉白跑或硬盘堆出重复文件。这一节只讲值得动的配置。配置项默认值改了之后会发生什么database/database_pathtrue/dy_downloader.db每条下载记录写进 SQLite下次运行自动跳过已下内容increase.post等true增量模式本地文件已存在就跳过删掉文件下次重下thread5并发数网络稳定可试 8retry_times3失败按 1s/2s/5s 指数退避自动重试start_time/end_time空按YYYY-MM-DD过滤发布时间可分段抓取video_qualityhighestoriginal会额外探测上传原片失败退回最高转码档music/cover/avatar/jsonfalse是否顺带保存原声、封面、头像、元数据browser_fallback开启翻页被风控截断时自动开浏览器headless: false时可手动过验证码notifications关闭完成时推送 Bark / Telegram / Webhook适合挂机跑长任务transcript关闭调 OpenAI 接口把视频转写成 txt/json图文笔记不生成转写几组搭配值得记牢去重双保险判断逻辑是数据库记录 本地文件双重检查。只删库不清文件不会触发重下两者都清才会重新下载只删文件不删库则会重下。重试兜底retry_times: 3配合内置 2 请求/秒的限速网络抖动不会留下缺口下载还有 Content-Length 完整性校验残文件自动清理并重试。并发循序渐进thread从 5 起步稳定了再提到 8。一上来拉满容易触发风控反而比慢一点更慢。想重新下载某条被跳过的作品把本地文件夹和库中记录一起清掉rm -rf Downloaded/作者名/post/*_760412345678901234567 sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id 760412345678901234567;按作者清全部、清空整库的完整命令见 README.zh-CN.md 的重新下载一节。遇到问题时来这里找答案跑起来之后遇到的麻烦基本是下面这几类对着现象查。主页只抓到 20 条左右翻页触发了风控。确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动过验证码、别立刻关窗或用start_time/end_time分段抓。突然大面积失败Cookie 过期了。重跑python -m tools.cookie_fetcher --config config.yml更新登录态。大量请求 403报错提到 Argus抖音风控已拦截 CLI 直连单个视频/图文、合集、音乐、点赞/收藏类接口2026-08 起分批生效。主页作品可试浏览器兜底其余下载建议改用桌面版 Douzy硬盘里堆出重复文件去重没开。database: true配合increase走增量。想重下某一条见上一节的重新下载命令文件和库一起清。进度输出很吵progress.quiet_logs: true可在进度阶段静默排查时临时加-v或--show-warnings。速度慢thread提到 8、retry_times给 3逐步上调别一次跳满。上手建议长期用之前先养成几个习惯先用一条单视频链接验证 Cookie 和网络再上主页批量。测试阶段把number.post设成 1~5跑通后再放开到 0。不同任务分配置如config_test.yml、config_daily.yml别共用一份。Cookie 失效是常态把它当周期性维护项不是故障。长任务加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），仅供参考 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-downloaderdouyin-downloader 是一个命令行抖音批量下载工具一条链接加一份 YAML 配置无水印视频、图文、合集、音乐与直播录制自动归档到本地内置重试、SQLite 去重与浏览器兜底适合长期存档抖音内容。装好环境拿到登录态这一节把拉代码、装依赖、扫码登录一次做完大约五分钟后面所有命令都建立在它之上。只需 Python 3.8macOS、Linux、Windows 均可。拉代码并安装依赖终端无红色报错即环境就绪git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt安装浏览器组件。浏览器兜底和自动获取 Cookie 都依赖 Playwrightpip install playwright python -m playwright install chromium拷贝配置模板并扫码登录模板里每个字段都有中文注释可先通读 config.example.ymlcp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml浏览器会弹出登录页扫码后回到终端按 EnterCookie 自动写入配置不用手动复制。弹窗后卡住的话先确认上一步 chromium 是否装好。自动抓取脚本的源码在 tools/cookie_fetcher.py。验证点打开config.ymlcookies下msToken、ttwid等字段不再是YOUR_...占位符。这一步别省抖音大量内容只对登录用户开放Cookie 没配对后面的请求基本都会失败。跑通第一条无水印视频这一节是全文的验证主线跑通它说明环境、登录态、网络都没问题。配置里真正必填的只有三项link、path、cookies。把link改成一条视频链接link: - https://www.douyin.com/video/760412345678901234567然后启动python run.py -c config.yml验证点终端末尾出现完成统计Downloaded/下生成以作者名命名的目录里面是可直接播放的无水印 mp4。默认每条作品放在{date}_{title}_{id}命名的文件夹里打开cover、music、json后会在旁边多出生成的封面、原声、元数据文件。命令行参数可以临时覆盖配置不用改文件python run.py -c config.yml -u https://www.douyin.com/video/760412345678901234567 -t 8-u追加链接、-t调并发、-p换输出目录。图文笔记同理链接换成/note/{note_id}即可图片按顺序归档。⚠️ 注意2026 年年中起抖音风控已拦截 CLI 的多数直连接口——点赞/收藏类 2026-08 起失效单个视频/图文、合集、音乐 2026-09 起失效主页作品直连翻页同样被拒只剩浏览器兜底一条路。运行时若遇到 403先看文末排障一节这类下载也可以改用桌面版 Douzy内置登录窗口代发请求目前内测中。备份一位博主的主页存某位博主的全部作品用批量模式而不是逐条粘贴。填主页链接在mode勾选要抓的类型number给每种类型设上限0表示不限link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - mix number: post: 50 # 只抓 50 条作品 mix: 20运行方式不变仍是python run.py -c config.yml。验证点跑完后内容按Downloaded/{作者}/post/、Downloaded/{作者}/mix/分层归档Downloaded/download_manifest.jsonl里能逐条对上作品清单。post作品、like喜欢、mix合集、music音乐可以混在同一次任务里跨模式自动去重同一条作品不会下两遍。易错点收藏夹和收藏合集collect/collectmix只能单独使用不能和上面四种模式混写且只认当前登录 Cookie 对应的账号。桌面版 Douzy 提供类似的关注同步 筛选新作品能力效果可以参考录下一场完整直播这一节解决整场直播录制不用开录屏软件。把直播间链接直接填进linklink: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 录到主播下播验证点FLV 文件和房间元数据 JSON 保存在Downloaded/{作者}/live/下FLV 可直接播放。主播下播、录满时长或你手动 CtrlC已录下的字节都会保留。边界要心里有数直播录制接口官方标注为 experimental未覆盖所有直播场景重要场次建议同时人工备份一份若拉的是 HLS 源只会保存 playlist 文件需要 ffmpeg 后处理。只导出数据不下载热搜与关键词只想收集数据、不落地文件时两条命令就够这两个接口目前不受风控影响2026-09 实测仍可直接连接python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded验证点分别在Downloaded/hot_board/和Downloaded/search/下生成带时间戳的 JSONL 文件搜索的文件名还含关键词可直接用 pandas 或 jq 做二次筛选。易错点--search默认只拉 50 条要更多就显式给--search-max。想顺手留评论把comments.enabled设为true每条作品的媒体文件旁会生成{date}_{title}_{id}_comments.jsoninclude_replies: true可多拉二级回复。进阶调优去重、增量与通知批量任务跑几十分钟最怕中途崩掉白跑或硬盘堆出重复文件。这一节只讲值得动的配置。配置项默认值改了之后会发生什么database/database_pathtrue/dy_downloader.db每条下载记录写进 SQLite下次运行自动跳过已下内容increase.post等true增量模式本地文件已存在就跳过删掉文件下次重下thread5并发数网络稳定可试 8retry_times3失败按 1s/2s/5s 指数退避自动重试start_time/end_time空按YYYY-MM-DD过滤发布时间可分段抓取video_qualityhighestoriginal会额外探测上传原片失败退回最高转码档music/cover/avatar/jsonfalse是否顺带保存原声、封面、头像、元数据browser_fallback开启翻页被风控截断时自动开浏览器headless: false时可手动过验证码notifications关闭完成时推送 Bark / Telegram / Webhook适合挂机跑长任务transcript关闭调 OpenAI 接口把视频转写成 txt/json图文笔记不生成转写几组搭配值得记牢去重双保险判断逻辑是数据库记录 本地文件双重检查。只删库不清文件不会触发重下两者都清才会重新下载只删文件不删库则会重下。重试兜底retry_times: 3配合内置 2 请求/秒的限速网络抖动不会留下缺口下载还有 Content-Length 完整性校验残文件自动清理并重试。并发循序渐进thread从 5 起步稳定了再提到 8。一上来拉满容易触发风控反而比慢一点更慢。想重新下载某条被跳过的作品把本地文件夹和库中记录一起清掉rm -rf Downloaded/作者名/post/*_760412345678901234567 sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id 760412345678901234567;按作者清全部、清空整库的完整命令见 README.zh-CN.md 的重新下载一节。遇到问题时来这里找答案跑起来之后遇到的麻烦基本是下面这几类对着现象查。主页只抓到 20 条左右翻页触发了风控。确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动过验证码、别立刻关窗或用start_time/end_time分段抓。突然大面积失败Cookie 过期了。重跑python -m tools.cookie_fetcher --config config.yml更新登录态。大量请求 403报错提到 Argus抖音风控已拦截 CLI 直连单个视频/图文、合集、音乐、点赞/收藏类接口2026-08 起分批生效。主页作品可试浏览器兜底其余下载建议改用桌面版 Douzy硬盘里堆出重复文件去重没开。database: true配合increase走增量。想重下某一条见上一节的重新下载命令文件和库一起清。进度输出很吵progress.quiet_logs: true可在进度阶段静默排查时临时加-v或--show-warnings。速度慢thread提到 8、retry_times给 3逐步上调别一次跳满。上手建议长期用之前先养成几个习惯先用一条单视频链接验证 Cookie 和网络再上主页批量。测试阶段把number.post设成 1~5跑通后再放开到 0。不同任务分配置如config_test.yml、config_daily.yml别共用一份。Cookie 失效是常态把它当周期性维护项不是故障。长任务加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），仅供参考