DouK-Downloader 完整指南：免费批量下载抖音作品、采集评论与直播录制，一篇讲透

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

DouK-Downloader 是一款完全开源免费的抖音 / TikTok 作品下载与数据采集工具，适合想保存视频的个人用户和需要定期采集账号内容的创作者。它能批量下载作品、抓取评论并落盘成 CSV、XLSX 或 SQLite，还能调用 FFmpeg 录制直播。

5 分钟跑通：从 clone 到第一次下载

源码运行需要 Python 3.12+，装依赖用 uv 或 pip 都行：

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

不想折腾环境的，Mac 和 Windows 用户可以直接到项目发布页下载编译好的main可执行文件，解压双击就能跑。

首次运行有三步一次性动作：

• 第一步：启动后按提示接受免责声明。
• 第二步：在主菜单选"从剪贴板读取 Cookie (抖音)"，按 Cookie 获取教程 从抖音网页版复制一份 Cookie 粘贴进去。Cookie 只需配一次，失效了再更新。
• 第三步：返回主菜单选"终端交互模式"，进入"批量下载链接作品"，粘贴一条抖音作品链接。

看到文件出现在本地文件夹，说明整条链路通了。

三个高频场景：批量下载链接作品、定期采集账号作品、评论落盘

粘贴几条链接，批量下载作品到本地

你想保存几条视频 → 进"批量下载链接作品"，链接粘进去就行，支持图集、实况和原画。

想让视频连音乐一起存下来，把settings.json里的音频提取打开：

"music": true

坑提示：下到的视频清晰度偏低，九成是 Cookie 没登录或过期了，重新抓一份登录态 Cookie 即可。

定期抓取某账号的全部作品

你想持续跟踪一个账号的新内容 → 在settings.json的accounts_urls里预置账号，以后每次运行都是增量下载：

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

tab取post（发布）、like（喜欢）、favorite（收藏），earliest/latest可按发布时间筛；已下载的文件会自动跳过。进阶一句：mark是自定义标识，作者改昵称后文件名也会跟着自动更新。

采集作品评论，把数据存成 CSV

你想拿到评论数据而不是视频 → 先改storage_format，再把采集到的评论落盘：

"storage_format": "csv"

取值为csv、xlsx或sqlite，作品、评论、搜索结果都会持久化到Volume目录；留空就是不记录数据。坑提示：不配这一项，所有数据类功能都等于白跑。

关键配置：settings.json 只动这几处就够

所有行为都由根目录的settings.json控制，首次运行会自动生成。新手最常碰的就是这几个键：

• folder_name/name_format：默认存Download文件夹，文件名格式create_time type nickname desc→ 改成你想要的目录和命名 → 决定文件落到哪、长什么样
• music：默认false→ 改成true→ 下载作品时同步提取音频
• storage_format：默认空（不记录）→ 改成csv/xlsx/sqlite→ 采集数据开始落盘
• proxy：默认空 → 填代理地址 → 请求走代理，数据量大或被限流时再用
• timeout/max_retry：默认 10 秒超时、重试 5 次 → 网络差就把timeout调大 → 慢网也能跑完，但别为了快把重试和并发往死里调

改完settings.json必须重启程序才生效。

进阶：把 DouK-Downloader 变成 API 服务，接入你的工作流

主菜单选"Web API 模式"启动后，服务监听 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": "作品ID", "pages": 2}, headers={"token": "你的token"}, ) print(response.json())

端点命名规律是/douyin/xxx和/tiktok/xxx，最常用的两个是/douyin/detail（作品详情）和/douyin/comment（评论采集），配合系统定时任务跑，就是一个无人值守的采集管道。

📌 别踩的坑：批量下载与数据采集的高频问题

• 只能下到低分辨率视频→ Cookie 未登录或已过期 → 重新按教程抓一份登录态 Cookie 写入配置
• 请求失败、返回空数据→ Cookie 失效或 IP 被限流 → 更新 Cookie，必要时在settings.json配置proxy
• TikTok 功能不可用→ 缺少device_id等浏览器指纹参数 → 按教程补齐browser_info_tiktok
• 私密账号的作品下不了→ 未登录，或登录账号没关注该账号 → 换一份已关注该账号的登录态 Cookie
• 改了配置没效果→ 没重启程序 → 修改settings.json后重启再试

操作约定记一下：程序提示输入时，直接回车是返回上级菜单，输入Q退出；运行中要停止请Ctrl + C，别直接关终端窗口。

边界与下一步

本项目按 GNU GPL v3.0 协议开源，采集的数据仅供个人学习研究使用，请勿用于未经授权的内容传播或商业抓取，付费内容不在支持范围内。README 也明确：内置加密参数算法已停止维护，部分接口失效时以项目最新文档为准。现在就能做的下一步：跑一遍上面的 5 分钟流程，把一条作品链接下到本地，再把storage_format改成csv体验数据落盘。更多细节看 Cookie 获取教程 和 DouK-Downloader 文档。

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