抖音 TikTok 作品批量下载与账号数据归档:DouK-Downloader 交付物清单

发布时间:2026/11/2 15:10:20
抖音 TikTok 作品批量下载与账号数据归档:DouK-Downloader 交付物清单

抖音 TikTok 作品批量下载与账号数据归档:DouK-Downloader 交付物清单

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

DouK-Downloader(曾用名 TikTokDownloader)是一款开源的抖音 / TikTok 批量下载工具,面向需要备份视频或做数据采集的个人用户。粘贴作品链接即可把高清视频、图集存到本地,账号整库归档、直播录制、评论采集都能自动完成。它最终交付两类产物:视频与图片文件,以及 CSV、Excel、SQLite 格式的结构化数据文件。

先看清它交付什么

  • 视频与图集文件落盘到项目根目录的Download文件夹(文件夹名、命名规则可改),文件名默认按"发布时间 + 作者昵称 + 简介"拼装
  • 作品、账号、评论、搜索结果等采集数据,按storage_format指定的格式落盘为表格或数据库文件
  • 已下载的作品 ID 记录在本地,重复链接、已存在的文件自动跳过
  • 全部行为由根目录一个settings.json控制,改完重启程序生效

把分享链接的作品批量存进本地

适用情况:手里有一批网页版分享链接,或 App 里"复制链接"得到的带口令文本,想一次性存成本地文件。

  1. 克隆仓库,安装 Python 3.12 及以上解释器,用 uv 同步依赖后启动:
git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader uv sync --no-dev uv run main.py
  1. 首次启动选择语言、确认免责声明,进入主菜单
  2. 写入 Cookie——浏览器登录后留下的一段身份凭证,程序靠它换取高清数据:登录抖音网页版,按 F12 打开开发者工具,"网络"选项卡筛选cookie-name:odin_tt,点开任一作品评论区,复制任意请求的完整 Cookie 值(图文步骤见 docs/Cookie获取教程.md)

  1. 主菜单选"从剪贴板读取 Cookie (抖音)",回车确认,凭证写入配置文件
  2. 选"终端交互模式"→"批量下载链接作品(抖音)"→"手动输入待采集的作品链接",粘贴链接回车,可连续粘贴多条
  3. 文件统一存入Download文件夹

不想手动粘贴的话,主菜单选"后台监听模式",程序持续盯住剪贴板,你复制链接它自动下载;按 Ctrl+C 或把剪贴板内容设为close停止。

容易卡住的地方:

  • 链接里带换行导致解析异常:粘贴后先删掉空行再回车
  • 图集作品被拆成多张图片:这是正常行为,非下载失败
  • 只下到低清晰度:Cookie 失效,重新从浏览器复制一份写入

把整个账号的作品持续归档到本地

适用情况:想长期跟踪某账号,每次运行只补新作品——第一次全量拉取后,程序靠记录的作品 ID 做增量下载。

  1. 打开settings.json,在accounts_urls字段登记要跟踪的主页链接:
"accounts_urls": [{ "mark": "博主昵称", "url": "https://www.douyin.com/user/xxx", "earliest": "2024-01-01", "enable": true }]

mark——账号标识,会出现在文件名里;url——主页地址;enable——启用开关;earliest/latest——只拉时段内的作品;tab——填favorite或collection拉喜欢 / 收藏内容

  1. 运行程序,选"批量下载账号作品(抖音)"→"使用 accounts_urls 参数的账号链接(推荐)",多线程下载开始

  1. 合集归档同理:把链接登记进mix_urls字段,填mark、url、enable三项,走"批量下载合集作品(抖音)"菜单

容易卡住的地方:

  • 喜欢 / 收藏页只返回发布日期、不返回操作日期,作品多时耗时长:用max_pages字段限制请求页数
  • 私密账号的作品拉不到:写入已关注该账号的登录态 Cookie
  • TikTok 账号归档报参数错误:先在browser_info_tiktok里配置device_id,获取方式与 Cookie 类似(docs/Cookie获取教程.md)

把直播和评论数据落成可检索的文件

适用情况:想录下某场直播,或把作品评论、搜索结果存成可筛选的表格。

  1. 在settings.json填入ffmpeg字段——本机 FFmpeg 可执行文件的完整路径,程序靠它调用 ffmpeg 录制直播
  2. 终端模式选"获取直播拉流地址(抖音)",粘贴直播链接回车,录制开始
  3. 选"采集作品评论数据(抖音)",粘贴作品链接回车;"采集搜索结果数据(抖音)"、"采集抖音热榜数据(抖音)"操作相同
  4. 把storage_format字段填为csv/xlsx/sql——采集结果按对应格式落盘,方便导入表格或数据库

容易卡住的地方:

  • 提示未检测到有效的 ffmpeg:字段为空或路径不对,填入完整路径
  • 评论特别多、采集太慢:同样用max_pages限制页数

把采集能力封装成本地 API 服务

适用情况:想在自己的脚本或服务里调用采集能力,不想再跑终端菜单。

  1. 主菜单选"Web API 模式",本地服务监听 5555 端口
  2. 浏览器访问http://127.0.0.1:5555/docs,查看自动生成的接口文档
  3. 发 POST 请求,拿回结构化 JSON:/douyin/detail(单作品)、/douyin/account(账号作品)、/douyin/mix(合集)、/douyin/live(直播)、/douyin/comment(评论)、/douyin/reply(楼中楼)、/douyin/search/*(搜索);TikTok 对应/tiktok/detail、/tiktok/account

容易卡住的地方:

  • 改了settings.json没有生效:改动需要重启程序
  • 要部署到服务器长期运行:用仓库自带的 Dockerfile 构建镜像并映射 5555 端口

工具不下载付费作品;内置的加密参数算法已过期失效且不再维护,部分功能需要你自行准备参数生成代码才能正常工作(说明见 README)。使用请限于个人学习研究目的,遵守平台规则与版权要求,不传播涉及他人隐私的内容。想理解实现细节,可以从src/downloader/(下载核心)与src/interface/(各平台接口实现)入手。

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

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