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 是一个 Python 编写的抖音下载工具支持无水印下载视频、图文、合集与原声音乐也能按博主主页链接批量抓取其发布作品内置进度展示、失败重试和 SQLite 去重。它适合两类人只想保存少量作品的个人用户以及需要长期归档博主内容、反复采集素材的内容工作者。它如何工作从一条链接到本地文件整个流程可以拆成输入、处理、输出三步输入下载目标有三种给法——写在config.yml的link列表里、用命令行-u参数临时追加、或在桌面版界面里直接粘贴。支持单条视频、图文、合集、音乐链接、v.douyin.com短链和用户主页链接。处理程序先解析链接、识别内容类型再分派给对应的下载器。媒体源默认选无水印地址并按码率自动挑最高清档位下载按thread配置并发默认 5限速 2 请求/秒失败按 1s、2s、5s 指数退避重试默认 3 次每个作品会先查 SQLite 记录和本地文件名已下载过的直接跳过保证可重复运行。输出文件落到Downloaded/下按作者/模式/作品组织的目录附带 JSON 元数据并汇总一份download_manifest.jsonl。如何开始安装、Cookie 与首次运行安装依赖并复制配置先克隆代码仓库地址https://gitcode.com/GitHub_Trending/do/douyin-downloader进入项目目录后执行pip install -r requirements.txt pip install playwright python -m playwright install chromium cp config.example.yml config.yml后三行安装的是浏览器环境自动获取 Cookie 和浏览器兜底翻页都依赖它建议新手直接装。获取 Cookie为什么要做这一步Cookie 是程序访问抖音接口的身份凭证相当于已登录状态。没有它批量抓取主页作品会被风控直接拒绝。工具提供自动获取方式命令会弹出浏览器你扫码登录抖音然后回终端按 EnterCookie 会自动写入config.yml。python -m tools.cookie_fetcher --config config.yml改三处配置并首次运行打开config.yml只需关心三处link要下载什么、path存到哪里、number.post下载多少条0表示不限。然后python run.py -c config.yml \ -u https://www.douyin.com/user/MS4wLjABAAAAxxxx \ -t 5 -p ./Downloaded-u是追加链接可多次传入-t是并发数-p是保存目录。命令行参数会覆盖配置文件中的同名项方便临时试跑。如何选下载模式先定目标再填配置主页批量下载由mode字段决定常用模式如下模式下载内容备注post博主发布的主页作品最常用的批量模式mix博主的合集作品可多选music博主音乐列表对应的原声可多选like博主点赞过的作品可多选collect/collectmix当前登录账号的收藏夹 / 收藏合集仅支持自己登录的账号且必须单独使用几个配套开关number.X每种模式的数量上限0为全量。increase.X: true增量模式只下载新作品依赖database: true。start_time/end_time按YYYY-MM-DD限定作品发布时间范围。video_qualityoriginal探测上传原片、highest最高转码档默认、或指定1080p等分辨率。哪些类型现在要改用桌面版 一个需要知道的事实抖音在 2026-08 和 2026-09 两次升级风控后CLI 直连 API 的方式已被拦截——点赞、收藏夹、收藏合集无法下载单个视频/图文、合集、音乐的接口调用也已不可用。也就是说纯命令行目前最稳的主页批量路径是post模式并且建议保持browser_fallback.enabled: true、headless: false翻页被限制时程序会启动浏览器由页面自己发出请求你只需在弹窗里完成一次验证码。如果需要下载上述被拦截的类型或想要图形化操作项目方提供了基于同一套后端的桌面版 Douzy目前内测中可从项目 Releases 页面获取安装包。它通过内置登录窗口代发请求不受该风控影响支持链接粘贴下载、多链接队列、任务状态跟踪与本地作品档案任务中心里可以看到每个批量下载任务的成功数、失败数和重试运行入口下载完成后文件在哪里启用folderstyle: true默认时Downloaded/下的结构大致如下Downloaded/download_manifest.jsonl本次所有作品的汇总清单dy_downloader.dbSQLite 去重与历史记录数据库作者昵称/post/like/、mix/、music/、collect/同理按模式分目录2024-02-07_作品标题_aweme_id/每个作品一个独立文件夹目录名含作品 ID天然避免重名覆盖视频文件.mp4无水印*_cover.jpg封面配置cover: true时*_music.mp3原声配置music: true时*_data.json元数据配置json: true时含标题、发布时间、点赞数等*_comments.json评论配置comments.enabled: true时下载过程中若出现文件不完整的情况程序会比对 Content-Length 自动清理残缺文件并重试不需要手动善后。6 个最容易卡住的问题只抓到 20 条作品就停了这是翻页触发风控的典型现象。确认browser_fallback.enabled: true、headless: false浏览器弹出后手动完成验证不要立刻关闭窗口。提示 Cookie 失效或登录过期重新执行python -m tools.cookie_fetcher --config config.yml扫码刷新即可配置会自动更新。为什么重复运行不会重复下载程序用数据库记录加本地文件名双重去重。想强制重下某个作品要同时删掉它的本地文件夹和数据库记录sqlite3 dy_downloader.db中DELETE FROM aweme WHERE aweme_id ...只删其中一处不生效。画质不是最清晰的检查video_quality。默认highest只从转码档里挑想要上传原片改成original代价是每条作品多一次探测请求。只想下几条试试把number.post设成 1 或 5 先跑通流程想只拿某个时间段的作品配合start_time/end_time。不下载视频只想要作品数据用--search 关键词或--hot-board 30命令结果以 JSONL 文件形式落在Downloaded/search/或Downloaded/hot_board/适合做数据收集。下一步行动先把number.post改为 1完整跑通配置 → Cookie → 下载流程确认Downloaded/里生成了预期文件。跑通后再放开数量打开json: true和cover: true把元数据和封面一起留存。若要长期跟踪某位博主开启increase.post: true之后定期重跑同一命令即可只拉新作品。【免费下载链接】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），仅供参考