4 步完成抖音无水印下载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 把这条链路做成了命令行工具能直接抓无水印原片支持视频、图集、合集、音乐等类型也支持作者主页批量下载。这篇指南面向没用过类似工具的你从装环境到第一次出片再到按需调配置全部按实际可执行的方式写。场景短视频创作者的素材收集你在做一个混剪账号需要保存一批同题材的原片做参考和二次剪辑。手动录屏会带水印在线转换站又压画质一条条操作效率也低。douyin-downloader 的工作方式是直接向抖音接口请求媒体源优先选无水印地址再按码率阶梯自动挑最高清一档也可以开启original模式去探测上传时的原片。这个工具能做什么能力说明内容类型单个视频、图文图集、合集、音乐优先原声文件批量下载作者主页作品、点赞、合集、收藏夹当前登录账号画质无水印优先自动选最高码率可选原画、1080p 等档位去重与增量SQLite 数据库 本地文件双重去重支持只下新增作品容错指数退避重试、下载完整性校验、翻页受限时浏览器兜底附加产物封面、背景音乐、头像、作品 JSON、评论采集均可选从 0 到第一次下载出片步骤一克隆并安装需要 Python 3.8macOS / Linux / Windows 均可git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt步骤二登录拿 Cookie抖音接口需要登录态工具提供了自动获取脚本会打开浏览器扫码登录后回到终端按 EnterCookie 会写进配置文件python -m tools.cookie_fetcher --config config.yml它依赖 Playwright如果之前没装先执行pip install playwright python -m playwright install chromium步骤三建配置并运行仓库里带了一份带注释的示例配置 config.example.yml先复制一份cp config.example.yml config.yml打开config.yml把link换成你想下载的链接最小可用的改动长这样link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/然后运行python run.py -c config.yml跑完后去Downloaded/目录会看到按「作者名/模式/日期_标题_作品ID」组织的文件夹视频文件在里面。也习惯一次性参数的话可以直接在命令行追加链接不必改文件python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538配置保存位置、画质与元数据默认配置偏保守只存视频本体封面、音乐、头像、JSON 都是按需打开的避免目录被附带文件撑大。常用调整项集中在 config.example.yml 前 70 行注释写得比较细可以直接对照改。保存路径与命名path控制落盘根目录filename_template/folder_template控制文件与目录命名可用变量包括{id}{title}{author}{date}{year}{month}{day}等注意模板里保留{id}防止重名覆盖。folderstyle: true时每个作品单独建目录方便后续管理。画质与时间过滤video_quality: original # 探测上传原片探测失败退回最高转码档 start_time: 2025-01-01 end_time: 2025-12-31video_quality可选original原画、highest默认最高转码档、lowest或直接指定1440p/1080p/720p/540p/360p匹配不到会自动降到最接近的档位。start_time/end_time用于只保留指定日期范围内发布的作品。想留元数据的话把cover、music、json按需置为true每个作品目录里会多出封面、BGM 和一条 JSON 记录。版本怎么选命令行、API 服务还是桌面版一句话判断只想下载东西选命令行版10 分钟上手要把它接进自己的系统用 REST API 服务模式完全不想碰终端可以关注还在内测的桌面版 Douzy。三种形态速览形态入口适合谁命令行版python run.py -c config.yml绝大多数用户批量、脚本化REST API 服务python run.py --serve --serve-port 8000需要二次开发、对接其他程序桌面版 Douzy内测项目 Releases 页下载纯可视化操作无命令行习惯API 服务需要先pip install fastapi uvicorn提交下载走POST /api/v1/download查询任务走GET /api/v1/jobs/{job_id}接口细节见 server/app.py 与 README.zh-CN.md。桌面版基于同一套后端粘贴链接即可开始任务中心里能看到每个任务的状态、成功/失败计数失败项可以直接重试进阶玩法批量、去重与增量批量下载与自动去重把作者主页链接放进link用mode和number控制范围number为 0 表示不限量link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - mix number: post: 50 mix: 0同一个作品在多个模式下出现时会自动去重不会重复下载。并发数由thread控制默认 5失败按 1s / 2s / 5s 指数退避重试retry_times次默认 3。增量下载与时间过滤increase: post: true database: true增量模式依赖 SQLite 记录默认dy_downloader.db下次对同一作者再跑只会补新增作品。配合start_time/end_time还能只追踪某个时间段的内容适合长期跟踪固定创作者的更新。浏览器兜底与失败重试翻页接口被风控限制时browser_fallback会启动一个可见浏览器窗口继续滚动加载期间需要你手动过一次验证码不要立刻关窗。相关参数、限速默认 2 请求/秒与代理proxy的说明见 config.example.yml。避坑手册最容易卡住的三处只抓到 20 条就停了这是翻页风控的典型表现。确认browser_fallback.enabled为true且headless为false弹出浏览器后完成验证再让它继续滚动。Cookie 过期了重新跑一次获取脚本即可不用手工抓python -m tools.cookie_fetcher --config config.yml想让某条重新下载去重是「数据库记录 本地文件」双重判断只删文件不删记录不会触发重下。要重下某条作品删掉对应数据库记录文件名里的作品 ID 即aweme_idsqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;全部从零开始的话删掉Downloaded/目录和dy_downloader.db两个地方都清理即可细节见 README.zh-CN.md 的「重新下载」一节。合规提示与下一步行动清单工具本身不判断内容归属责任在使用者建议只保存自己账号收藏、个人学习或合理范围内使用的作品不用于商业传播或侵犯他人版权的内容批量任务保持默认限速别对接口施压。下一步可以按顺序做克隆仓库并装好依赖跑通cookie_fetcher登录流程用一条视频链接完成第一次下载确认Downloaded/目录结构符合预期按需求打开video_quality、封面/音乐/JSON 等开关对一个固定作者启用增量模式体验「只补新增」的批量跟踪有二次开发需求时再研究--serve服务模式更多场景收藏夹下载、直播录制、评论采集、热搜榜导出在 README.zh-CN.md 的「典型场景」一节都有可复制的配置示例可以按需取用。【免费下载链接】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），仅供参考