抖音无水印下载上手：300 条作品主页一次跑完

抖音无水印下载上手：300 条作品主页一次跑完

【免费下载链接】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

第三十遍重下的 mp4 落盘时，我还在"删掉坏文件、重新下载"的循环里，一个创作者的主页存了两小时。为了终结这件事，我装上了 douyin-downloader，这个抖音无水印下载工具，把一个 300 条作品的主页整页丢给它批量跑。

抖音无水印下载批量并发表现

一条一条存 300 条作品，按平均两分钟一条算，是十个小时的纯等待。这个工具的做法是把用户主页链接直接丢进队列：post、like、mix、music 每种模式有独立的下载策略，实现都在core/user_modes/目录里，默认 5 个线程并发，限速 2 req/s，先把被限流的可能性压下去。时间范围筛选也是现成的，指定 start_time 和 end_time 就能只取某段时间内的作品。把主页链接交出去之后，耗时不再是"作品数 × 单条时长"。收藏合集模式我也跑过，收藏夹里的合集视频整辑存下，不用逐个合集点开。

它还有一个基于同一套后端做的桌面客户端 Douzy，逻辑和命令行完全一致，所以截图给的是客户端界面。

增量去重与文件组织

第二个痛点更磨人：第二遍跑要重下一半，几百个文件堆在一个目录里，找起来像大海捞针。它用 SQLite 历史记录加本地文件名做双重检查，同一条作品换模式也不会再存一遍，increase.post: true时本地已存在主文件就直接跳过，文件被手动删掉才会重新下载。落盘的文件也是整理过的：作者目录下按发布日期分文件夹，文件夹名里的日期是作品的真实发布时间而不是下载时间，视频、封面、背景音乐和 JSON 元数据同放一格，目录天然就是一条时间线。

断线与限流应对

跑批时最常见的事故是断网和翻页受限。前者有按 1 秒、2 秒、5 秒间隔递增的重试，下载完成后还会把文件大小和 Content-Length 对一遍，不完整就自动清掉重下，我再没见到过半个文件。后者在 API 翻页被卡住时会自动拉起真实浏览器辅助采集，遇到验证码手动解掉就行，不用全程守在屏幕前。直播录制同理，主播下播或中途断开，已经录下来的字节原样保留。断线之后，已下载的字节不作废。

下面这张任务中心界面是我一次跑批的记录，四条任务三条成功一条失败，失败原因和重试按钮都摆在明面上，不用翻日志找问题。

安装、配置与首次运行

整个过程串起来其实很短。先把代码拿到本地：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader

进目录装依赖，Python 3.8 以上这一步就不会有坑：

pip install -r requirements.txt

再把示例配置复制成自己的，配置文件每个参数一行带注释，把链接列表、下载目录、线程数填上就能跑：

cp config.example.yml config.yml

最后是登录态。抖音的内容接口需要 Cookie，工具自带脚本直接拉起浏览器，扫码登录后它自动把 Cookie 写回配置，不用手动从浏览器开发者工具里抄：

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

都准备好之后一行命令开跑，终端里能看到并发进度条逐条推进：

python run.py -c config.yml

不想维护配置文件，也可以把链接直接当参数传进去。入口脚本run.py把参数解析交给cli/，真正的下载、去重、重试逻辑都在core/里，想看细节读这两个目录就够。

桌面客户端那边更直接：粘贴链接、识别类型、点下载，和我在命令行里做的完全是同一套逻辑。

回头看下载目录，300 条作品按发布时间排得整整齐齐，mp4、封面、背景音乐同在一个文件夹里，开头那种坏掉的文件已经不存在了。存下喜欢的抖音内容，又回到了把链接交出去、剩下的交给工具的状态。

【免费下载链接】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