抖音下载实操营:5分钟跑通首次无水印下载,3类玩法全掌握
【免费下载链接】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 是一款免费开源的抖音批量下载工具,支持无水印视频、图集、合集与原声音乐保存,还内置直播录制与评论采集。本营带你从 0 到 1 跑通第一次下载,再解锁批量、去重等进阶玩法。
它适合谁:三种典型用法
先对号入座,看看哪条路是你的。
- 📌个人收藏党:追了很久的博主随时可能删作品,收藏不等于拥有。用它把视频、图集、合集整页搬到本地硬盘,无水印、带封面和 BGM,删库也不怕。
- 🔍内容创作者:做选题、做竞品分析,需要原始素材和评论数据。它支持评论抓取(含二级回复)、热搜榜与关键词搜索,结果统一导出为 JSONL,直接进你的分析流程,对应逻辑见 core/discovery.py。
- ⚙️自动化玩家:想把它嵌进自己的工作流,可启动 REST API 服务模式提交任务、查状态,配合下载完成通知(Bark / Telegram / 企业微信 Webhook)和语音转写,形成一条完整的无人值守流水线。
桌面客户端主界面:粘贴抖音链接、识别内容类型,勾选作品/喜欢/合集后一键批量下载
从 0 到 1:跑通你的第一次下载
全程只需一个终端,4 步走完。前提:电脑装有 Python 3.9 及以上版本。
第 1 步:拿到项目,装好依赖
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader pip install -r requirements.txt装得慢或报网络错误,就给 pip 加一句国内镜像源参数,其余不用动。
第 2 步:扫码登录一次,拿到凭证
抖音接口需要登录 Cookie。工具内置了最省事的获取方式:
python -m tools.cookie_fetcher --config config.yml会自动弹出浏览器,你扫码登录一次,回终端按回车,Cookie 就写进本地配置文件了。它只存在你机器上。凭证过期(一般一到两周)时重跑这条命令即可,细节可看 tools/cookie_fetcher.py。
第 3 步:写一份最小配置
复制官方模板,只改链接这一处,其余保持默认:
cp config.example.yml config.yml打开config.yml,把link换成你的视频或主页链接。完整可用项都有中文注释,模板本体在 config.example.yml。
第 4 步:运行,看第一个成果
python run.py -c config.yml几秒后,Downloaded/目录里会出现第一个无水印视频,终端实时打印解析、下载与统计状态。
命令行运行抖音下载:链接解析、任务配置、实时进度统计一目了然
进阶:把重复劳动交给它
按"要解决的问题"分组来看,每组对应配置里的一小段。
问题一:想把一位创作者的主页整页搬走
把link换成主页地址,用mode指定拉哪类内容(post作品 /like点赞 /mix合集 /music音乐),number限定数量,0 表示全量:
mode: [post, mix] number: {post: 50, mix: 0}多线程并行拉取,每个任务独立进度条;不想要全部,再加start_time/end_time按发布时间精准截取一个区间。
抖音批量下载:多个任务并行推进,失败自动重试
问题二:重复下载太费磁盘,文件名乱成一锅粥
两招。第一招是增量去重:工具用 SQLite 记录每个已下载的作品 ID,打开增量开关后,再次下载同一创作者会自动跳过存量,只拉新增:
database: true increase: {post: true}第二招是命名模板:filename_template和folder_template支持{date}、{title}、{id}、{author}等变量自由组合,落盘后按"作者 → 作品"分层归档,找东西像翻档案:
文件命名设置:作者目录、子目录、文件名的模板均可用变量自定义
批量下载完成后的目录结构:每个作品独立文件夹,视频、封面、音乐、元数据齐全
问题三:直播、评论、热搜这些特定内容
- 📺直播录制:
link指向直播间地址即可挂机录制,live.max_duration_seconds设为 0 表示录到主播下播,结束自动收尾。 - 💬评论采集:
comments.enabled: true后,每个作品额外生成一份*_comments.json,含二级回复。 - 🔥热搜与搜索:不走配置,两条命令直接出结果:
python run.py --hot-board 30 -p ./Downloaded python run.py --search "关键词" --search-max 100 -p ./Downloaded直播录制:自动识别直播间、拉取直播流并保存回放
想接进自己的系统:python run.py --serve --serve-port 8000(需先安装 fastapi 和 uvicorn)启动 REST 服务,任务提交与状态查询全部走接口;桌面客户端的任务中心则适合手动跟踪进度。
任务中心:每个下载抖音作品的任务都有状态、耗时与结果记录,支持筛选
常见问题速查
| 现象 | 原因 | 解决办法 |
|---|---|---|
| 报 403 或提示未登录 | Cookie 过期,最常见 | 重跑cookie_fetcher扫码一次;建议每周一更新 |
| 批量下载只抓到约 20 条 | 翻页触发风控 | 保持browser_fallback.enabled: true,弹窗出现后手动过验证,别急着关窗口 |
| 下到一半断了 | 网络中断,属正常情况 | 直接重跑同一条命令,断点续传会跳过已完成文件,只补缺失部分 |
| 速度慢或内存占用高 | 并发线程偏多 | 把thread从 5 调到 3,每批 50~100 个作品分批执行 |
接下来怎么做
- 用一条单个视频链接跑通"克隆 → 扫码 → 配置 → 运行"四步,确认环境无误
- 挑一位你长期关注的创作者,打开
increase增量开关,做一次整页抖音批量下载 - 按需解锁进阶项:时间范围过滤、直播录制、评论采集或 API 服务模式
工具免费开源,代码结构清晰,有 Python 基础就能按自己需求改。跑完上面三格,它就从"试过"变成你的日常了。
【免费下载链接】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),仅供参考