douyin-downloader 教程：三步实现抖音无水印批量下载

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-downloaderdouyin-downloader 是一个基于 Python 的抖音去水印批量下载工具支持单视频、图集、合集、音乐和作者主页作品下载内置增量去重、并发控制与浏览器兜底。本文按安装、配置、运行三步带你完成第一次下载并按场景给出可复制的配置写法。 能力速览先看它覆盖哪些能力后文再逐个讲用法。核心下载逻辑在 core/ 目录按链接类型和用户模式分派到不同的下载器。使用场景对应模式/命令关键配置下载产出保存单个视频把/video/{aweme_id}链接写入linkvideo: truemp4可选封面、音乐、JSON保存单条图文/note/或/gallery/链接写入linkjson: true保留元数据图片 元数据文件解析分享短链https://v.douyin.com/...直接放入link同上同上自动还原真实链接作者主页作品批量用户主页链接 mode: [post]number.post: 0表示全量Downloaded/{作者}/post/下的视频作者点赞作品主页链接 mode: [like]number.like: 0like/子目录合集批量合集链接或mode: [mix]number.mix: 0mix/子目录音乐原声/music/{music_id}链接或mode: [music]music: true保存音频mp3 元数据收藏夹备份mode: [collect]或[collectmix]需登录 Cookie单独使用number.collect: 0collect/子目录直播录制live.douyin.com/{room_id}链接live.max_duration_seconds: 0录到主播下播Downloaded/{作者}/live/下 FLV *_room.json导出热搜/搜索结果python run.py --hot-board 30、python run.py --search 关键词--search-max 100限制条数Downloaded/hot_board/、Downloaded/search/下 JSONL项目还有一个共享同一套后端的桌面版 Douzy目前为内测状态粘贴链接即可发起下载适合不想用命令行的场景。 三步跑起来第一步安装环境与依赖准备 Python 3.8 环境macOS / Linux / Windows 均可克隆仓库并安装依赖完成后依赖列表中的aiohttp、rich等库即可用于下载与进度显示git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt浏览器兜底和 Cookie 自动获取依赖 Playwright建议一并安装否则翻页被风控时无法人工过验证pip install playwright python -m playwright install chromium第二步配置与 Cookie 获取仓库根目录提供了示例配置复制一份作为正式配置文件cp config.example.yml config.yml打开config.yml把link换成你要下载的链接确认path下载目录默认./Downloaded/和mode默认post。Cookie 获取使用 tools/ 下的命令行工具它会弹出浏览器窗口python -m tools.cookie_fetcher --config config.yml在弹出的浏览器中登录抖音回到终端按回车工具会自动把 Cookie 写入config.yml的cookies字段无需手动复制。第三步执行第一次下载并确认结果用配置驱动执行下载python run.py -c config.yml也可以用命令行参数临时追加链接和参数-u追加链接、-t指定并发、-p指定目录python run.py -c config.yml -u https://www.douyin.com/video/xxxx -t 8 -p ./Downloaded运行结束后检查两件事Downloaded/目录下出现对应视频文件工作目录生成了dy_downloader.dbdatabase: true时的下载历史库。默认每个作品一个独立子目录命名遵循filename_template默认{date}_{title}_{id}。 按场景操作场景一保存单个视频目标把一个抖音视频无水印保存到本地。怎么做把视频链接或 App 分享出来的v.douyin.com短链写进配置其余保持默认link: - https://www.douyin.com/video/xxxx video: true cover: true # 同时保存封面然后运行python run.py -c config.yml。你会得到什么视频 mp4 文件cover: true时同目录附带_cover.jpg需要原始数据可加json: true生成_data.json。场景二收集作者全部作品支持时间范围目标把某作者主页的作品按数量或全量拉下来之后可反复增量更新。怎么做配置主页链接与模式number.post: 0表示不限数量配合start_time/end_timeYYYY-MM-DD格式可只取某段时间内的作品link: - https://www.douyin.com/user/xxxx mode: - post number: post: 0 start_time: 2024-01-01 end_time: 2024-06-30 thread: 5 increase: post: true你会得到什么Downloaded/{作者名}/post/下每个作品一个子目录含视频文件按video_quality选档默认取最高转码档可选original探测原片。因为increase.post: true再次运行同一配置时磁盘上已存在的作品会被跳过只补新内容。场景三备份一个合集目标把某个合集里的视频完整存下来。怎么做合集链接可以直接解析不需要配mode也可以给作者主页链接加mode: [mix]批量处理其名下全部合集link: - https://www.douyin.com/collection/xxxx folderstyle: true你会得到什么合集内各视频按同样的命名规则落入mix/结构folderstyle: true保证每件作品独立成目录方便后续整理。多个模式可以同时配如postmix同一作品跨模式不会重复下载。 进阶能力速览REST API 服务模式装好fastapi uvicorn后python run.py --serve --serve-port 8000通过POST /api/v1/download提交任务、GET /api/v1/jobs/{job_id}查询进度方便被其他程序调用。直播录制link指向live.douyin.com/{room_id}即开始录制live.max_duration_seconds: 0表示录到主播下播为止中断或下播时已录部分会保留为 FLV 文件。视频转写transcript.enabled: true并设置OPENAI_API_KEY环境变量后每个视频旁生成.transcript.txt和.transcript.json。评论采集comments.enabled: true为每个作品生成*_comments.jsoninclude_replies: true可带上二级回复。热搜榜与搜索python run.py --hot-board 30 -p ./Downloaded输出前 30 热搜python run.py --search 关键词 --search-max 100 -p ./Downloaded输出搜索结果均为 JSONL 文件。完成通知notifications配置支持 Bark、Telegram、Webhook 推送下载结束自动提醒。⚠️ 常见坑与对策只下到约 20 个作品这是抖音翻页风控行为接口不再返回后续页。确认browser_fallback.enabled: true且headless: false在弹出的浏览器窗口里手动完成验证作品列表会在页面内继续加载不要提前关闭窗口。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;速度慢或被限流默认并发 5、限速 2 请求/秒。网络不稳时把thread降到 3或给proxy配一个代理地址进度刷屏影响阅读时保持progress.quiet_logs: true。⚖️ 使用边界下载内容仅用于个人学习、研究和个人数据管理不用于传播、商用或侵犯他人版权。控制下载频率与批量规模遵守抖音平台的使用条款。因平台接口调整导致部分功能失效属于正常技术风险使用者自行承担使用本工具产生的风险。完整字段说明可参考仓库根目录的 config.example.yml每个配置项旁都有中文注释更详细的输出目录结构和 FAQ 见 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），仅供参考