抖音无水印批量下载完整指南：从单个视频到直播的四类实战场景
【免费下载链接】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 的开源抖音内容下载工具，支持视频、图集、音乐、直播等内容的无水印下载，并提供抖音批量下载、下载历史、增量去重与本地文件自动整理能力，适合个人收藏与素材收集场景。
能力总览
一条命令跑完整个下载流程：解析链接、校验登录状态、拉取无水印资源地址、按模板命名保存。下载历史存入本地 SQLite 数据库，二次运行时自动跳过已下载作品；失败任务自动重试，文件按"作者/作品"结构自动归类。
支持的内容类型与关键特性：
- 视频、图集（图文）、音乐（原声）、合集
- 用户主页：发布作品、喜欢、收藏
- 直播间录制（实验性功能）
- 抖音批量下载：多任务并发、限速、自动重试
- 时间范围过滤（start_time / end_time）
- 增量下载与历史去重，避免重复存储
- 可选能力：评论采集、语音转写、完成通知、REST API 服务
上图为项目配套的 Douzy 桌面版抖音工作台截图，展示作品、喜欢、合集、音乐的选择与参数设置。不想写脚本的话可以直接使用桌面版。
上手准备：安装依赖并配置抖音 Cookie 登录状态
安装依赖
需要 Python 3.9+，支持 Windows、macOS 与 Linux：
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt如需启用浏览器兜底（Playwright），再执行：
python -m pip install playwright python -m playwright install chromium如何配置抖音 Cookie 登录状态
Cookie 决定能否访问需要权限的内容，有两种配置方式：
- 自动脚本（推荐）：工具自动打开浏览器，手机扫码登录后回到终端按 Enter 保存：
python -m tools.cookie_fetcher --config config.yml- 手动粘贴：在浏览器开发者工具（F12 → Application → Cookies）中复制抖音网站的完整 Cookie，粘贴到
config.yml的cookies字段，字段格式参考 config.example.yml 末尾。
场景实战：四类常用场景跑通抖音无水印下载
所有场景共用run.py入口，完整参数见python run.py --help。
保存单个视频
把作品链接写入config.yml的link字段，然后运行：
python run.py -c config.yml完成后视频保存到path目录；临时换目录可追加-p ./my_downloads。注意：抖音接口风控目前限制 CLI 直接下载单个作品，遇到失败时可开启browser_fallback浏览器兜底，或改用 Douzy 桌面版。
批量下载某位创作者作品的命令
这是抖音批量下载最常用的场景：
python run.py -u "https://www.douyin.com/user/YOUR_SEC_UID"将创作者主页链接写入配置的link字段，或用-u追加。工具按顺序拉取其作品、自动跳过下载历史中已有的内容，文件按"作者/作品"目录结构保存。每次拉取的数量由number.post控制，设为 0 表示不限。
录制直播内容
当链接指向直播间（live.douyin.com/room_id形式）时自动进入直播录制模式，录制时长由live配置段控制。该功能属于实验性：HLS 源只保存播放列表，不是可直接播放的视频，使用前请先验证。
下载图集与音乐
图集作品经链接传入后自动拆分逐张保存；音乐模式通过mode: [music]获取原声文件，数量由number.music控制。这两类同样受接口风控限制，可尝试浏览器兜底，各类型当前可用性以 README 的"命令行版现状"为准。
配置调优：config.yml 中最常用的参数
link: - https://www.douyin.com/user/YOUR_SEC_UID path: ./Downloaded/ video: true music: false cover: false thread: 5 start_time: ""path：保存路径video/music/cover/avatar/json：分别控制视频本体、背景音乐、封面、头像、元数据是否保存thread：并发数，普通网络建议 3–5start_time/end_time：时间过滤，格式YYYY-MM-DD，含结束日期当天video_quality：画质，默认highest；original会尝试探测上传原片increase.post：true跳过已下载作品，false强制重下
完整字段说明见 config.example.yml。
常见问题：高频问题与排查方法
Q：下载的视频没有声音？A：视频与背景音乐是两个独立资源，在配置中开启music: true，工具会拉取原声并合并。仍无声时用-v参数查看详细日志定位。
Q：如何修改默认保存路径？A：改config.yml的path字段，或直接在命令中指定：python run.py -c config.yml -p ./my_downloads。
Q：批量下载如何设置并发数？A：修改thread。普通网络建议 3–5，高速网络可试 8–12。工具内置限速与retry_times重试机制，不建议盲目调高。
Q：Cookie 失效怎么办？A：重新运行python -m tools.cookie_fetcher --config config.yml扫码登录；手动粘贴的 Cookie 则直接在配置中覆盖更新。
Q：支持哪些链接类型？A：作品分享链接（含图集）、用户主页、合集、音乐、直播间，由 URL 解析器自动分类，直接传入即可。
使用边界与合规提示
本项目仅供个人学习研究，请遵守平台服务条款与版权法规，尊重创作者的劳动成果，不要用于商业分发。Cookie 仅保存在本地配置文件中，工具不会将其上传到任何第三方。
行动清单：开始你的第一次下载
- 克隆项目：
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader - 安装依赖：
python -m pip install -r requirements.txt - 复制
config.example.yml为config.yml，扫码登录保存 Cookie - 填入目标链接，运行
python run.py -c config.yml完成首次抖音无水印下载
从保存一个视频到归档一位创作者的全部作品，只差一条链接。
【免费下载链接】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），仅供参考
