抖音 TikTok 作品下载与数据采集指南：用 DouK-Downloader 免费批量下载作品、采集评论与直播

抖音 TikTok 作品下载与数据采集指南：用 DouK-Downloader 免费批量下载作品、采集评论与直播

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

DouK-Downloader 是一款完全开源免费的抖音 / TikTok 作品下载与数据采集工具。它能帮你下载单条作品、批量抓取账号作品、提取音乐、录制直播，并把采集到的数据存成 CSV、XLSX 或 SQLite。适合想保存视频的个人用户、需要定期采集账号内容的创作者，以及想用接口调用的开发者。

跑起来：装好环境并完成首次下载

程序基于 Python 3.12+，请求层使用 HTTPX。源码运行方式如下（Mac、Windows 用户也可以直接到项目发布页下载已编译的main可执行文件，解压双击即可，Mac 首次运行需在终端执行xattr -cr 项目文件夹路径解除安全限制）：

git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader uv sync --no-dev # 或 pip install -r requirements.txt uv run main.py # 或 python main.py

启动后按提示接受免责声明，然后把 Cookie 写入配置文件。获取方法：用浏览器打开抖音网页版，按 F12 进入开发者工具，在"网络"选项卡勾选"保留日志"，筛选器输入cookie-name:odin_tt，点击任意作品评论区，复制请求里的完整 Cookie，粘贴进程序即可。

Cookie 只需配置一次，失效时再更新。注意登录态的 Cookie 能下载到更高分辨率的视频，也决定了很多功能能否使用。返回主菜单，选择"终端交互模式"里的"批量下载链接作品"，粘贴一条抖音链接，文件就会落到本地文件夹——第一次下载就跑通了。

按你的目标找功能

不用背功能清单，按目标对号入座即可。以下能力在终端交互模式和 Web API 模式下大部分都能用，TikTok 平台的部分能力需要额外初始配置（device_id等，方法见docs/Cookie获取教程.md末尾的截图说明）。

批量下载账号作品时，建议在settings.json的accounts_urls里预置账号，而不是每次手输：

"accounts_urls": [ { "mark": "美食博主", "url": "https://www.douyin.com/user/xxx", "tab": "post", "earliest": "", "latest": "", "enable": true } ]

mark是自定义标识（昵称变了文件名也会跟着自动更新），tab取post（发布）、like（喜欢）、favorite（收藏），earliest/latest用于按发布时间筛选。下载的文件默认先进临时目录，完整后才移入目标文件夹，避免半截文件。

改 settings.json 里的 5 个键

所有行为都由程序根目录下的settings.json控制，改完重启生效。首次运行会自动生成带默认值的文件。最值得动的五个键：

• folder_name/name_format：默认存到Download文件夹，文件名格式为create_time type nickname desc（desc_length默认 64 个字符，name_length默认 128）。想让文件名更干净，改这里就够了。
• music：默认false，设为true后下载作品时同步提取音频，配合storage_format可只留音频文件。
• storage_format：默认空（不记录数据）。设为csv、xlsx或sqlite后，采集的作品、评论、搜索结果才会持久化到Volume目录，这是数据类功能的前提。
• proxy/proxy_tiktok：请求走代理。数据量大、被限流时再配，平时留空即可。
• timeout/max_retry：默认 10 秒超时、重试 5 次，网络差的环境可以把timeout调大，同时留意内置的智能延时机制（避免请求过频被平台限流），不要为了快把重试和并发往死里调。

下载性能相关还有chunk（单次接收数据块大小，默认 2MB）和max_size（单文件上限，默认 0 即不限制），一般无需改动。TikTok 侧的浏览器指纹参数（browser_info_tiktok里的device_id等）缺失时，TikTok 功能会受限，获取方式参考docs/Cookie获取教程.md：

接入接口：把下载能力变成服务

选"Web API 接口模式"启动后，服务默认监听127.0.0.1:5555，浏览器访问http://127.0.0.1:5555/docs可查看自动生成的接口文档。接口通过请求头token鉴权，示例（采集某作品 2 页评论）：

from httpx import post response = post( "http://127.0.0.1:5555/douyin/comment", json={"detail_id": "0123456789", "pages": 2}, headers={"token": "你的token"}, ) print(response.json())

常用端点覆盖链接解析、作品详情、账号作品、评论采集、直播地址、搜索、热榜等，命名规律是/douyin/xxx和/tiktok/xxx，部署到服务器后可供局域网其他设备调用。

出问题时先查这里

另有两点约定：程序提示输入时，直接回车是返回上级菜单，输入Q退出；运行中要停止请用Ctrl + C，不要直接关终端窗口。

边界与下一步

本项目按 GNU GPL v3.0 协议开源，使用即需遵守该协议；采集的数据仅供个人学习研究使用，请勿用于未经授权的内容传播或商业抓取，付费内容不在支持范围内。README 也明确：内置加密参数算法已停止维护，部分接口可能失效，遇到时以项目最新文档为准。

下一步：跑一遍上面的"快速跑通"，把一条作品链接下到本地；之后打开settings.json改storage_format和folder_name，体验数据落盘和自定义目录。更多细节看仓库内的docs/Cookie获取教程.md和项目 Wiki。

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