2026/9/20 18:32:50
FEATURED · 精选文章 
抖音下载器 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 是一个免费开源的抖音下载器支持视频、图集、合集、音乐原声与直播内容的下载默认选择无水印视频源并内置进度展示、失败重试、SQLite 去重与浏览器兜底能力。它适合两类人想保存单个作品的普通用户以及需要批量归档创作者主页内容的研究者或备份型用户。下文按装环境、配 Cookie、选用法的顺序展开全部命令与配置项均来自仓库真实内容。一、项目速览它是什么、能做什么结论一个 YAML 配置文件加一条命令即可运行核心能力如下。单条下载/video/、/note/图文、/collection/合集、/music/原声链接短链v.douyin.com自动解析用户主页下载/user/{sec_uid}主页批量抓取支持post发布、like点赞、mix合集、music四种模式直播能力live.douyin.com直播间录制FLV/HLS主播下播时已录数据保留工程能力无水印优先、自动挑选最高码率、并发下载默认 5 线程、指数退避重试、SQLite 数据库加本地文件双重去重项目采用 Python 编写3.8macOS/Linux/Windows 均支持入口是run.py核心逻辑集中在core/下载主流程与 URL 解析和storage/文件与数据库另有现成 Dockerfile 可用于容器部署。二、安装与环境准备Python 3.8 环境直接克隆并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt把示例配置复制为工作配置cp config.example.yml config.yml如果希望启用浏览器兜底或自动获取 Cookie推荐再装一次可选依赖pip install playwright python -m playwright install chromium三、Cookie 配置为什么必须、怎么获取抖音的作品数据接口需要登录态CLI 不是浏览器页面、无法自带安全签名因此 Cookie 是唯一的鉴权凭证没有它基本功能都不可用。获取方式有两种自动获取推荐。运行下面命令后会弹出 Chromium 窗口你在里面登录抖音回到终端按 Enter程序自动把 Cookie 写入配置python -m tools.cookie_fetcher --config config.yml手动获取。用浏览器登录 www.douyin.com按 F12 打开开发者工具从请求头里复制 Cookie 串粘贴到config.yml的cookies段。注意至少需要包含msToken、ttwid、odin_tt、passport_csrf_token四项缺少任一项都可能导致翻页受限。Cookie 有有效期失效后重跑第一条命令即可无需改代码。四、按需求选择用法单条链接 / 主页批量 / 直播回放单条链接下载把任意一条视频、图文、合集或音乐链接填进link字段然后运行python run.py -c config.yml也可以在命令行直接追加链接、目录和并发数python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538 -p ./Downloaded -t 8批量下载用户主页作品主页下载的关键是两个配置mode决定抓哪类列表number决定数量上限0 表示全量。以批量下载某创作者的前 50 条发布作品为例config.yml中写link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: - post: 50单条与批量模式的实际差异如下维度单条链接主页批量适用场景保存个别作品一次性使用归档某创作者全部或部分内容必须配置仅link需指定mode与number数量控制不涉及number.post: 50取 50 条0为不限运行方式run.py -u 链接即可run.py -c config.yml跑完整配置去重行为已存在则跳过跨模式自动去重同一条作品不会重复下载直播录制与直播回放下载直播间录制实验性把直播间链接填进link用live段控制时长0 表示录到主播下播。link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600录制结果保存为Downloaded/{作者}/live/下的 FLV 文件附带直播间元数据 JSON网络中断或 CtrlC 时已录字节会保留。直播回放下载将回放分享链接webcast reflow episode 链接写入link程序会解析其中的episode_id拉取回放实现见core/live_replay_downloader.py。五、进阶配置目录组织、时间过滤与自动去重config.yml中几个高频配置项的作用path保存目录默认./Downloaded/video/music/cover/json分别控制视频本体、原声音乐、封面、元数据 JSON 的保存开关start_time/end_time时间过滤格式YYYY-MM-DD只下载该区间内的作品folderstyle: true按作品维度创建子目录目录名含发布日期、标题与作品 IDvideo_quality画质选择highest为默认最高转码档original会额外探测上传原片去重是批量场景的核心。开启database: true后程序用 SQLite 记录默认dy_downloader.db加本地文件名双重检查重复运行会自动跳过已下载内容配合increase.post: true可做增量任务只拉新作品。要强制重下某条作品需要同时删除本地文件与数据库记录只删其中一方不生效。六、常见问题排查Cookie 失效、只能抓到 20 条作品。这是翻页风控的典型现象。确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证码不要立即关闭窗口。若 Cookie 整体失效重跑python -m tools.cookie_fetcher --config config.yml。下载速度慢。把thread调整到 3-5 之间比较稳妥过高的并发更容易触发限速网络环境不佳时可在proxy中配置 HTTP 代理。文件保存失败。依次检查磁盘剩余空间、path目录的写权限并用-v参数打开详细日志定位具体报错。进度刷屏。默认progress.quiet_logs: true已静默进度阶段的日志调试时才需要加--show-warnings或-v。七、合规提醒与下一步建议的进阶路径用 Docker 部署长期任务仓库自带 Dockerfile、开启comments段按作品采集评论、用transcript段做视频转写详见 README.zh-CN.md 与docs/superpowers/下的设计文档。最后提醒下载的内容受版权保护请尊重创作者的劳动成果本工具仅用于个人学习和研究不要将批量下载的内容用于二次分发或商业用途。【免费下载链接】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 是一个免费开源的抖音下载器支持视频、图集、合集、音乐原声与直播内容的下载默认选择无水印视频源并内置进度展示、失败重试、SQLite 去重与浏览器兜底能力。它适合两类人想保存单个作品的普通用户以及需要批量归档创作者主页内容的研究者或备份型用户。下文按装环境、配 Cookie、选用法的顺序展开全部命令与配置项均来自仓库真实内容。一、项目速览它是什么、能做什么结论一个 YAML 配置文件加一条命令即可运行核心能力如下。单条下载/video/、/note/图文、/collection/合集、/music/原声链接短链v.douyin.com自动解析用户主页下载/user/{sec_uid}主页批量抓取支持post发布、like点赞、mix合集、music四种模式直播能力live.douyin.com直播间录制FLV/HLS主播下播时已录数据保留工程能力无水印优先、自动挑选最高码率、并发下载默认 5 线程、指数退避重试、SQLite 数据库加本地文件双重去重项目采用 Python 编写3.8macOS/Linux/Windows 均支持入口是run.py核心逻辑集中在core/下载主流程与 URL 解析和storage/文件与数据库另有现成 Dockerfile 可用于容器部署。二、安装与环境准备Python 3.8 环境直接克隆并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt把示例配置复制为工作配置cp config.example.yml config.yml如果希望启用浏览器兜底或自动获取 Cookie推荐再装一次可选依赖pip install playwright python -m playwright install chromium三、Cookie 配置为什么必须、怎么获取抖音的作品数据接口需要登录态CLI 不是浏览器页面、无法自带安全签名因此 Cookie 是唯一的鉴权凭证没有它基本功能都不可用。获取方式有两种自动获取推荐。运行下面命令后会弹出 Chromium 窗口你在里面登录抖音回到终端按 Enter程序自动把 Cookie 写入配置python -m tools.cookie_fetcher --config config.yml手动获取。用浏览器登录 www.douyin.com按 F12 打开开发者工具从请求头里复制 Cookie 串粘贴到config.yml的cookies段。注意至少需要包含msToken、ttwid、odin_tt、passport_csrf_token四项缺少任一项都可能导致翻页受限。Cookie 有有效期失效后重跑第一条命令即可无需改代码。四、按需求选择用法单条链接 / 主页批量 / 直播回放单条链接下载把任意一条视频、图文、合集或音乐链接填进link字段然后运行python run.py -c config.yml也可以在命令行直接追加链接、目录和并发数python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538 -p ./Downloaded -t 8批量下载用户主页作品主页下载的关键是两个配置mode决定抓哪类列表number决定数量上限0 表示全量。以批量下载某创作者的前 50 条发布作品为例config.yml中写link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: - post: 50单条与批量模式的实际差异如下维度单条链接主页批量适用场景保存个别作品一次性使用归档某创作者全部或部分内容必须配置仅link需指定mode与number数量控制不涉及number.post: 50取 50 条0为不限运行方式run.py -u 链接即可run.py -c config.yml跑完整配置去重行为已存在则跳过跨模式自动去重同一条作品不会重复下载直播录制与直播回放下载直播间录制实验性把直播间链接填进link用live段控制时长0 表示录到主播下播。link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600录制结果保存为Downloaded/{作者}/live/下的 FLV 文件附带直播间元数据 JSON网络中断或 CtrlC 时已录字节会保留。直播回放下载将回放分享链接webcast reflow episode 链接写入link程序会解析其中的episode_id拉取回放实现见core/live_replay_downloader.py。五、进阶配置目录组织、时间过滤与自动去重config.yml中几个高频配置项的作用path保存目录默认./Downloaded/video/music/cover/json分别控制视频本体、原声音乐、封面、元数据 JSON 的保存开关start_time/end_time时间过滤格式YYYY-MM-DD只下载该区间内的作品folderstyle: true按作品维度创建子目录目录名含发布日期、标题与作品 IDvideo_quality画质选择highest为默认最高转码档original会额外探测上传原片去重是批量场景的核心。开启database: true后程序用 SQLite 记录默认dy_downloader.db加本地文件名双重检查重复运行会自动跳过已下载内容配合increase.post: true可做增量任务只拉新作品。要强制重下某条作品需要同时删除本地文件与数据库记录只删其中一方不生效。六、常见问题排查Cookie 失效、只能抓到 20 条作品。这是翻页风控的典型现象。确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证码不要立即关闭窗口。若 Cookie 整体失效重跑python -m tools.cookie_fetcher --config config.yml。下载速度慢。把thread调整到 3-5 之间比较稳妥过高的并发更容易触发限速网络环境不佳时可在proxy中配置 HTTP 代理。文件保存失败。依次检查磁盘剩余空间、path目录的写权限并用-v参数打开详细日志定位具体报错。进度刷屏。默认progress.quiet_logs: true已静默进度阶段的日志调试时才需要加--show-warnings或-v。七、合规提醒与下一步建议的进阶路径用 Docker 部署长期任务仓库自带 Dockerfile、开启comments段按作品采集评论、用transcript段做视频转写详见 README.zh-CN.md 与docs/superpowers/下的设计文档。最后提醒下载的内容受版权保护请尊重创作者的劳动成果本工具仅用于个人学习和研究不要将批量下载的内容用于二次分发或商业用途。【免费下载链接】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），仅供参考 
