
如何批量下载抖音无水印视频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把一个创作者的主页链接写进配置文件敲下一条命令终端里随即出现下载进度条几十秒后Downloaded/目录下按「作者名 / 日期_标题_aweme_id」分好文件夹里面是无水印的 mp4可选附带封面、原声音乐和 JSON 元数据。这就是 douyin-downloader 能做到的事——一个免费开源的抖音批量下载工具支持视频、图文、合集、音乐以及作者主页的整页抓取下载过程带进度展示、失败重试和 SQLite 去重。 它是什么 适合谁一个基于 Python 的命令行工具YAML 配置文件加 CLI 参数两种用法核心依赖只有 aiohttp、rich、pyyaml 这几个常见库。解决的核心问题是「去水印 批量」直接拿服务器上的原始文件而不是录屏或下载带水印版本同时按作者主页把作品整页拉下来自动按发布时间和标题归档。覆盖面比较完整单视频、图文、合集、音乐、短链都能下主页可下发布作品、点赞、合集、音乐登录账号的收藏夹也支持。工程化细节做得比较细默认 5 并发、指数退避重试、2 请求/秒限速、数据库 本地文件双重去重、断页时浏览器兜底。适合想备份自己作品、收集同领域素材做内容分析、或拿公开数据做研究的人。它不擅长什么纯小白如果完全不想碰命令行可以先看看基于同一后端做的桌面版README 里标注为内测期命令行版才是功能最全的那份。 从安装到第一次出结果环境要求是 Python 3.9macOS / Linux / Windows 都能跑。克隆下来装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.ymlpip install完成后没有额外构建步骤config.yml是从示例配置复制出来的后面所有行为都围绕这一份文件调整。接下来是 Cookie。Cookie 相当于你在抖音的登录态请把它当敏感信息对待——不要提交到公开仓库、不要分享Cookie 有时效失效后重新获取一次即可。推荐用自带的浏览器工具自动获取需要一次性安装 playwrightpip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml终端会提示一个浏览器窗口登录抖音后回到终端按 EnterCookie 会自动写回config.yml省去手动复制十几个 cookie 字段。现在可以跑第一次下载了。在config.yml的link:里放一条链接视频、主页都行确认mode: [post]、number.post: 00 表示不限数量然后python run.py -c config.yml运行后 Rich 进度条开始滚动结束时会打印成功/失败计数。到Downloaded/里看一眼每个作品一个独立文件夹mp4 无水印日期前缀用的是作品发布时间而不是下载时间。命令行参数也可以临时覆盖配置比如python run.py -c config.yml -u https://www.douyin.com/video/xxx -t 8其中-t临时把并发调到 8。 功能全景按你的目标来用只是想存下某几个视频。把视频、图文/note/...、合集/collection/...或音乐链接放进link:短链v.douyin.com/...也能自动解析。想顺手留下原声和元数据把music: true、json: true打开即可其余字段不用动。想批量采集一个创作者。把主页链接放进link:用mode决定拉哪几类内容post发布作品、like点赞、mix合集、music音乐可以混用跨模式会自动按 aweme_id 去重。number控制每类数量start_time/end_time格式YYYY-MM-DD做时间窗过滤increase.post: true则只拉新作品——配合database: true隔天再跑同一命令就是增量同步。想接进工作流或当数据源用。几个不太显眼但实用的入口python run.py --hot-board 30导出热搜榜快照JSONLpython run.py --search 关键词 --search-max 100按关键词搜索并落盘comments.enabled: true会给每个作品额外生成*_comments.json可选带二级回复--serve --serve-port 8000起一个 REST API 服务POST /api/v1/download提交链接、GET /api/v1/jobs/{job_id}查状态适合脚本化调用批量任务跑完还可以用notifications配置推送 Bark / Telegram / Webhook。直播房间链接live.douyin.com/{room_id}会被识别为直播录制下播前中断也会保留已录内容。⚙️ 关键配置项速览真正值得手动改的选项没几个其余保持默认即可配置项默认值说明mode[post]主页批量下载的内容类型可多选number.post等0各模式数量上限0为不限thread5并发下载数网络一般时调大retry_times3失败重试次数指数退避1s/2s/5svideo_qualityhighest画质档位original会探测上传原片start_time/end_time空时间过滤YYYY-MM-DDincrease.posttrue增量开关只下新作品databasetrueSQLite 去重与历史记录默认存dy_downloader.dbbrowser_fallback.enabledtrue翻页受限时启动浏览器兜底完整字段和注释可以直接翻 config.example.yml每项都有中文说明。❓ 常见问题速查只抓到 20 条作品就停了这是翻页风控的常见现象。确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证不要立刻关窗口前提是装过 playwright。Cookie 失效、提示需要登录重跑一次获取命令即可python -m tools.cookie_fetcher --config config.yml想强制重新下载某个作品去重是「数据库记录 本地文件」双重判断两边都要清删掉对应的本地目录再执行sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;。只删文件不删库会触发重下只删库不删文件则不会。进度条刷屏日志默认progress.quiet_logs: true已经在进度阶段静默日志调试时加-v或--show-warnings看详细输出完事去掉就行。 源码结构 扩展点代码按职责分目录读起来路径很短几个核心模块cli/ # 参数解析、主循环、Rich 进度展示 core/ # URL 解析、API 客户端、各下载器与用户模式策略user_modes/ control/ # 限速、重试、并发队列 storage/ # SQLite、文件管理、元数据 auth/ # Cookie 与 msToken 管理 config/ # YAML 加载、环境变量覆盖、默认值 tools/ # 浏览器 Cookie 获取等独立工具下载器用工厂模式DownloaderFactory按链接类型分发用户主页的各模式走策略模式并注册在UserModeRegistry里想加一种新的抓取模式照core/user_modes/里的现有策略仿写一个、注册进去即可。REST 服务在 server/tests/ 里五十多个测试文件基本覆盖各模块python -m pytest -q就能验证改动。下一步完整文档README.zh-CN.md功能清单、典型场景、输出目录结构都在这里配置参考config.example.yml架构说明PROJECT_SUMMARY.md设计文档docs/superpowers/plans/想提 PR 的话先看 AGENTS.md 里的开发约定再跑一遍python -m pytest -q和ruff check .克隆下来配好 Cookie 跑一遍比读十篇介绍都直观。【免费下载链接】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),仅供参考