抖音无水印视频批量下载：douyin-downloader 一次存全本地-平芜编程栈

抖音无水印视频批量下载：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 自动去重，下载过的不会重复拉取。

能力总览：一次能拿到什么

能力	说明
无水印视频	自动选择无水印源，并按码率挑选最高清档位
原声音乐	将作品 BGM 单独存为 mp3，方便二次利用
封面与头像	高清封面、作者头像可随作品一并保存
完整元数据	每个作品附带 JSON：标题、发布时间、点赞/评论数等
SQLite 去重	数据库 + 本地文件双重检查，同一作品不重复下载
断点与重试	指数退避重试，不完整文件自动清理重下；直播中断保留已录字节
直播录制	`live.douyin.com`链接触发，FLV/HLS 落盘并留存直播间快照

准备工作：两步装好并登录

先克隆并安装依赖（Python 3.8+）：

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

抖音需要 Cookie 才能访问内容。推荐自动方式：运行下面命令后会打开浏览器，扫码或登录抖音，回到终端按 Enter，Cookie 就写入了配置。

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

两点说明：Cookie 只保存在本地config.yml里，不会上传到任何服务器；更省事的方式是勾选auto_cookie: true让程序自动维护。如果浏览器兜底功能用得上，再装一次playwright并下载 chromium 即可。

核心流程：配置、运行、产出

第一步，写配置。把config.example.yml复制为config.yml，只改几个关键项即可，常用项如下：

配置项	作用	建议值
`link`	要下载的链接列表（主页/短链/直播均可）	先放 1 条测试
`mode`	下载类型：`post`作品、`like`点赞、`mix`合集、`music`音乐	`[post]`
`number`	各模式下拉多少条，0 表示不限	先设 20
`start_time`/`end_time`	时间过滤，格式`YYYY-MM-DD`	留空
`database`	开启 SQLite 去重与历史记录	`true`
`thread`	并发线程数	`5`
`browser_fallback.enabled`	翻页受限时浏览器兜底	`true`

第二步，运行。一条命令搞定：

python run.py -c config.yml

第三步，看产出。终端用 Rich 进度条实时显示每个作品的状态，文件落在path指定的目录（默认Downloaded/），同时dy_downloader.db记录下载历史，download_manifest.jsonl汇总本次清单。命令行也可以临时追加参数，比如-t 8提高并发、-u <链接>追加一条链接。

典型用法

如何收藏一个账号的全部作品

需求：系统性保存某位创作者的全部内容。做法：link填主页地址（https://www.douyin.com/user/...），mode选post，number.post设为 0 表示不限。首次建议先跑 20 条验证流程，再放开数量。

如何只下载最近 30 天的作品

需求：只要近期内容，不想翻老底。做法：把start_time设成 30 天前的日期，例如start_time: "2026-08-16"，end_time留空即代表到最新。工具只落盘时间窗口内的作品，省流量也省空间。

如何做增量更新，只拿新作品

需求：长期跟踪一个账号，每次只补新发的。做法：保持database: true，把increase.post设为true。再次运行时程序对照数据库记录，已下载的直接跳过，只拉新增作品——相当于给这个账号做版本控制。

🔧 故障速查：三个高频问题

症状	常见原因	对策
只下载到 20 条左右就停	抖音翻页风控	确认`browser_fallback.enabled: true`且`headless: false`，浏览器弹出后手动完成验证，别急着关窗口
提示 403 / 未登录	Cookie 过期（一般 7～15 天有效）	重新跑一次`python -m tools.cookie_fetcher --config config.yml`，或手动在配置里补上新的 Cookie 值
速度慢、频繁中断	并发低或网络不稳	调高`thread`（默认 5，可试 8）；必要时配置`proxy`（如`http://127.0.0.1:7890`）

查下载历史不需要翻目录，一条查询就够：sqlite3 dy_downloader.db "SELECT aweme_id, title FROM aweme ORDER BY download_time DESC LIMIT 20;"。想强制重下某条作品，删掉本地对应目录和数据库里那条aweme记录即可，两边要一起清。

进阶能力：五件事各说两句

视频转写：transcript.enabled: true后调用 OpenAI Transcriptions 接口（密钥走OPENAI_API_KEY环境变量），每个视频旁生成 txt 与 json 两份转录文本。
评论采集：comments.enabled: true会为每个作品输出*_comments.json，可含二级回复，用max_comments控制条数。
API 服务模式：装好fastapi uvicorn后执行python run.py --serve --serve-port 8000，即可通过POST /api/v1/download提交任务、按 job_id 查状态，方便接入自己的系统。
完成通知：notifications里配置 Bark / Telegram / Webhook，下载成功或失败都会推送到手机。
直播录制：直播链接放进link，用live.max_duration_seconds限制时长（0 为录到主播下播），下播或中断时已录数据都会保留。
桌面版 Douzy：基于同一后端的工作台，粘贴链接即可开始下载，还能同步关注列表、可视化跟踪任务：

Douzy 链接下载工作台：识别链接类型后直接点"下载"，左侧边栏管理账号与队列。

关注列表可按"有新作品/仅互关"筛选，逐位博主同步并直接下载，免去手动贴主页链接。

🗂️ 成果结构：产出目录长什么样

folderstyle默认开启时，每个作品独立成目录，按"日期_标题_aweme_id"命名：

Downloaded/ └── 作者名/ ├── post/ │ └── 2026-09-15_作品标题_aweme_id/ │ ├── xxx.mp4 # 无水印视频 │ ├── xxx_music.mp3 # 背景音乐（music 开关） │ ├── xxx_cover.jpg # 封面（cover 开关） │ ├── xxx_data.json # 元数据（json 开关） │ └── xxx_avatar.jpg # 作者头像（avatar 开关） ├── music/ └── live/

具体哪些附件会落盘，取决于music、cover、avatar、json这几个开关，默认只存视频本体，按需打开即可。xxx_data.json里包含 aweme_id、作品描述、发布时间、作者信息与点赞/评论/分享数，做内容分析或二次整理时可以直接读。

桌面版任务中心同样能定位成果：已完成的任务显示件数，可直接打开输出目录或重试失败项。