快速掌握抖音批量下载从单条视频到整站主页的完整指南【免费下载链接】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把一条抖音链接粘贴进终端后几秒内你会看到带进度条的下载任务滚动起来Downloaded 目录里自动长出按作者、按内容类型分好的文件夹每个作品旁还挂着封面、原声和元数据。这就是douyin-downloader跑起来后的样子它支持无水印视频、图文、合集、音乐、直播与整页主页的批量下载内置进度展示、失败重试、SQLite 去重和浏览器兜底。主界面示意识别单条作品后一键提交下载任务进入队列自动执行一分钟认识这个工具一句话定位douyin-downloader 是一个免费开源的抖音批量下载工具配置驱动、命令行运行面向一次存够而不是单次保存。三个最核心的卖点原生无水印自动挑选无水印源并按码率自动挑最高清版本你不用关心源文件细节。整页主页批量下载/user/{sec_uid}链接 模式开关作品、点赞、合集、音乐都能成批抓跨模式自动去重。SQLite 去重 增量下载数据库记录已下载的作品下次只拉新增重跑不浪费流量。另有两件事值得知道翻页被风控时会启动浏览器兜底、支持人工过验证码如果你更喜欢图形界面同一套后端还出了桌面版Douzy本文聚焦命令行。 能力分层地图基础 / 进阶 / 整合与其逐条念功能不如按上手路径分成三层。每层你只需要记住一件事这一层帮你解决什么。基础层把内容可靠地存下来解决的是下载本身单条视频/图文/合集/音乐、短链自动解析v.douyin.com这类、并发下载默认 5 线程、指数退避重试、Content-Length 完整性校验下坏的文件自动清理重下。这一层你几乎不用操心配置里保持database: true即可。进阶层把下载变成可重复的流程解决的是反复下载与精细控制增量下载只抓新作品、时间过滤只下某段时间的内容、命名模板{date}_{title}_{id}让文件永远有序、评论采集输出结构化 JSON、可选的视频转写调 OpenAI 接口生成文字稿。桌面版任务中心示意同一套后端任务进度、失败重试、输出目录都可视化管理整合层把工具接进你的工作流解决的是和外部系统打交道登录账号收藏夹备份collect/collectmix模式、完成后推送Bark / Telegram / Webhook 通知、热搜榜与关键词搜索导出 JSONL 快照、REST API 服务模式后面单讲。关注管理示意同步博主列表、筛选新作品适合长期跟踪的账号库模块想深挖的话核心下载逻辑在 core/去重与记录在 storage/限流与重试在 control/配置解析在 config/。⚡ 最小可运行路径四步跑通第一个下载目标很明确从拿到项目到第一条视频落盘不超过四步。第 1 步拿到项目并装依赖。这一步是把代码和 Python 依赖准备好git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt跑通后预期终端无报错run.py能执行--version。第 2 步复制配置模板。这一步生成你自己的config.yml模板里有全部字段的注释cp config.example.yml config.yml跑通后预期项目根目录多了一个可编辑的config.yml。第 3 步自动获取 Cookie。抖音接口需要登录态这一步会弹出浏览器你扫码登录后回终端按 Enter程序自动把 Cookie 写进配置pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml跑通后预期config.yml的 cookies 段被自动填充无需手抄。第 4 步下载第一条视频。把config.yml里的link换成一条视频链接然后运行link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/python run.py -c config.yml跑通后预期进度条走完./Downloaded/下出现作品文件夹里面是无水印视频默认只存视频本体封面、原声、JSON 由下面几个开关按需打开。到这里环境就算打通了。后面所有场景都只是改config.yml里的几个字段。️ 按需深入六个高频场景卡以下卡片互相独立可以跳读。每张卡只回答三件事什么情况下用、改哪里、得到什么。单条快速测试适用刚配完环境先验证链路。关键配置link填视频链接即可其余不动。效果一个文件夹里一个无水印视频用来确认 Cookie、网络、路径都没问题。博主主页批量下载适用想存下某创作者的全部作品。关键配置link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0 # 0 表示不限量全部下载效果该博主作品按命名模板逐个落盘。为什么填 0number.post是数量上限填具体数字就是只下最新 N 条这是控制下载规模的唯一阀门。定时增量同步适用关注某个持续更新的账号想只补新内容。关键配置increase: post: true database: true # 增量依赖数据库记录必须开效果已下载过的作品直接跳过第二次运行只拉新增。注意database一旦关掉去重和增量都会失效相当于每次全量重下。时间区间过滤适用只要某段时间的内容比如最近一个月。关键配置start_time: 2026-08-15 end_time: 2026-09-15效果区间外的作品直接不参与下载省流量也省时间。这两个字段留空字符串即不启用过滤。直播录制适用想留住一场直播。关键配置link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 一直录到主播下播效果录到的 FLV 保存在作者目录的live/下附带直播间元数据快照。关键设计是中断安全下播、断网甚至 CtrlC已录制的字节都会保留不会白录。收藏夹备份与评论采集适用备份自己的收藏、或者做内容分析要评论数据。关键配置comments: enabled: true include_replies: false # true 会多拉二级回复请求量明显变大 max_comments: 500 # 0 不限效果每个媒体文件旁生成一个*_comments.json结构化可直接喂给分析脚本。收藏夹模式用mode: [collect]当前登录账号自己的收藏且不能和其他模式混用。 问题排查手册按现象对号入座现象403 / 未登录错误判断依据日志里反复出现 403 或登录态失效几乎一定是 Cookie 过期有效期通常几天到两周平台策略波动。解决重跑python -m tools.cookie_fetcher --config config.yml即可建议养成每周更新一次的习惯服务器无图形界面时可手动从浏览器复制 Cookie 填进配置。现象只抓到 20 条就停判断依据这是翻页触发风控的典型症状——第一页之后 API 拒绝继续。解决确认兜底开关打开出现验证码弹窗后手动完成验证再关窗口browser_fallback: enabled: true headless: false浏览器兜底目前对post模式验证最完整like/mix/music主要依赖 API 正常分页。现象文件下了一半或损坏判断依据任务日志里有重试记录或本地文件明显偏小。解决完整性校验Content-Length 比对默认就开着坏文件会自动清理并重下。如果大面积出现先把thread从 5 调到 2~3并检查网络是否稳定——慢不一定是工具的错。现象批量下载时机器吃紧判断依据内存或带宽占用明显偏高。解决降线程数、用number分批每次 50~100 条、预留 50GB 以上磁盘。另外记住三个老手习惯命名模板里必须包含{id}避免重名覆盖、重度使用把author_dir设成nickname_uid昵称重名会合并、改名会分裂加 sec_uid 一劳永逸、增量任务保持database: true。 生态与集成把它变成基础设施REST API 服务模式适合嵌进其他系统或定时任务pip install fastapi uvicorn python run.py --serve --serve-port 8000跑通后预期服务监听 8000 端口。四个接口各司其职POST /api/v1/download提交任务传{url: ...}拿job_id、GET /api/v1/jobs/{job_id}查状态、GET /api/v1/jobs列最近任务、GET /api/v1/health健康探针。任务服务实现在 server/完成态任务按 TTL 容量自动清理不会无限堆积。Docker 部署适合放服务器上无人值守docker build -t douyin-downloader . docker run -v $(pwd)/config.yml:/app/config.yml \ -v $(pwd)/Downloaded:/app/Downloaded douyin-downloader跑通后预期容器内按同一份config.yml执行产物直接落到你挂载的本地目录宿主机不装 Python 也能跑。二次开发方向代码按职责分包边界清楚改动前先看对应目录下载策略 core/视频/音乐/直播/合集各有独立 downloader新增下载类型照 core/downloader_factory.py 注册即可、认证 auth/、队列与限流 control/、存储 storage/。配套测试在 tests/pytest tests/能直接验证你的改动没破坏既有行为。 行动收尾价值一句话把手动一个个保存变成一条链接、一次配置、批量落盘而且去重、重试、校验全都替你做了。下一步就三件事克隆仓库按最小可运行路径四步跑通第一条视频换成一个博主主页链接把number.post填 0体验第一次批量下载打开increase和database让它变成可以每周重跑的同步任务。核心优势清单免费开源无水印、自动选最高码率视频 / 图文 / 合集 / 音乐 / 直播 / 收藏夹全类型覆盖SQLite 双重去重 增量下载重跑不浪费浏览器兜底应对翻页风控中断安全命名模板、时间过滤、评论采集、转写等精细化控制REST API Docker能接进任何自动化链路配置、代码、图片都开源可查遇到问题先看上面那张现象对照表。现在就可以打开终端把第一条视频存下来。【免费下载链接】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-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把一条抖音链接粘贴进终端后几秒内你会看到带进度条的下载任务滚动起来Downloaded 目录里自动长出按作者、按内容类型分好的文件夹每个作品旁还挂着封面、原声和元数据。这就是douyin-downloader跑起来后的样子它支持无水印视频、图文、合集、音乐、直播与整页主页的批量下载内置进度展示、失败重试、SQLite 去重和浏览器兜底。主界面示意识别单条作品后一键提交下载任务进入队列自动执行一分钟认识这个工具一句话定位douyin-downloader 是一个免费开源的抖音批量下载工具配置驱动、命令行运行面向一次存够而不是单次保存。三个最核心的卖点原生无水印自动挑选无水印源并按码率自动挑最高清版本你不用关心源文件细节。整页主页批量下载/user/{sec_uid}链接 模式开关作品、点赞、合集、音乐都能成批抓跨模式自动去重。SQLite 去重 增量下载数据库记录已下载的作品下次只拉新增重跑不浪费流量。另有两件事值得知道翻页被风控时会启动浏览器兜底、支持人工过验证码如果你更喜欢图形界面同一套后端还出了桌面版Douzy本文聚焦命令行。 能力分层地图基础 / 进阶 / 整合与其逐条念功能不如按上手路径分成三层。每层你只需要记住一件事这一层帮你解决什么。基础层把内容可靠地存下来解决的是下载本身单条视频/图文/合集/音乐、短链自动解析v.douyin.com这类、并发下载默认 5 线程、指数退避重试、Content-Length 完整性校验下坏的文件自动清理重下。这一层你几乎不用操心配置里保持database: true即可。进阶层把下载变成可重复的流程解决的是反复下载与精细控制增量下载只抓新作品、时间过滤只下某段时间的内容、命名模板{date}_{title}_{id}让文件永远有序、评论采集输出结构化 JSON、可选的视频转写调 OpenAI 接口生成文字稿。桌面版任务中心示意同一套后端任务进度、失败重试、输出目录都可视化管理整合层把工具接进你的工作流解决的是和外部系统打交道登录账号收藏夹备份collect/collectmix模式、完成后推送Bark / Telegram / Webhook 通知、热搜榜与关键词搜索导出 JSONL 快照、REST API 服务模式后面单讲。关注管理示意同步博主列表、筛选新作品适合长期跟踪的账号库模块想深挖的话核心下载逻辑在 core/去重与记录在 storage/限流与重试在 control/配置解析在 config/。⚡ 最小可运行路径四步跑通第一个下载目标很明确从拿到项目到第一条视频落盘不超过四步。第 1 步拿到项目并装依赖。这一步是把代码和 Python 依赖准备好git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt跑通后预期终端无报错run.py能执行--version。第 2 步复制配置模板。这一步生成你自己的config.yml模板里有全部字段的注释cp config.example.yml config.yml跑通后预期项目根目录多了一个可编辑的config.yml。第 3 步自动获取 Cookie。抖音接口需要登录态这一步会弹出浏览器你扫码登录后回终端按 Enter程序自动把 Cookie 写进配置pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml跑通后预期config.yml的 cookies 段被自动填充无需手抄。第 4 步下载第一条视频。把config.yml里的link换成一条视频链接然后运行link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/python run.py -c config.yml跑通后预期进度条走完./Downloaded/下出现作品文件夹里面是无水印视频默认只存视频本体封面、原声、JSON 由下面几个开关按需打开。到这里环境就算打通了。后面所有场景都只是改config.yml里的几个字段。️ 按需深入六个高频场景卡以下卡片互相独立可以跳读。每张卡只回答三件事什么情况下用、改哪里、得到什么。单条快速测试适用刚配完环境先验证链路。关键配置link填视频链接即可其余不动。效果一个文件夹里一个无水印视频用来确认 Cookie、网络、路径都没问题。博主主页批量下载适用想存下某创作者的全部作品。关键配置link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0 # 0 表示不限量全部下载效果该博主作品按命名模板逐个落盘。为什么填 0number.post是数量上限填具体数字就是只下最新 N 条这是控制下载规模的唯一阀门。定时增量同步适用关注某个持续更新的账号想只补新内容。关键配置increase: post: true database: true # 增量依赖数据库记录必须开效果已下载过的作品直接跳过第二次运行只拉新增。注意database一旦关掉去重和增量都会失效相当于每次全量重下。时间区间过滤适用只要某段时间的内容比如最近一个月。关键配置start_time: 2026-08-15 end_time: 2026-09-15效果区间外的作品直接不参与下载省流量也省时间。这两个字段留空字符串即不启用过滤。直播录制适用想留住一场直播。关键配置link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 一直录到主播下播效果录到的 FLV 保存在作者目录的live/下附带直播间元数据快照。关键设计是中断安全下播、断网甚至 CtrlC已录制的字节都会保留不会白录。收藏夹备份与评论采集适用备份自己的收藏、或者做内容分析要评论数据。关键配置comments: enabled: true include_replies: false # true 会多拉二级回复请求量明显变大 max_comments: 500 # 0 不限效果每个媒体文件旁生成一个*_comments.json结构化可直接喂给分析脚本。收藏夹模式用mode: [collect]当前登录账号自己的收藏且不能和其他模式混用。 问题排查手册按现象对号入座现象403 / 未登录错误判断依据日志里反复出现 403 或登录态失效几乎一定是 Cookie 过期有效期通常几天到两周平台策略波动。解决重跑python -m tools.cookie_fetcher --config config.yml即可建议养成每周更新一次的习惯服务器无图形界面时可手动从浏览器复制 Cookie 填进配置。现象只抓到 20 条就停判断依据这是翻页触发风控的典型症状——第一页之后 API 拒绝继续。解决确认兜底开关打开出现验证码弹窗后手动完成验证再关窗口browser_fallback: enabled: true headless: false浏览器兜底目前对post模式验证最完整like/mix/music主要依赖 API 正常分页。现象文件下了一半或损坏判断依据任务日志里有重试记录或本地文件明显偏小。解决完整性校验Content-Length 比对默认就开着坏文件会自动清理并重下。如果大面积出现先把thread从 5 调到 2~3并检查网络是否稳定——慢不一定是工具的错。现象批量下载时机器吃紧判断依据内存或带宽占用明显偏高。解决降线程数、用number分批每次 50~100 条、预留 50GB 以上磁盘。另外记住三个老手习惯命名模板里必须包含{id}避免重名覆盖、重度使用把author_dir设成nickname_uid昵称重名会合并、改名会分裂加 sec_uid 一劳永逸、增量任务保持database: true。 生态与集成把它变成基础设施REST API 服务模式适合嵌进其他系统或定时任务pip install fastapi uvicorn python run.py --serve --serve-port 8000跑通后预期服务监听 8000 端口。四个接口各司其职POST /api/v1/download提交任务传{url: ...}拿job_id、GET /api/v1/jobs/{job_id}查状态、GET /api/v1/jobs列最近任务、GET /api/v1/health健康探针。任务服务实现在 server/完成态任务按 TTL 容量自动清理不会无限堆积。Docker 部署适合放服务器上无人值守docker build -t douyin-downloader . docker run -v $(pwd)/config.yml:/app/config.yml \ -v $(pwd)/Downloaded:/app/Downloaded douyin-downloader跑通后预期容器内按同一份config.yml执行产物直接落到你挂载的本地目录宿主机不装 Python 也能跑。二次开发方向代码按职责分包边界清楚改动前先看对应目录下载策略 core/视频/音乐/直播/合集各有独立 downloader新增下载类型照 core/downloader_factory.py 注册即可、认证 auth/、队列与限流 control/、存储 storage/。配套测试在 tests/pytest tests/能直接验证你的改动没破坏既有行为。 行动收尾价值一句话把手动一个个保存变成一条链接、一次配置、批量落盘而且去重、重试、校验全都替你做了。下一步就三件事克隆仓库按最小可运行路径四步跑通第一条视频换成一个博主主页链接把number.post填 0体验第一次批量下载打开increase和database让它变成可以每周重跑的同步任务。核心优势清单免费开源无水印、自动选最高码率视频 / 图文 / 合集 / 音乐 / 直播 / 收藏夹全类型覆盖SQLite 双重去重 增量下载重跑不浪费浏览器兜底应对翻页风控中断安全命名模板、时间过滤、评论采集、转写等精细化控制REST API Docker能接进任何自动化链路配置、代码、图片都开源可查遇到问题先看上面那张现象对照表。现在就可以打开终端把第一条视频存下来。【免费下载链接】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），仅供参考