抖音TikTok批量下载完整指南:三步跑起来
2026/9/11 10:11:57 网站建设 项目流程

抖音TikTok批量下载完整指南:三步跑起来

【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader

DouK-Downloader 是一款完全开源的抖音 / TikTok 内容采集工具,能把两个平台的账号作品、合集、直播、评论数据批量下载到本地,适合有基本命令行经验、想沉淀公开内容的用户。

📊 能力矩阵

功能模块支持平台 / 范围一句话亮点
账号作品下载抖音:发布 / 喜欢 / 收藏 / 收藏夹;TikTok:发布 / 喜欢多账号批量,自动跳过已下载文件
合集 / 合辑下载抖音合集、TikTok 合辑整辑归档,支持增量更新
直播录制抖音 / TikTok 直播间解析推流地址,调用 FFmpeg 多清晰度录制
单作品下载抖音视频 / 图集 / 实况;TikTok 视频 / 图集 / 原画最高画质,临时目录 + 移动机制保完整
数据采集导出评论 / 账号 / 搜索 / 热榜 / 作品详情CSV / XLSX / SQLite 三种格式落盘
WebAPI 接口双平台全功能FastAPI 自动生成文档,HTTP 即可调用

技术栈:Python 3.12+ 异步框架,基于httpx发起请求,FastAPI承载 WebAPI,Rich渲染终端界面,可用uv一键装依赖,也支持 Docker 容器部署。核心代码集中在 接口层(各平台 API 调用)、下载引擎(文件下载与完整性处理)、配置管理(settings.json参数校验)。

🚀 最短启动路径

第 1 步:克隆仓库并安装依赖(需 Python 3.12+,推荐 uv 包管理器)

git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader uv sync --no-dev uv run main.py

第 2 步:写入 Cookie。首次运行会读取免责声明,根据提示写入 Cookie 即可。

第 3 步:进入主菜单,选择「终端交互模式」,即可使用批量下载链接作品、采集评论等功能。偏好容器化可以改用docker pull joeanamier/tiktok-downloader拉取镜像,docker run -p 5555:5555 -v douk_data:/app/Volume挂载数据卷运行。

⚙️Cookie 获取三步法:① 浏览器登录抖音网页版(登录态直接影响视频分辨率);② 按F12打开开发者工具,切到「网络」选项卡,在筛选器输入cookie-name:odin_tt,刷新页面后复制任意请求的Cookie值;③ 回到程序选「从剪贴板读取 Cookie」,粘贴保存。Cookie 只需失效后重写,不必每次运行都配。TikTok 采集还需要device_id等参数,获取方式与 Cookie 类似,参考下图:

🧩 核心能力拆解

批量下载引擎

  • 定义:多线程异步下载,文件先落到临时目录、完成后才移入存档目录,天然支持断点续传与完整性校验。
  • 典型场景:批量下载 200 个作品途中断网,重启程序后已完成的文件自动跳过。
  • 最短操作:终端交互模式 →「批量下载链接作品」→ 粘贴作品链接。

账号与合集采集

  • 定义:按账号主页 / 合集 / 合辑链接遍历作品列表,支持时间范围筛选和自定义规则过滤。
  • 典型场景:把一位知识区创作者的全部发布作品归档,含点赞收藏等统计数据。
  • 最短操作:终端交互模式 →「批量下载账号作品」→ 输入主页链接 → 用earliest/latest限定时间范围。

直播录制

  • 定义:解析直播间获取推流地址,调用 FFmpeg 持续录制,可指定清晰度档位。
  • 典型场景:开播提醒后启动录制,把整场直播存成本地视频。
  • 最短操作:终端交互模式 →「获取直播拉流地址」→ 选择清晰度 → 调用 FFmpeg 开始录制,Ctrl + C停止。

数据采集与导出

  • 定义:采集作品、评论、账号、搜索、热榜的结构化数据,按storage_format写入 CSV / XLSX / SQLite。
  • 典型场景:每周导出某话题作品的评论数据做词频分析。
  • 最短操作:终端交互模式 →「采集作品评论数据」→ 粘贴作品链接;配置文件中设storage_formatcsvxlsxsqlite

WebAPI 接口

  • 定义:FastAPI 服务监听 5555 端口,所有采集功能暴露为 HTTP 接口并自动生成交互文档。
  • 典型场景:定时脚本每天调用接口拉取账号新作品,接入自己的工作流。
  • 最短操作:启动时选「Web API 模式」→ 浏览器访问http://127.0.0.1:5555/docs→ 带token请求头调用/douyin/detail/douyin/account/douyin/comment等端点。

后台监听

  • 定义:常驻进程按配置轮询账号与合集,新作品自动下载,增量更新无需人工干预。
  • 典型场景:程序跑在家里服务器上,关注的合集每周一更新,新集自动进库。
  • 最短操作:启动时选「后台监听模式」,提前在settings.jsonaccounts_urls/mix_urls数组里填好链接与标识。

🔄 端到端工作流

工作流一:账号作品批量归档

触发条件:想把某创作者的全部公开作品保存到本地。

  1. 按上文方法写入已登录的 Cookie
  2. 运行uv run main.py,选「终端交互模式」→「批量下载账号作品」
  3. 粘贴创作者主页链接,选择「发布」标签页
  4. (可选)在settings.jsonfolder_modetrue,按创作者分子文件夹
  5. 等待下载完成,程序记录已下载作品 ID,重复运行自动去重

预期产出:媒体文件按name_format规则存放在root目录下,作品统计信息一并落盘,断网重跑不会重复下载。


工作流二:合集持续增量追新

触发条件:某个合集每周更新,希望新集自动入库。

  1. settings.jsonmix_urls数组添加合集链接,enable设为true
  2. 为合集设置自定义mark标识,便于归档和后续重命名
  3. 启动「后台监听模式」,程序按内置智能延时定期轮询
  4. 创作者改昵称时,程序自动更新已下载文件中的昵称和标识

预期产出:合集全部作品增量归档到本地,旧文件不重复、命名始终与最新昵称一致。


工作流三:WebAPI 接入评论数据管线

触发条件:需要定期导出评论数据做分析,终端交互不方便。

  1. 启动 Web API 模式,访问http://127.0.0.1:5555/docs确认参数
  2. httpx.post调用/douyin/commenttoken请求头 + 作品 ID 和页数的 JSON 请求体
  3. 解析返回的 JSON,追加写入本地 CSV 或导入 SQLite
  4. 用 cron 或系统任务计划把脚本挂成每日定时任务

预期产出:可持续积累的评论数据集,直接喂给后续统计或可视化脚本。

🛠️ 调优 & 避坑

settings.json里对体验影响最大的参数:

参数默认值作用建议值
root空(程序目录)下载存档根目录指向独立磁盘分区,避免与源码混放
name_formatcreate_time type nickname desc文件名拼接规则保持默认;重名多时改用desc nickname
folder_modefalse按创作者 / 合集分子文件夹批量归档时设true
max_size0(不限)单文件大小上限直播录制场景建议设上限,防止异常大文件
proxy请求代理采集 TikTok 或频繁限流时配置
max_pages0(不限)列表最大请求页数采集喜欢 / 收藏作品时设 10~20 控制耗时

关键行示例(只改需要的行,改完重启程序生效):

"root": "D:/douk", // 存档根目录 "name_format": "create_time nickname desc", // 文件命名 "folder_mode": true // 分子文件夹归档

常见问题:

症状原因解法
只能下到中低画质Cookie 未登录或权限不足重新获取已登录账号的 Cookie 并写入
请求数据失败、报错Cookie 已失效按教程更新 Cookie,失效后才需重写
TikTok 采集无数据device_id等参数按启动路径中的示例图补全browser_info_tiktok配置
下载慢、频繁超时网络限速或海外线路差配置proxy,保持内置智能延时不要关闭
磁盘被占满直播录制或高清作品体积大max_size上限,用root+folder_mode定期归档

⚖️ 使用边界

  • 版权:仅将公开内容保存用于个人学习、研究,下载的作品不要二次分发或商用。
  • 平台规则:程序内置智能延时机制控制请求频率,不要关闭延时或大量多开实例做高频抓取。
  • 隐私:不采集、不传播涉及他人隐私的内容;Cookie等同账号凭证,不要泄露给他人或贴到公开场合。
  • 数据安全:媒体与采集数据默认全部落在本地root目录,自行保管;WebAPI 开启了token认证,5555 端口不要直接暴露到公网。

📚 仓库与文档入口

一条命令把抖音 TikTok 的作品、合集、直播变成本地存档。完整说明见 README.md,Cookie 细节见 docs/Cookie获取教程.md;遇到 Bug 欢迎提 Issue,有余力欢迎提 PR 参与开发。

【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询