FEATURED · 精选文章

douyin-downloader 完整教程:6 步实现抖音主页去水印批量下载

发布时间 / 2026/9/16 20:01:31
来源 / 创域科博编辑部
栏目 / 资讯中心
douyin-downloader 完整教程:6 步实现抖音主页去水印批量下载 douyin-downloader 完整教程6 步实现抖音主页去水印批量下载【免费下载链接】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 是一个开源的抖音批量下载工具。给它一个抖音主页链接它能去水印拉下该作者的作品并内置并发下载、去重和增量更新第二次运行不会重复下载。本文带你从安装、Cookie 获取、最小配置一路跑到第一次出片再讲画质、时间窗口等进阶配置以及 4 个最常见的坑。一条主页链接douyin-downloader 能批量抓哪些东西它识别的链接类型比大多数人想象的多不用手动区分链接形式你会得到/video/{aweme_id}单个视频/note/、/gallery/单条图文/collection/、/mix/单个合集/music/{music_id}单条音乐优先原声v.douyin.com/...短链自动解析后下载/user/{sec_uid}主页批量post/like/mix/music四种模式除了下载还附带几个实用能力按作品抓评论输出*_comments.json、直播录制实验性、--hot-board热搜榜与--search关键词搜索结果落 JSONL、REST API 服务模式--serve以及下载完成后的 Bark/Telegram/Webhook 推送。无水印源是默认优先项最高画质基于video.bit_rate码率数组自动挑选。同一套后端也提供了桌面版 Douzy内测中粘贴抖音链接即可开始下载免去手写配置文件让批量跑得稳的 4 个内置机制批量下载最怕的不是慢是中途崩掉或重复下。这套工具在 下载主流程 里把四件事做成了默认行为并发 限速 重试thread: 5默认 5 线程rate_limit默认 2 请求/秒retry_times: 3配指数退避1s、2s、5s网络抖动不会直接中断任务。双重去重SQLite 数据库默认dy_downloader.db数据库模块加本地文件扫描双重判断已下载的作品直接跳过跨模式post/like/mix/music同一个aweme_id也不会重复。增量下载increase.post: true时只抓新作品适合周期性跟进关注的博主。浏览器兜底API 翻页受限时自动启动 Playwright 浏览器采集aweme_idheadless: false意味着弹窗出现后你可以人工过验证码max_scrolls: 240控制最大滚动轮数。另外媒体下载有完整性校验——按Content-Length比对文件不完整会自动清理并重试不会留下半个 mp4。桌面版任务中心展示每个下载任务的状态、成功与失败数失败项可单独重试安装与首次运行6 步出第一批视频要求 Python 3.8macOS / Linux / Windows 均可。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt第 1 步装浏览器依赖浏览器兜底和 Cookie 自动获取都靠它建议装pip install playwright python -m playwright install chromium第 2 步复制 示例配置cp config.example.yml config.yml第 3 步获取 Cookie会打开浏览器让你扫码登录登录后回终端按 EnterCookie 自动写入配置python -m tools.cookie_fetcher --config config.yml第 4 步编辑config.yml填入要下载的链接最小配置见下一节。第 5 步运行python run.py -c config.yml第 6 步如果只想临时追加链接或覆盖参数命令行直接传即可python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538 -t 8 -p ./Downloaded两种典型用法单条链接与主页批量单条视频配置只需要两行link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/主页批量是它的主战场。mode决定抓什么number里0表示全量link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like - mix - music number: post: 50 like: 0上面会抓该作者 50 条发布作品 全部点赞、合集与音乐跨模式自动去重。下载产物按作者名/模式/日期_标题_aweme_id/分层存放目录里除视频外可按需打开封面cover、音乐music、元数据json开关。常用参数说明-u, --url追加下载链接可重复传-t, --thread覆盖并发数-p, --path覆盖下载目录-v, --verbose显示 info 及以上日志--hot-board [N]拉取热搜榜导出 JSONL--search 关键词关键词搜索作品收藏夹模式collect/collectmix只能抓取当前 Cookie 登录的账号自己的收藏且必须单独使用不能和 post/like/mix/music 混写。进阶配置画质、时间窗口和按需开关 几个高频调优点全部在config.yml里画质video_qualityoriginal会探测上传原片可比最高转码档大数倍代价是每条作品多一次探测请求highest为默认只在转码档里挑也可写死1080p、720p等匹配不到时自动降级。时间窗口start_time: 2024-01-01/end_time: 2024-12-31YYYY-MM-DD格式整理年度精选时用得上。评论采集comments.enabled: true后每个作品旁生成*_comments.jsoninclude_replies: true会多拉二级回复请求量明显增加max_comments可限流。通知推送notifications.providers支持 bark / telegram / webhook 三类并发推送单个失败不阻塞下载。视频转写transcript.enabled: true并配置OPENAI_API_KEY调用 OpenAI Transcriptions API 生成 txt/json 字幕仅视频生效。部署上项目自带 Dockerfiledocker build后挂载config.yml和下载目录即可跑长期挂机的场景推荐容器化。卡住了吗4 个最常见的坑只抓到 20 条就停了这是翻页风控的典型表现。确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证、不要立即关窗让它继续滚动采集。提示认证失败 / Cookie 无效抖音 Cookie 有效期通常一到两周重新执行python -m tools.cookie_fetcher --config config.yml即可。想重新下载某条作品去重是数据库 本地文件双通道判断规则是库里没记录、或库里有记录但文件不存在都会触发重下。所以直接删掉本地目录即可若想连历史一起清掉两条命令一起走rm -rf Downloaded/作者名/post/*_aweme_id/ sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;注意反方向只删数据库记录、保留文件是不会触发重下的。进度条刷屏干扰看日志默认progress.quiet_logs: true已在进度阶段静默日志调试时再临时加--show-warnings或-v打开。现在就可以动手克隆仓库、复制配置、跑一次 cookie_fetcher然后python run.py -c config.yml看第一条无水印视频落盘。批量任务记得按网络环境调thread别让并发撞上风控。请遵守平台规则使用本工具下载内容仅限个人存档并尊重内容创作者的版权。【免费下载链接】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),仅供参考
RELATED — 相关阅读

相关资讯

LATEST — 最新资讯

最新发布

TODAY — 本日精选

新闻

WEEKLY — 本周精选

新闻

MONTHLY — 本月精选

新闻