抖音批量下载 5 步跑通：douyin-downloader 零基础使用实录

抖音批量下载 5 步跑通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-downloader想把某个博主发布的所有作品无水印备份下来页面只给看前十几条逐条手动右键保存显然不现实。douyin-downloader 是一个 Python 写的抖音批量下载工具支持单链接解析、用户主页批量下载、最高清无水印源自动挑选并内置失败重试、SQLite 去重与浏览器兜底。下面带你从零跑通。 安装与快速上手五步跑通第一次下载克隆代码git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader安装依赖要求 Python 3.9pip install -r requirements.txt需要浏览器兜底或自动取 Cookie 时再补装pip install playwright python -m playwright install chromium。创建配置cp config.example.yml config.yml。获取 Cookie运行python -m tools.cookie_fetcher --config config.yml在弹出的浏览器里登录抖音回终端按 EnterCookie 即自动写入 config.yml。首次运行python run.py -c config.yml。把 config.yml 的link填一个视频链接即可验证链路通畅。️ 常用操作实战按你想做什么组织批量下载用户主页作品在 config.yml 里写目标主页链接、模式与数量link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50 # 0 表示不限运行python run.py -c config.yml作品默认落到Downloaded/作者名/post/每个作品一个文件夹包含无水印 mp4、封面、音乐与元数据 JSON-t 8可临时覆盖并发数-p指定输出目录。增量下载配置只抓新作品追加increase.post: true并保持database: true再次运行同一配置。已入库的作品会被跳过适合长期监控更新频繁的博主。热搜与关键词搜索导出python run.py --hot-board 30 -p ./Downloaded # 热搜前30输出 JSONL python run.py --search 关键词 --search-max 100 # 按关键词搜索作品以 REST API 服务方式运行pip install fastapi uvicorn后运行python run.py --serve --serve-port 8000向/api/v1/downloadPOST 一个 url 即可提交任务再用返回的 job_id 查/api/v1/jobs/{job_id}。⚙️ 关键配置说明常用参数对照表参数作用建议值thread并发下载数5网络不稳调低retry_times失败重试次数指数退避 1s/2s/5s3number.post单主页下载数量0 为不限按需start_time/end_time按日期过滤作品YYYY-MM-DD与增量配合browser_fallback.enabled翻页受限时浏览器兜底truebrowser_fallback.headless浏览器是否无头运行false便于手动过验证码progress.quiet_logs进度阶段静默日志truedatabase/database_pathSQLite 去重与下载历史true / dy_downloader.dbproxyAPI 请求与媒体下载的代理按需填写完整参数说明见 README.zh-CN.md下载与重试的实现位于 core/ 模块方便排查行为。⚠️ 常见问题与避坑只抓到 20 条就停翻页风控的典型表现。确认browser_fallback.enabled: true、headless: false浏览器弹出后手动完成验证别急着关窗口。Cookie 失效重新执行安装步骤里的cookie_fetcher命令即可重新获取。删了文件却不重新下载去重是数据库记录 本地文件双重判断只删数据库记录不会触发重下需同时删除对应文件夹与 aweme_id 对应的数据库记录。单视频/合集/音乐链接报 4032026-09 起抖音 Argus 风控拦截了这类接口的 CLI 直连此类下载需改用配套桌面版 Douzy截图中的任务中心可查看失败原因并重试。进度刷屏默认progress.quiet_logs: true已抑制调试时用-v查看细节。总体来看批量无水印下载、增量监控与数据导出是这套工具最趁手的场景若你的任务集中在已被风控拦截的单链接内容当前 CLI 能力受限建议改用桌面版或等待风控放行。【免费下载链接】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），仅供参考