抖音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_format为csv、xlsx或sqlite。
WebAPI 接口
- 定义:FastAPI 服务监听 5555 端口,所有采集功能暴露为 HTTP 接口并自动生成交互文档。
- 典型场景:定时脚本每天调用接口拉取账号新作品,接入自己的工作流。
- 最短操作:启动时选「Web API 模式」→ 浏览器访问
http://127.0.0.1:5555/docs→ 带token请求头调用/douyin/detail、/douyin/account、/douyin/comment等端点。
后台监听
- 定义:常驻进程按配置轮询账号与合集,新作品自动下载,增量更新无需人工干预。
- 典型场景:程序跑在家里服务器上,关注的合集每周一更新,新集自动进库。
- 最短操作:启动时选「后台监听模式」,提前在
settings.json的accounts_urls/mix_urls数组里填好链接与标识。
🔄 端到端工作流
工作流一:账号作品批量归档
触发条件:想把某创作者的全部公开作品保存到本地。
- 按上文方法写入已登录的 Cookie
- 运行
uv run main.py,选「终端交互模式」→「批量下载账号作品」 - 粘贴创作者主页链接,选择「发布」标签页
- (可选)在
settings.json设folder_mode为true,按创作者分子文件夹 - 等待下载完成,程序记录已下载作品 ID,重复运行自动去重
预期产出:媒体文件按name_format规则存放在root目录下,作品统计信息一并落盘,断网重跑不会重复下载。
工作流二:合集持续增量追新
触发条件:某个合集每周更新,希望新集自动入库。
- 在
settings.json的mix_urls数组添加合集链接,enable设为true - 为合集设置自定义
mark标识,便于归档和后续重命名 - 启动「后台监听模式」,程序按内置智能延时定期轮询
- 创作者改昵称时,程序自动更新已下载文件中的昵称和标识
预期产出:合集全部作品增量归档到本地,旧文件不重复、命名始终与最新昵称一致。
工作流三:WebAPI 接入评论数据管线
触发条件:需要定期导出评论数据做分析,终端交互不方便。
- 启动 Web API 模式,访问
http://127.0.0.1:5555/docs确认参数 - 用
httpx.post调用/douyin/comment,token请求头 + 作品 ID 和页数的 JSON 请求体 - 解析返回的 JSON,追加写入本地 CSV 或导入 SQLite
- 用 cron 或系统任务计划把脚本挂成每日定时任务
预期产出:可持续积累的评论数据集,直接喂给后续统计或可视化脚本。
🛠️ 调优 & 避坑
settings.json里对体验影响最大的参数:
| 参数 | 默认值 | 作用 | 建议值 |
|---|---|---|---|
root | 空(程序目录) | 下载存档根目录 | 指向独立磁盘分区,避免与源码混放 |
name_format | create_time type nickname desc | 文件名拼接规则 | 保持默认;重名多时改用desc nickname |
folder_mode | false | 按创作者 / 合集分子文件夹 | 批量归档时设true |
max_size | 0(不限) | 单文件大小上限 | 直播录制场景建议设上限,防止异常大文件 |
proxy | 空 | 请求代理 | 采集 TikTok 或频繁限流时配置 |
max_pages | 0(不限) | 列表最大请求页数 | 采集喜欢 / 收藏作品时设 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),仅供参考