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 就是干这个的命令行驱动输入链接加一份 YAML 配置视频、图文、合集、音乐、直播录制全部落到本地默认输出无水印 mp4并内置重试、SQLite 去重、浏览器兜底和增量续跑。开始前的准备清单三件事一件都别省1. 装好 Python 环境要求 Python 3.8 及以上macOS、Linux、Windows 均可。拉代码并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt终端没有红色报错环境就绪。浏览器兜底和 Cookie 自动抓取还需要 Playwrightpip install playwright python -m playwright install chromium2. 准备好 Cookie最关键的一步抖音的大部分内容只对登录用户开放登录态不对后面全是失败。别手动复制 Cookie项目自带抓取脚本python -m tools.cookie_fetcher --config config.yml浏览器弹出后扫码登录回到终端按 EnterCookie 自动写入配置文件。若浏览器弹出后卡住先确认playwright install chromium是否执行成功。脚本实现见 tools/cookie_fetcher.py。3. 备好配置文件cp config.example.yml config.yml模板里每个字段都有中文注释。必填的只有三项link、path、cookies其余按需调整完整说明见 README.zh-CN.md。三步跑通第一条抖音无水印视频第一步把config.yml里的link换成一条你想保存的视频链接例如https://www.douyin.com/video/760412345678901234567。第二步确认cookies已填入、path指向本地目录默认./Downloaded/。第三步启动python run.py -c config.yml成功信号有两个终端打出完成统计Downloaded/下出现以作者名命名的目录里面是去水印 mp4。命令行参数可以临时覆盖配置而不用改文件比如-u追加链接、-t 8提到 8 并发。对号入座三种最常见的诉求如何保存抖音主页视频整站归档一个博主把link换成博主主页/user/{sec_uid}用mode勾选要抓的内容类型用number给每种模式设上限0不限link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - mix number: post: 50 mix: 20post作品、like喜欢、mix合集、music音乐可以一次混跑同一个作品跨模式不会重复下载。跑完后内容按作者/post/、作者/mix/分层归档。注意collect/collectmix收藏夹、收藏合集只能单独使用且只针对当前 Cookie 登录的账号。抖音直播录制录下一整场直播间链接直接填进link不用开录屏软件link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 录到主播下播录满时长、主播下播或你按 CtrlC已写入的字节都会保留为 FLV存放在Downloaded/{作者}/live/下附带一份房间元数据 JSON。该直播接口标注为 experimental极端场景可能有兼容问题重要场次建议再人工备一份。只采集数据不下文件不下载媒体、只导出结构化数据时两条命令搞定结果都是 JSONL可直接用 jq 或 pandas 二次处理python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded分别落在Downloaded/hot_board/和Downloaded/search/目录。进阶让批量任务能跑一整夜的参数批量任务动辄几十分钟参数按遇到什么情况就改哪项来理解你遇到的情况改哪个参数效果主页只翻到 20 条左右就停browser_fallback.enabled: true、headless: false自动开浏览器兜底翻页弹窗里手动过验证码默认即有头模式硬盘堆出重复文件database: trueincrease.post等置true数据库记录加磁盘文件双重去重本地已存在的直接跳过网络偶发抖动retry_times: 3按 1s/2s/5s 指数退避自动重试下载还有 Content-Length 完整性校验残文件自动清理重下下载速度上不去thread从 5 提到 8并发拉高前先确认网络稳定一上来拉满容易触发风控反而更慢只想要某段时间的作品start_time/end_timeYYYY-MM-DD按发布时间过滤可分段抓取想要更好画质video_quality: original默认highest只挑最高转码档original会额外探测上传原片每条多一次探测请求挂机跑长任务notifications配 Bark / Telegram / Webhook跑完或失败时手机推送不用守在终端前进度刷屏太吵progress.quiet_logs: true进度阶段静默日志排查问题时临时加-v两个容易踩的点去重是数据库记录 本地文件双查。只删库不清文件不会触发重下两者都清才会重新下载。2026 年 8 月起抖音 Argus 风控收紧CLI 直连的点赞、收藏夹及单条视频等接口返回 403主页作品翻页主要依赖浏览器兜底桌面版 Douzy 走内置登录窗口代发请求不受此限制。出问题时六种情况对照表现象原因解法主页只抓到 20 条左右翻页触发风控确认browser_fallback开启且headless: false弹窗里手动过验证码或用时间分段抓取突然大面积失败Cookie 过期重跑python -m tools.cookie_fetcher --config config.yml更新登录态硬盘里出现重复文件没开数据库去重database: true配合increase走增量某条作品被跳过、想重下去重机制生效删本地对应文件夹再用 sqlite3 删库中记录参考 README.zh-CN.md 的重新下载一节日志刷屏进度未静默progress.quiet_logs: true需要详情时加-v或--show-warnings速度偏慢并发与重试保守thread提到 8、retry_times给 3逐步上调观察从一条链接开始攒你的本地内容库上手顺序建议先用一条单视频链接验证 Cookie 和网络再上主页批量测试阶段把number.post设成 15跑通后再放开到0不同任务分开建config_test.yml、config_daily.yml别共用一份把 Cookie 失效当周期维护项而不是故障长任务配上notifications跑完手机直接收到。相关源码分布在 core/下载与策略、storage/数据库与文件管理、config/配置加载想深入某块可以按目录找。本项目仅供技术学习与个人数据管理使用请在合法合规的前提下使用尊重内容版权与创作者权益。【免费下载链接】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），仅供参考