抖音下载工具 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存在的意义——一个开源、免费、对新手友好的抖音下载工具，帮你把视频、图集、合集、音乐甚至直播流统统搬回本地。它支持单条内容和作者主页批量下载，自带进度条、失败重试、SQLite 去重与浏览器兜底，真正做到"粘链接、等结果"。

一张表看懂：这个工具到底能干什么

先别急着敲代码，我们用一分钟建立整体认知。douyin-downloader 的能力可以分成下面几大块：

除此之外，项目还附带一个基于同一后端打造的桌面客户端，粘贴链接即可开始下载，还能同步关注列表、可视化跟踪每个任务的实时进度，适合不喜欢命令行的小伙伴：

小贴士：桌面版当前处于内测阶段，命令行版才是稳定主力。下面我们讲的流程都以命令行版为准。

上手三步走：把第一个视频下载到本地

整个使用流程可以压缩成"装环境 → 配 Cookie → 跑命令"三步，全程大概五分钟。

第一步：前置准备，把项目拉下来

确保电脑上有Python 3.8+，然后克隆仓库并安装依赖：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt

如果你后面想体验"浏览器兜底"或"自动获取 Cookie"这两个功能，再补装一下 Playwright 浏览器内核：

pip install playwright python -m playwright install chromium

第二步：配置 Cookie，拿到访问通行证

Cookie 是访问抖音接口的身份凭证，项目提供了两种方式：

• 自动获取（新手首选）：运行下面这条命令，程序会自动打开浏览器引导你登录抖音，登录完回到终端按回车，Cookie 就被自动写入配置文件，全程零手工：

python -m tools.cookie_fetcher --config config.yml

• 手动填写（备选）：把config.example.yml复制成config.yml，在cookies段里按msToken、ttwid、odin_tt等字段填上你在浏览器里复制出的 Cookie 值即可。

第三步：一条命令，看到结果

先复制一份配置文件并填入你想下载的内容：

cp config.example.yml config.yml

比如想批量下载某个作者主页的作品，把link换成他的主页链接，mode设为post，然后运行：

python run.py -c config.yml

如果想临时下载单个视频，不需要改配置，直接命令行追加参数更快：

python run.py -c config.yml \ -u "https://www.douyin.com/video/7604129988555574538" \ -t 8 -p ./Downloaded

运行后你会看到类似下面的界面——包含已获取作品数、并发线程数、保存路径，以及每个文件（视频/封面/头像）的实时下载状态，已经存在的文件会自动标记"跳过已存在"：

下载完成后，文件会自动按"作者 → 内容类型 → 作品"的层级整理好，一个作品一个文件夹，清爽不混乱：

Downloaded/ └── 作者昵称/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 2024-02-07_作品标题_aweme_id.mp4 ├── 2024-02-07_作品标题_aweme_id_cover.jpg ├── 2024-02-07_作品标题_aweme_id_music.mp3 └── 2024-02-07_作品标题_aweme_id_data.json

进阶玩转：四个能明显提升体验的小技巧

跑通基础流程后，下面这几个技巧能让你的使用体验再上一个台阶。

技巧一：开启增量下载，只抓新增作品

如果你是某位博主的"铁粉"，想持续备份他更新的每一期内容，手动全量重下太浪费。只要同时开启数据库和增量开关，程序就会自动对比记录，只下载新增作品：

increase: post: true database: true

批量下载时，每个任务都会显示独立的进度条、耗时和完成状态，整批抓完一眼就能看出结果：

适用人群：追更备份型用户、内容搬运党。

技巧二：按网络状况调整并发数

默认 5 线程是个稳妥的中间值，但你可以根据实际网络灵活调整：

• 网络不稳或手机热点：调成 1~3，保证每个文件都能完整下载
• 日常宽带：维持 5~10，速度和稳定性平衡
• 高速环境：大胆调到 10~20，配合thread参数一次跑满带宽

python run.py -c config.yml -t 12

适用人群：宽带大户想榨干网速，或者网络一般不想频繁失败的普通用户。

技巧三：翻页被卡？让浏览器兜底

批量抓作者主页时，如果你发现"只能抓到 20 条作品"，这通常是翻页接口被风控了。别慌，开启浏览器兜底即可：程序在接口翻不动时会自动拉起真实浏览器，你可以手动完成验证码，让采集继续往下走。

browser_fallback: enabled: true headless: false # 保持非无头模式，方便人工过验证 max_scrolls: 240

适用人群：需要完整备份大 V 全部历史作品的用户。

技巧四：顺手把直播也录下来

工具还内置了实验性的直播录制功能，把直播链接填进link即可，录制过程中支持多清晰度选择，主播下播、网络空闲或手动中断时，已经录好的片段都会保留：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 表示录到主播下播

录制的 FLV 文件会存放在Downloaded/{作者}/live/目录，并附带一份直播间元数据快照：

适用人群：想留存精彩直播瞬间的观众、主播本人做回放归档。

新手高频问题：快问快答

Q：为什么一定要配置 Cookie？失效了怎么办？A：Cookie 是访问抖音接口的身份凭证，没有它就拿不到内容数据。失效时重新跑一次python -m tools.cookie_fetcher --config config.yml，重新登录即可。

Q：下载的文件默认保存在哪里？A：默认在项目根目录下的Downloaded文件夹中，也可以通过配置文件里的path或命令行-p参数自定义保存位置。

Q：如何避免重复下载同一个视频？A：默认开启的 SQLite 数据库 + 本地文件双重去重会自动跳过已下载内容，跨模式（如同时下载 post 和 like）也不会重复。想强制重下，删掉对应作品文件夹和数据库记录即可。

Q：只能抓到 20 条作品，是坏了吗？A：不是 bug，是翻页风控。确保browser_fallback.enabled为true且headless为false，弹出浏览器后手动完成验证再继续。

Q：我完全不懂编程，能用吗？A：能用。全程只需复制粘贴三条命令、填一次 Cookie，其余都是配置文件里的中文注释项。当然，熟悉一点 YAML 会让你调参更顺手。

写在最后：开始建立属于你的抖音内容库

从"看得到却存不下"到"粘链接就能带走"，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