抖音无水印下载完整教程：用 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 是一款开源的 Python 命令行工具，用于抖音无水印下载：给它一条作品链接，可以把无水印视频本体存到本地；给它一条主页链接，可以批量保存某位创作者的全部作品，还涵盖合集、点赞、原声音乐与直播录制。本文按"能得到什么 → 如何上手 → 如何批量 → 出了问题怎么办"的顺序，讲清从零到能用的完整路径。
一次下载，能落盘哪些内容
默认情况下，工具只保存画质最高的无水印视频本体，其余产物都要显式开启：
- 原声音乐（
music: true）：把作品配乐另存为独立音频文件； - 封面与头像（
cover/avatar）：保存作品封面图和创作者头像； - 作品元数据（
json: true）：生成含标题、发布时间、点赞数的信息文件； - 评论（
comments.enabled: true）：为每个作品额外生成*_comments.json，可选是否包含二级回复。
文件统一落在Downloaded/下，按创作者分子目录，默认每个作品再建一层文件夹，命名格式为{date}_{title}_{id}，其中日期取自作品发布时间，可用变量与模板规则见 utils/naming.py。项目另有一个共享同一后端的桌面版 Douzy，粘贴链接即可发起任务，其抖音下载选项界面如下：
如何快速上手：安装与获取 Cookie
第 1 步，获取代码与依赖（需要 Python 3.9 及以上版本）：
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml第 2 步，如何获取登录 Cookie。抖音接口只对登录用户返回完整数据，Cookie 就是这套登录态凭证。最省事的方式是运行项目内置的抓取脚本：
python -m tools.cookie_fetcher --config config.yml它会自动打开浏览器，你扫码登录后回到终端按回车，Cookie 就被写入配置；也可以从抖音网页版开发者工具里手动复制后粘贴到cookies字段。Cookie 只保存在本地，有效期通常一到两周。
第 3 步，写最小配置并运行：link放目标作品（v.douyin.com短链同样支持），path指定保存目录：
link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ video: truepython run.py -c config.yml终端会显示进度条，结束后即可在目标目录找到无水印 mp4；其余命令行参数用python run.py --help查看。
主页批量归档与精确筛选
想完整保存一位创作者的作品，把link换成主页链接，用mode和number控制抓取范围：
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [post, like] number: post: 100 # 数量上限，0 表示不限制 like: 0mode支持post（发布作品）、like（点赞）、mix（合集）、music（原声）四种可任意组合，同一作品跨模式不会重复落盘；start_time/end_time（YYYY-MM-DD格式）则只保留区间内的作品，适合"只要最近一个月"这类需求。
增量机制值得理解：各模式默认开启increase，磁盘上已存在主文件的条目会被跳过，所以重复执行同一主页只补新内容；默认还会把下载历史记入 SQLite 数据库，想强制重下时把increase设为false即可，无需清空数据库。
进阶配置与常见问题
几个值得翻看的选项：
- 画质：
video_quality默认highest（最高转码档），original会先探测上传原片、失败再回退，也可直接指定1080p等分辨率； - 直播录制：
link指向 live.douyin.com 直播间时自动进入录制模式，live.max_duration_seconds为 0 表示录到主播下播； - 完成通知：
notifications支持 Bark、Telegram、webhook 三种渠道，长任务跑完手机即可收到提醒； - 并发与稳定：
thread默认 5 线程，retry_times默认重试 3 次，网络受限环境可配置proxy； - 作者目录：
author_dir: nickname_uid可避免重名创作者的目录互相合并。
完整配置项可查 config.example.yml，默认值汇总在 config/default_config.py。
| 常见现象 | 处理方式 |
|---|---|
| 403 或"未登录"报错 | Cookie 过期，重跑cookie_fetcher更新；仍失败时保持browser_fallback.enabled: true走 Playwright 浏览器兜底，或改用桌面版 |
| 主页只抓到 20 条就停 | 翻页被风控拦截，浏览器窗口弹出后手动完成验证，不要立刻关闭 |
| 下载中断或明显偏慢 | 调低thread，确认retry_times生效，必要时配置proxy |
| 旧作品被重新下载 | 检查对应模式的increase是否为true，文件被手动删掉后确实会重下 |
另需注意：单条链接下载若被抖音风控拦截，反复重试旧 Cookie 解决不了问题，应优先更新 Cookie、启用浏览器兜底或改用桌面版。
写在最后
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），仅供参考
