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
如果你也曾手动复制抖音链接、挨个打开去水印网站、再整理文件名，这篇文章就是为你写的。下面用 10 分钟跑通 douyin-downloader 的完整流程：粘贴链接，批量下载视频、图集、合集、音乐，甚至整个作者主页，自动归档成一份可查询的内容库。
09:00 老周的早晨：20 条去水印，半天没了
老周开文创小店，每天早上要收集 20 条对标账号的作品做素材。老办法是固定的四步：复制链接 → 打开去水印网站 → 等下载 → 手动把文件名改成"日期_品类"。单条平均 4 分钟，一天 20 条就是 1 小时 20 分钟起步，还不时遇到去水印站给回带水印的版本，得重下一次。他的原话是："我以为自己是素材收集，其实是个文件名修理员。"后来我让他试试 douyin-downloader，这篇文章就按他那一天的时间线，记录从零到自动归档的每一步。
先自查：有没有中这三条
- 收藏夹里上百条"以后再看"，却没有系统保存方式
- 要批量收集某个博主的作品，手动操作又慢又容易漏
- 下完才发现带水印，或者文件名全是无意义数字
- 重复下载同一批内容，白占硬盘空间
中任何一条都可以继续往下读。
10:00 第一次跑起来：三样东西加两条命令
一句话本质：douyin-downloader 是一个 Python 批量下载工具，把"解析链接、识别类型、请求接口、选无水印源、存文件、记台账"打包成一份配置加一条命令。能力总览：
| 想拿什么 | 粘贴这类链接 | 说明 |
|---|---|---|
| 单个视频 / 图文 | /video/{id}、/note/{id} | 自动挑最高码率，优先无水印源 |
| 作者主页批量 | /user/{sec_uid} | post 作品 / like 点赞 / mix 合集 / music 音乐四种模式 |
| 单个合集 / 音乐 | /mix/{id}、/music/{id} | 音乐优先原声文件 |
| 自己的收藏夹 | /user/self?showTab=favorite_collection | 需登录 Cookie，collect/collectmix模式 |
| 直播录制 | live.douyin.com/{房间号} | 主播下播也保留已录数据 |
v.douyin.com/...短链也会被自动解析后再下载。要准备的东西只有三样：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 python run.py第一行拉代码并进入项目目录，第二行装依赖并复制出配置模板，第三行直接运行。想免手动抓包自动拿登录 Cookie，可以先跑python -m tools.cookie_fetcher --config config.yml（入口见 tools/cookie_fetcher.py），浏览器引导登录、回到终端按回车，Cookie 就写进配置了，认证信息全部留在本地。
配置里只需要动这几处：
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 0 thread: 5number.post: 0表示全量抓取，thread: 5是并发数，按网络调整。只想要新作品就加上increase.post: true，配合系统定时任务，内容每周自动更新。
11:30 防翻车：三个"看似成功"的场景
下载这件事，最怕的不是慢，而是"看似成功实则翻车"。老周第一晚就踩了三个坑，好在程序内部都有兜底：
- 文件下到一半断了：下载完成后用 Content-Length 比对大小，不完整文件自动清理并重试，默认 3 次、间隔从 1 秒拉长到 5 秒，不会留下打不开的坏文件。
- 同一个视频存了两遍：
dy_downloader.db这份 SQLite"仓库台账"记录每次下载的作品 ID，数据库加本地文件名双重核对，重复提交直接跳过，不白占空间。 - 翻页被平台风控掐断：接口拉不动时自动切到浏览器模拟翻页，弹窗让你手动过验证码，等于多一条备用路线。
基于同一套后端的桌面版（Douzy）里有个任务中心：每个任务的已完成/失败状态和成功失败计数一目了然，失败的点"重试"就行，不用整批重跑。
17:00 打开 Downloaded：一座内容库已经建好
下班时目录已经分好了。默认每个作品单独一个文件夹，文件名是"日期_标题_ID"：
Downloaded/ └── 旅行摄影师旅记/post/2024-06-15_舞蹈教学_7412345678901234567/ ├── 2024-06-15_舞蹈教学_7412345678901234567.mp4 # 无水印视频 ├── ..._cover.jpg · ..._music.mp3 # 封面 / 原声（配置开启后） └── ..._data.json # 完整元数据格式想改也完全可以：{id}{title}{author}{date}{type}这些变量可以在命名模板里自由拼接。所有作品还会写进 SQLite 数据库，之后按作者、标题关键词、发布时间筛选，不必对着文件夹翻，查询示例就在 README.zh-CN.md 的常见问题一节。
桌面版的关注管理里还能按"有新作品""有本地备注"筛选博主，直接从列表下载，连"找文件夹"这一步都省了。
往后还能玩出什么花样
- 语音转写：开启
transcript配置，把视频转成文字稿，适合做素材检索 - 评论采集：
comments.enabled: true，抓作品评论（含二级回复）输出 JSON 文件 - 完成通知：跑批结束后推送到 Bark / Telegram / Webhook，不用盯着终端
- REST API 服务：
python run.py --serve --serve-port 8000，把下载能力接进自己的自动化流程
复盘：三步走，明天就存下第一批
回顾下来就是三步：装依赖（pip install）、写配置（cp 一份 config.example.yml）、贴链接（python run.py），各一条命令。新手建议先拿一条单视频链接试跑，确认流程通了再上作者主页批量；完整功能表都写在 README.zh-CN.md 里。最后提醒一句：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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
