douyin-downloader 上手指南10 分钟完成抖音批量下载无水印保存全流程【免费下载链接】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 做的事很直接粘一个博主主页链接作品就去水印整批存到本地、按作者分好文件夹。想长期归档创作者内容的人适合它从装依赖到跑通第一次下载10 分钟以内。运行前确认环境Python 3.9 即可需要 Python 3.9Windows、macOS、Linux 三个平台都能跑核心依赖全部列在 requirements.txt 里一条 pip 命令装完Cookie 不用自己翻找字段内置脚本在首次登录时自动写入配置Cookie 自动获取与翻页兜底还依赖 Playwright 拉起的浏览器运行时这张图来自 Douzy 桌面版是同一后端的图形化形态界面里勾选作品、喜欢、合集、音乐设好各模式的数量上限粘上链接就能开始下载完全不用手写 YAML。本文讲的是命令行版底层能力是同一套。第一次下载怎么开始先把代码拉到本地顺手把依赖装齐git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt pip install playwright python -m playwright install chromium最后两条装的是浏览器及其运行时。跑完这组命令后机器上同时具备核心依赖和兜底用的 Chromium少装它们Cookie 自动获取和翻页受限时切换浏览器继续拉的功能都用不了。配置模板就在仓库根目录复制一份出来当实际文件cp config.example.yml config.ymlWindows PowerShell 里换成Copy-Item config.example.yml config.yml就行。每个字段的写法、可选值有哪些翻一遍 config.example.yml 就有答案。拿到配置文件后先取 Cookie 再改参数python -m tools.cookie_fetcher --config config.yml这条命令会弹出一个浏览器窗口登录抖音后回到终端按 Enter脚本就把 Cookie 写进config.yml直到失效前只需做一次。接下来打开配置改四处就够跑link填目标博主的主页链接path: ./Downloaded/定落盘目录mode: [post]表示只拉作品number下的post: 50控制数量写0就是全量拉取。保存后直接运行python run.py -c config.yml启动。终端里会滚动出进度条失败项按retry_times自动重试全部完成后文件就落在Downloaded/里。想看详细日志加-v想在命令行临时追加链接用-u。下载的文件去哪了folderstyle: true是默认值落盘结构是作者目录 / 模式目录 / 作品目录三层Downloaded/ └── 作者昵称/ └── post/ └── 2024-06-15_舞蹈教学_7604129988555574538/ ├── 2024-06-15_舞蹈教学_7604129988555574538.mp4 ├── 2024-06-15_舞蹈教学_7604129988555574538_cover.jpg ├── 2024-06-15_舞蹈教学_7604129988555574538_music.mp3 └── 2024-06-15_舞蹈教学_7604129988555574538_data.json默认只生成视频本体后三个文件要分别打开cover、music、json开关才会出现。文件夹名和文件名都由filename_template渲染默认{date}_{title}_{id}即日期_标题_作品ID。日期取作品发布时间create_time作品缺这个字段时回退成当天日期。模板里为什么非得留着{id}作者发过标题撞车或同一天多条作品时没有 ID 兜底就会互相覆盖。作者那一层默认按昵称建目录副作用有两个重名博主的文件会并进同一个文件夹博主一改名新目录又单独裂出去。想两头都躲开把author_dir设成nickname_uid目录名变为昵称_sec_uid直观且稳定。无水印下载怎么配置最常调的几个参数参数示例写法说明modemode: [post]决定拉什么内容可逐行写多个值numbernumber.post: 50各模式拉取数量0表示全量start_time/end_timestart_time: 2024-01-01时间过滤YYYY-MM-DD格式含结束日当天video_quality默认highest写original会探测上传原片失败自动回退increase.post默认true增量开关跳过已下载的作品thread/proxythread: 3、proxy: 并发数与代理mode一次写多个值时相同 ID 的作品会自动跨模式去重不会重复落盘。collect是例外它必须单独使用链接固定指向https://www.douyin.com/user/self?showTabfavorite_collection且只拉 Cookie 所属账号自己的收藏夹。按需加料四个进阶能力只存新作品增量下载隔三差五回来看同一个作者、又不想重复下载时靠它。increase.post默认就是true每次运行先查数据库和磁盘已记录且文件还在的旧作品直接跳过只下新增内容保持database: true默认已开即可生效。反过来把它设为false会在当前数量与时间筛选范围内重新下载并覆盖旧文件不用清空数据库。连同评论和语音文本一起保存想归档作品下的讨论或者把口播变成文字时加上这段comments: enabled: true # 每个作品额外生成 *_comments.json max_comments: 500 transcript: enabled: true model: gpt-4o-mini-transcribe response_formats: [txt, json]max_comments写0就是不限条数转写只对视频作品生效图文作品不生成转写文件。转写走 OpenAI运行前先把密钥挂到环境变量export OPENAI_API_KEYsk-xxxx。完成后每个视频作品目录里会多出一份.transcript.txt与.transcript.json。翻页被风控时浏览器兜底 ⚠️2026-08 起抖音风控门禁已覆盖多数 CLI 接口拉取量明显变少时把这条路打开browser_fallback: enabled: true headless: false弹窗里出现验证就手动完成别急着关浏览器。这个机制目前只对post主页作品场景完整验证过也不保证一定成功。下完自动收到通知长任务挂着跑、人不在电脑前希望完成时有人知会一声就配通知notifications: enabled: true on_failure: true providers: - type: webhook # 支持 webhook / bark / telegram url: 你的webhook地址各通道并发推送单个 provider 挂了不阻塞主下载流程。webhook 可以直接对接企业微信、飞书、钉钉的群机器人。下载不动先查这五处只拉得到约 20 条作品—— 翻页触发了风控。确认browser_fallback.enabled: true且headless: false然后在弹窗里完成验证。报未登录类错误、成片下载失败—— Cookie 失效。重新跑一次python -m tools.cookie_fetcher --config config.yml登录动作做一遍就好。速度慢、频繁中断—— 网络波动或并发拉太高。thread降到 3在proxy里填上可用代理。新旧作品互相覆盖—— 命名模板里没留{id}。把filename_template设回{date}_{title}_{id}。磁盘被占满—— 全量拉取叠加高画质。用number.post限制数量start_time/end_time圈定时间video_quality调低一档。更多字段和完整命令清单在 README.zh-CN.md 里找Cookie 脚本的实现在 tools/cookie_fetcher.py。这个工具定位是个人学习、研究与数据备份。下载内容的版权归创作者所有再分发之前务必拿到授权并遵守平台服务协议平台策略一变、接口跟着调整属于正常的技术风险。【免费下载链接】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），仅供参考