抖音 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

2. 首次启动选择语言、确认免责声明，进入主菜单
3. 写入 Cookie——浏览器登录后留下的一段身份凭证，程序靠它换取高清数据：登录抖音网页版，按 F12 打开开发者工具，"网络"选项卡筛选cookie-name:odin_tt，点开任一作品评论区，复制任意请求的完整 Cookie 值（图文步骤见 docs/Cookie获取教程.md）

4. 主菜单选"从剪贴板读取 Cookie (抖音)"，回车确认，凭证写入配置文件
5. 选"终端交互模式"→"批量下载链接作品(抖音)"→"手动输入待采集的作品链接"，粘贴链接回车，可连续粘贴多条
6. 文件统一存入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拉喜欢 / 收藏内容

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

3. 合集归档同理：把链接登记进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