抖音下载工具完整上手指南5分钟跑通下载流程视频、合集、音乐、直播一次打包【免费下载链接】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是一款免费、可本地部署的抖音下载工具它把复制链接→去水印→批量归档→历史管理整条链路浓缩成一条命令。本文用问题解决的方式带你从零上手先跑通一次最小下载再按自己的场景定制配置最后给出避坑清单与合规建议。一、先讲一个真实的故事你的收藏夹还好吗某个周五晚上你想把一位博主近半年的视频存下来慢慢看。于是你打开手机一条条复制分享链接再逐个粘贴到网页解析工具里。三十分钟后你得到的结果是视频带着作者水印清晰度被压缩过个别工具跳转广告页面链接被二次解析后才给下载想按作者归档自己手动建文件夹、手动改名想存评论、存封面、存背景音乐想都别想。如果你经历过其中任何一条说明你缺的不是一个解析网页而是一套本地的、可批量、可重复执行的内容归档流程。这正是 douyin-downloader 想解决的问题。二、一句话定义它是什么为谁而造douyin-downloader 是一个面向本地文件归档的抖音内容下载工具你交给它一个链接或一个作者主页它负责抓取、去水印、选最高画质、整理目录、记录历史并把结果落进你硬盘上的结构化文件夹里。它不是在线服务而是一个跑在你本机的 Python 程序所有数据包括你的 Cookie、下载记录、文件本身都留在你自己的机器上。它适合这几类人人群典型诉求个人收藏党把喜欢的作品存成无水印原画随时离线回看内容创作者收集竞品选题、拆解爆款结构建立素材库研究者/编辑批量抓取评论区、热搜榜做内容与舆情分析自动化玩家用 REST API、定时任务把下载接入自己的工作流三、和在线解析站 / 手动录屏相比差在哪先别急着装用一张对比表说清楚它和常见替代方案的差异对比维度在线解析网站手机录屏douyin-downloader水印处理视网站而定一定有自动优先无水印源画质选择固定档位屏幕分辨率按码率自动选最高批量能力一条条来手动作者主页/合集全量抓取元数据无无保存 JSON、封面、头像、音乐、评论去重与增量无无SQLite 本地文件双重去重失败处理断了重来手动补录指数退避重试 完整性校验隐私链接上传到第三方本地全程本地Cookie 不离开本机一句话在线解析站适合偶尔存一条douyin-downloader 适合系统性、长期地管理你的抖音内容库。四、最小可用5 分钟完成第一次下载按下面四步走你可以在一刻钟内看到第一批文件落盘。第 1 步准备环境并拉取代码项目要求 Python 3.8Windows / macOS / Linux 均可。先把仓库克隆到本地git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt如果之后需要浏览器兜底或自动获取 Cookie 的附加能力再补装一次 Playwrightpip install playwright python -m playwright install chromium第 2 步复制配置文件cp config.example.yml config.yml第 3 步写入你的 Cookie推荐自动方式抖音的大部分接口需要登录态。项目提供了引导式获取工具会弹出浏览器带你走完登录流程python -m tools.cookie_fetcher --config config.yml登录完成后回到终端按一下回车程序会把 Cookie 自动写进配置全程不需要你手工复制粘贴。第 4 步运行并验收先拿一条视频链接做冒烟测试python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538运行结束你会在Downloaded/下看到类似下面的结构作者目录 → 作品文件夹 → 视频、封面、音乐、JSON 元数据各归其位。命令行版单作品下载统计成功数量、耗时与保存路径已有文件自动跳过如果这一步顺利说明环境、Cookie、网络三条链路全部打通接下来可以放心进入定制阶段。五、把 config.yml 当成你的下载配方config.yml 是整个工具的大脑。建议按下面四个模块理解它而不是照抄整份文件。① 喂什么link 与 modelink决定下载什么mode决定以什么身份抓取link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 作者主页 - https://www.douyin.com/collection/7341234567890123456 # 单个合集 mode: - post # 作者发布的作品 - mix # 作者的所有合集工具能识别的链接类型包括单条视频/video/{id}、图文/note/{id}、合集/collection/{id}、音乐/music/{id}、直播live.douyin.com/{房间号}以及v.douyin.com这类短链会自动解析到真实地址。② 要多少number 与 increasenumber: post: 50 # 只下最近 50 条0 表示全量 like: 0 # 喜欢的作品0 全量 increase: post: true # 增量模式只下载数据库里没有的新作品配合database: true增量模式会让你的每周备份一次任务只拉新内容而不是重复搬整个主页。③ 存成什么样文件组织工具默认按作者目录 → 作品子目录 → 媒体文件三层归档命名模板里的变量可以自由组合folderstyle: true # 每个作品独立子目录 author_dir: nickname_uid # 作者目录用昵称_用户ID防重名合并 filename_template: {date}_{title}_{id} # 文件名日期_标题_作品ID folder_template: {date}_{title}_{id} # 子目录同名可用变量包括{id}、{title}、{author}、{date}、{year}、{month}、{day}、{type}、{mode}等。模板里务必保留{id}否则不同作品可能互相覆盖。下载后自动按时间与标题生成作品文件夹视频、封面、音乐一目了然④ 稳不稳并发、重试与代理thread: 5 # 并发下载数网络不稳时可降到 2~3 retry_times: 3 # 失败重试次数指数退避 1s/2s/5s proxy: http://127.0.0.1:7890 # 有代理就填API 与媒体下载共用 progress: quiet_logs: true # 精简进度日志避免刷屏工具内置了下载完整性校验会用Content-Length比对文件大小不完整的文件会被自动清理并重试从源头避免下了一半的坏视频。六、三种人群的典型玩法内容创作者建一个爆款拆解库把 5~10 个对标账号的主页链接放进link开启post mix模式并加上评论采集link: - https://www.douyin.com/user/MS4wLjABAAAAaaaa - https://www.douyin.com/user/MS4wLjABAAAAbbbb mode: [post, mix] comments: enabled: true # 顺带抓评论 include_replies: false # 二级回复会成倍增加请求先关掉 max_comments: 500每个作品都会多出一份*_comments.json配合 JSON 元数据里的点赞数、转发数你能快速做出一张什么选题在涨、评论区在聊什么的统计表。研究者与编辑热搜、搜索与语音转写不依赖具体博主直接面向全站内容做采集# 抓取热搜榜前 30 条导出 JSONL python run.py --hot-board 30 -p ./Downloaded # 按关键词搜索作品最多 100 条 python run.py --search 咖啡 --search-max 100 -p ./Downloaded结果会落在Downloaded/hot_board/和Downloaded/search/下带时间戳的 JSONL 文件非常适合二次分析。如果还想要视频的逐字稿打开语音转写开关transcript: enabled: true model: gpt-4o-mini-transcribe response_formats: [txt, json]记得先export OPENAI_API_KEYsk-xxx转写结果会生成.transcript.txt和.transcript.json两个文件。普通用户收藏夹、增量与推送提醒自己登录账号的收藏夹也能整批搬走配合增量下载和完成通知日常维护几乎零成本link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: [collect] # 注意collect 模式必须单独使用 increase: post: true notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY下载完成后Bark、Telegram 或 Webhook 会给你推送一条消息——晚上挂机跑早上起来收通知即可。如果更习惯图形界面项目还提供同源的桌面版内测中粘贴链接即刻开始任务状态可视化跟踪。同源桌面版粘贴链接即可识别作品类型并配置下载内容适合不习惯命令行的人七、一个完整实战把一位博主的一整年作品搬回家假设目标很明确备份美食博主老碗一年内的全部作品含评论以后每次运行只补新增。完整流程如下。① 写配置link: - https://www.douyin.com/user/MS4wLjABAAAAlaowan path: ./Downloaded/ mode: - post number: post: 0 # 全量 start_time: 2025-01-01 # 只取今年以来的作品 end_time: thread: 3 # 低调一点避免触发风控 retry_times: 5 folderstyle: true author_dir: nickname_uid filename_template: {date}_{title}_{id} database: true database_path: dy_downloader.db comments: enabled: true max_comments: 200 increase: post: true # 下次运行只补新增② 执行python run.py -c config.yml启动后你会看到 Rich 进度条逐条推进每条作品经历解析→去重判断→下载→校验四个阶段。批量下载时逐条显示进度条右侧 100% 表示该作品已完整落盘③ 验收与二次运行结束后打开Downloaded/老碗_MS4wLjABAAAAlaowan/post/每个作品一个文件夹mp4、封面、音乐、_data.json、_comments.json齐全。想知道下载历史直接查 SQLitesqlite3 dy_downloader.db SELECT aweme_id, title, datetime(download_time,unixepoch,localtime) FROM aweme ORDER BY download_time DESC LIMIT 20;一周后再跑同一条命令增量模式会跳过已有记录只把新作品搬回来。整条链路就此闭环。桌面版的作品档案所有下载记录都沉淀在 SQLite 中可按作者、关键词、时间范围筛选八、进阶能力直播、API 与自动化直播录制实验性把链接指向直播间工具会解析直播流并录制为 FLVlink: - https://live.douyin.com/273940655995 live: max_duration_seconds: 0 # 0 录到主播下播 idle_timeout_seconds: 30 # 空闲 30 秒视为结束录制文件保存在Downloaded/{作者}/live/下附一份*_room.json直播间元数据。主播下播、网络中断或手动 CtrlC已录制的字节都会被保留不会白录一场。直播录制解析直播间信息后选择清晰度生成 FLV 流地址并保留房间元数据REST API 服务模式想让其他程序来驱动下载一条命令启动 API 服务pip install fastapi uvicorn python run.py --serve --serve-port 8000接口作用POST /api/v1/download提交{url: ...}返回 job_idGET /api/v1/jobs/{job_id}查询任务状态与计数GET /api/v1/jobs列出最近任务GET /api/v1/health健康探针完成态的任务会自动按 TTL默认 24 小时和数量上限默认 500 条清理进行中的任务永不误删。这为内部工具台、网页按钮、机器人指令等集成方式留好了入口。定时任务与容器化Linux/macOS 用 crontab 把每日凌晨 2 点跑增量下载变成例行公事0 2 * * * cd /path/to/douyin-downloader/douyin-downloader python run.py -c config.yml服务器环境则可以直接走 Dockerdocker build -t douyin-downloader . docker run -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/Downloaded:/app/Downloaded douyin-downloader九、避坑清单翻车现场与对策现象原因对策作者主页只抓到 20 条就停翻页被风控拦截开启browser_fallback.enabled: true、headless: false弹窗出现后手动过验证码再关闭提示 Cookie 失效登录态过期重跑python -m tools.cookie_fetcher --config config.yml刷新想重新下载某个作品数据库与文件双重去重生效同时删除该作品本地文件夹与aweme表中对应记录见 README 的重新下载章节没有生成转写文件多种原因叠加依次检查transcript.enabled、是否视频作品、OPENAI_API_KEY是否有效、response_formats是否含txt评论采集特别慢二级回复请求量翻倍关闭include_replies或调低max_commentscollect模式与其他模式冲突设计约束collect/collectmix必须单独使用不要与post/like混写直播 HLS 源只有 playlist 文件HLS 需后处理用 ffmpeg 将 playlist 转成 mp4FLV 源则可直接播放进度条刷屏看不清日志太吵默认开启progress.quiet_logs: true调试时再加-v更完整的配置项与限制说明可查阅项目内的README.zh-CN.md与config.example.yml注释两者都写得非常详细。十、行动清单与使用边界如果你决定试试建议按这个顺序推进先跑通单视频验证环境与 Cookie感受默认的文件结构再试作者主页从number.post: 10起步确认批量与去重符合预期然后定制命名把filename_template和author_dir调成自己舒服的格式最后上自动化开启增量、通知推送必要时接入定时任务或 API定期维护每周检查一次 Cookie 有效性避免任务静默失败。最后是必须说清的使用边界。douyin-downloader 定位为个人学习、研究与数据管理工具请在合法合规的前提下使用不用于侵犯他人隐私、版权或其他合法权益不用于任何违法违规用途。平台规则与接口策略随时可能调整功能失效属于正常技术风险请理性看待。尊重内容创作者的劳动成果是你长期、安心使用这类工具的前提。现在克隆仓库、配好 Cookie、跑通第一条命令把想存却存不下的烦恼交给工具把时间省下来留给真正重要的事情吧。【免费下载链接】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），仅供参考 抖音下载工具完整上手指南：5分钟跑通下载流程，视频、合集、音乐、直播一次打包
抖音下载工具完整上手指南5分钟跑通下载流程视频、合集、音乐、直播一次打包【免费下载链接】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是一款免费、可本地部署的抖音下载工具它把复制链接→去水印→批量归档→历史管理整条链路浓缩成一条命令。本文用问题解决的方式带你从零上手先跑通一次最小下载再按自己的场景定制配置最后给出避坑清单与合规建议。一、先讲一个真实的故事你的收藏夹还好吗某个周五晚上你想把一位博主近半年的视频存下来慢慢看。于是你打开手机一条条复制分享链接再逐个粘贴到网页解析工具里。三十分钟后你得到的结果是视频带着作者水印清晰度被压缩过个别工具跳转广告页面链接被二次解析后才给下载想按作者归档自己手动建文件夹、手动改名想存评论、存封面、存背景音乐想都别想。如果你经历过其中任何一条说明你缺的不是一个解析网页而是一套本地的、可批量、可重复执行的内容归档流程。这正是 douyin-downloader 想解决的问题。二、一句话定义它是什么为谁而造douyin-downloader 是一个面向本地文件归档的抖音内容下载工具你交给它一个链接或一个作者主页它负责抓取、去水印、选最高画质、整理目录、记录历史并把结果落进你硬盘上的结构化文件夹里。它不是在线服务而是一个跑在你本机的 Python 程序所有数据包括你的 Cookie、下载记录、文件本身都留在你自己的机器上。它适合这几类人人群典型诉求个人收藏党把喜欢的作品存成无水印原画随时离线回看内容创作者收集竞品选题、拆解爆款结构建立素材库研究者/编辑批量抓取评论区、热搜榜做内容与舆情分析自动化玩家用 REST API、定时任务把下载接入自己的工作流三、和在线解析站 / 手动录屏相比差在哪先别急着装用一张对比表说清楚它和常见替代方案的差异对比维度在线解析网站手机录屏douyin-downloader水印处理视网站而定一定有自动优先无水印源画质选择固定档位屏幕分辨率按码率自动选最高批量能力一条条来手动作者主页/合集全量抓取元数据无无保存 JSON、封面、头像、音乐、评论去重与增量无无SQLite 本地文件双重去重失败处理断了重来手动补录指数退避重试 完整性校验隐私链接上传到第三方本地全程本地Cookie 不离开本机一句话在线解析站适合偶尔存一条douyin-downloader 适合系统性、长期地管理你的抖音内容库。四、最小可用5 分钟完成第一次下载按下面四步走你可以在一刻钟内看到第一批文件落盘。第 1 步准备环境并拉取代码项目要求 Python 3.8Windows / macOS / Linux 均可。先把仓库克隆到本地git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt如果之后需要浏览器兜底或自动获取 Cookie 的附加能力再补装一次 Playwrightpip install playwright python -m playwright install chromium第 2 步复制配置文件cp config.example.yml config.yml第 3 步写入你的 Cookie推荐自动方式抖音的大部分接口需要登录态。项目提供了引导式获取工具会弹出浏览器带你走完登录流程python -m tools.cookie_fetcher --config config.yml登录完成后回到终端按一下回车程序会把 Cookie 自动写进配置全程不需要你手工复制粘贴。第 4 步运行并验收先拿一条视频链接做冒烟测试python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538运行结束你会在Downloaded/下看到类似下面的结构作者目录 → 作品文件夹 → 视频、封面、音乐、JSON 元数据各归其位。命令行版单作品下载统计成功数量、耗时与保存路径已有文件自动跳过如果这一步顺利说明环境、Cookie、网络三条链路全部打通接下来可以放心进入定制阶段。五、把 config.yml 当成你的下载配方config.yml 是整个工具的大脑。建议按下面四个模块理解它而不是照抄整份文件。① 喂什么link 与 modelink决定下载什么mode决定以什么身份抓取link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 作者主页 - https://www.douyin.com/collection/7341234567890123456 # 单个合集 mode: - post # 作者发布的作品 - mix # 作者的所有合集工具能识别的链接类型包括单条视频/video/{id}、图文/note/{id}、合集/collection/{id}、音乐/music/{id}、直播live.douyin.com/{房间号}以及v.douyin.com这类短链会自动解析到真实地址。② 要多少number 与 increasenumber: post: 50 # 只下最近 50 条0 表示全量 like: 0 # 喜欢的作品0 全量 increase: post: true # 增量模式只下载数据库里没有的新作品配合database: true增量模式会让你的每周备份一次任务只拉新内容而不是重复搬整个主页。③ 存成什么样文件组织工具默认按作者目录 → 作品子目录 → 媒体文件三层归档命名模板里的变量可以自由组合folderstyle: true # 每个作品独立子目录 author_dir: nickname_uid # 作者目录用昵称_用户ID防重名合并 filename_template: {date}_{title}_{id} # 文件名日期_标题_作品ID folder_template: {date}_{title}_{id} # 子目录同名可用变量包括{id}、{title}、{author}、{date}、{year}、{month}、{day}、{type}、{mode}等。模板里务必保留{id}否则不同作品可能互相覆盖。下载后自动按时间与标题生成作品文件夹视频、封面、音乐一目了然④ 稳不稳并发、重试与代理thread: 5 # 并发下载数网络不稳时可降到 2~3 retry_times: 3 # 失败重试次数指数退避 1s/2s/5s proxy: http://127.0.0.1:7890 # 有代理就填API 与媒体下载共用 progress: quiet_logs: true # 精简进度日志避免刷屏工具内置了下载完整性校验会用Content-Length比对文件大小不完整的文件会被自动清理并重试从源头避免下了一半的坏视频。六、三种人群的典型玩法内容创作者建一个爆款拆解库把 5~10 个对标账号的主页链接放进link开启post mix模式并加上评论采集link: - https://www.douyin.com/user/MS4wLjABAAAAaaaa - https://www.douyin.com/user/MS4wLjABAAAAbbbb mode: [post, mix] comments: enabled: true # 顺带抓评论 include_replies: false # 二级回复会成倍增加请求先关掉 max_comments: 500每个作品都会多出一份*_comments.json配合 JSON 元数据里的点赞数、转发数你能快速做出一张什么选题在涨、评论区在聊什么的统计表。研究者与编辑热搜、搜索与语音转写不依赖具体博主直接面向全站内容做采集# 抓取热搜榜前 30 条导出 JSONL python run.py --hot-board 30 -p ./Downloaded # 按关键词搜索作品最多 100 条 python run.py --search 咖啡 --search-max 100 -p ./Downloaded结果会落在Downloaded/hot_board/和Downloaded/search/下带时间戳的 JSONL 文件非常适合二次分析。如果还想要视频的逐字稿打开语音转写开关transcript: enabled: true model: gpt-4o-mini-transcribe response_formats: [txt, json]记得先export OPENAI_API_KEYsk-xxx转写结果会生成.transcript.txt和.transcript.json两个文件。普通用户收藏夹、增量与推送提醒自己登录账号的收藏夹也能整批搬走配合增量下载和完成通知日常维护几乎零成本link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: [collect] # 注意collect 模式必须单独使用 increase: post: true notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY下载完成后Bark、Telegram 或 Webhook 会给你推送一条消息——晚上挂机跑早上起来收通知即可。如果更习惯图形界面项目还提供同源的桌面版内测中粘贴链接即刻开始任务状态可视化跟踪。同源桌面版粘贴链接即可识别作品类型并配置下载内容适合不习惯命令行的人七、一个完整实战把一位博主的一整年作品搬回家假设目标很明确备份美食博主老碗一年内的全部作品含评论以后每次运行只补新增。完整流程如下。① 写配置link: - https://www.douyin.com/user/MS4wLjABAAAAlaowan path: ./Downloaded/ mode: - post number: post: 0 # 全量 start_time: 2025-01-01 # 只取今年以来的作品 end_time: thread: 3 # 低调一点避免触发风控 retry_times: 5 folderstyle: true author_dir: nickname_uid filename_template: {date}_{title}_{id} database: true database_path: dy_downloader.db comments: enabled: true max_comments: 200 increase: post: true # 下次运行只补新增② 执行python run.py -c config.yml启动后你会看到 Rich 进度条逐条推进每条作品经历解析→去重判断→下载→校验四个阶段。批量下载时逐条显示进度条右侧 100% 表示该作品已完整落盘③ 验收与二次运行结束后打开Downloaded/老碗_MS4wLjABAAAAlaowan/post/每个作品一个文件夹mp4、封面、音乐、_data.json、_comments.json齐全。想知道下载历史直接查 SQLitesqlite3 dy_downloader.db SELECT aweme_id, title, datetime(download_time,unixepoch,localtime) FROM aweme ORDER BY download_time DESC LIMIT 20;一周后再跑同一条命令增量模式会跳过已有记录只把新作品搬回来。整条链路就此闭环。桌面版的作品档案所有下载记录都沉淀在 SQLite 中可按作者、关键词、时间范围筛选八、进阶能力直播、API 与自动化直播录制实验性把链接指向直播间工具会解析直播流并录制为 FLVlink: - https://live.douyin.com/273940655995 live: max_duration_seconds: 0 # 0 录到主播下播 idle_timeout_seconds: 30 # 空闲 30 秒视为结束录制文件保存在Downloaded/{作者}/live/下附一份*_room.json直播间元数据。主播下播、网络中断或手动 CtrlC已录制的字节都会被保留不会白录一场。直播录制解析直播间信息后选择清晰度生成 FLV 流地址并保留房间元数据REST API 服务模式想让其他程序来驱动下载一条命令启动 API 服务pip install fastapi uvicorn python run.py --serve --serve-port 8000接口作用POST /api/v1/download提交{url: ...}返回 job_idGET /api/v1/jobs/{job_id}查询任务状态与计数GET /api/v1/jobs列出最近任务GET /api/v1/health健康探针完成态的任务会自动按 TTL默认 24 小时和数量上限默认 500 条清理进行中的任务永不误删。这为内部工具台、网页按钮、机器人指令等集成方式留好了入口。定时任务与容器化Linux/macOS 用 crontab 把每日凌晨 2 点跑增量下载变成例行公事0 2 * * * cd /path/to/douyin-downloader/douyin-downloader python run.py -c config.yml服务器环境则可以直接走 Dockerdocker build -t douyin-downloader . docker run -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/Downloaded:/app/Downloaded douyin-downloader九、避坑清单翻车现场与对策现象原因对策作者主页只抓到 20 条就停翻页被风控拦截开启browser_fallback.enabled: true、headless: false弹窗出现后手动过验证码再关闭提示 Cookie 失效登录态过期重跑python -m tools.cookie_fetcher --config config.yml刷新想重新下载某个作品数据库与文件双重去重生效同时删除该作品本地文件夹与aweme表中对应记录见 README 的重新下载章节没有生成转写文件多种原因叠加依次检查transcript.enabled、是否视频作品、OPENAI_API_KEY是否有效、response_formats是否含txt评论采集特别慢二级回复请求量翻倍关闭include_replies或调低max_commentscollect模式与其他模式冲突设计约束collect/collectmix必须单独使用不要与post/like混写直播 HLS 源只有 playlist 文件HLS 需后处理用 ffmpeg 将 playlist 转成 mp4FLV 源则可直接播放进度条刷屏看不清日志太吵默认开启progress.quiet_logs: true调试时再加-v更完整的配置项与限制说明可查阅项目内的README.zh-CN.md与config.example.yml注释两者都写得非常详细。十、行动清单与使用边界如果你决定试试建议按这个顺序推进先跑通单视频验证环境与 Cookie感受默认的文件结构再试作者主页从number.post: 10起步确认批量与去重符合预期然后定制命名把filename_template和author_dir调成自己舒服的格式最后上自动化开启增量、通知推送必要时接入定时任务或 API定期维护每周检查一次 Cookie 有效性避免任务静默失败。最后是必须说清的使用边界。douyin-downloader 定位为个人学习、研究与数据管理工具请在合法合规的前提下使用不用于侵犯他人隐私、版权或其他合法权益不用于任何违法违规用途。平台规则与接口策略随时可能调整功能失效属于正常技术风险请理性看待。尊重内容创作者的劳动成果是你长期、安心使用这类工具的前提。现在克隆仓库、配好 Cookie、跑通第一条命令把想存却存不下的烦恼交给工具把时间省下来留给真正重要的事情吧。【免费下载链接】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），仅供参考