企业官网建设流程全解析

DouK-Downloader 入门完全教程：4 步免费批量下载抖音视频、账号作品与直播回放

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

DouK-Downloader（历史名称 TikTokDownloader）是一款完全开源的抖音视频批量下载工具，一个程序同时管住抖音和 TikTok 两个平台：贴个链接存单条作品、把某个博主的全部视频批量存下来、用 FFmpeg 录直播、采集评论和热榜数据，全部免费。这篇文章带你从零开始，一步步把它跑起来。

DouK-Downloader 能做什么：先花一分钟了解全貌

用三句话概括它的能力：

• 存文件：单条作品链接、图集、账号发布/喜欢/收藏的全部作品、合集作品，都能批量下载，还支持下载动态封面、断点续传、自动跳过已下载过的视频；
• 录直播：自动解析直播拉流地址，调用 FFmpeg 把整场直播录成回放文件；
• 采数据：作品评论、账号详情、搜索结果、抖音热榜，都能按页采集，并保存成 CSV / XLSX / SQLite 三种格式。

程序有三种运行方式：终端交互模式（菜单式操作，新手首选）、后台监听模式（盯着剪贴板，复制作品链接即自动下载）、Web API 模式（把采集能力封装成 HTTP 接口，供你自己的程序调用）。

准备工作：安装 DouK-Downloader 并写入抖音 Cookie

所有功能都共用这一套环境，只需做一次。

两种安装方式，挑一种就行

方式一：直接用预编译版本（最省事）

到项目 Releases 页面下载 Windows / macOS 平台的可执行文件压缩包，解压后双击main即可运行。macOS 用户注意：首次运行前先在终端执行xattr -cr 项目文件夹路径移除安全标记，因为未签名的可执行文件会被系统拦一下。

方式二：从源码安装

先装好 3.12 及以上版本的 Python，然后克隆源码并同步依赖：

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

程序第一次启动会先展示免责声明，按提示输入对应内容即可进入主菜单，随后程序会在根目录生成一份配置文件settings.json——后面所有个性化设置都改这个文件。

5 分钟拿到抖音 Cookie 并写入程序

Cookie 是浏览器登录抖音后留下的一段身份凭证。没有它，程序只能拿到低清晰度视频；有了它，才算"持票入场"。获取步骤：

1. 浏览器打开抖音网页版并登录，按F12打开开发者工具；
2. 切到"网络"选项卡，在筛选框输入cookie-name:odin_tt；
3. 点开任意一个作品的评论区，选中一个数据包，全选复制Cookie的值。

回到程序，选择"手动输入 Cookie (抖音)"粘贴，或先把 Cookie 放进剪贴板再选"从剪贴板读取 Cookie (抖音)"。写入成功后程序会一直沿用，只有失效时才需要重新写入（失效的典型信号：视频清晰度变差、请求开始失败）。更多方法可查阅项目内的 Cookie 获取教程。

一个容易混淆的快捷键先记住：菜单输入时直接回车 = 返回上级菜单，输入Q= 退出程序。

第一次实战：用链接保存单个抖音视频

现在来跑通第一个任务——存一条刚刷到的视频。

主菜单选择"终端交互模式"，进入功能菜单：

接着选择**"批量下载链接作品(抖音)"，再选"手动输入待采集的作品链接"**，把作品链接粘贴进去回车。带"复制此链接"的分享口令也可以识别。视频文件会落到程序根目录的Download文件夹里；如果在settings.json里把dynamic_cover和static_cover都设为true，还能把动态、静态封面图一并存下来。

几个小细节：

• 粘贴的链接里别带换行符，否则解析容易翻车；
• 图集作品会拆成多张图片保存，这是正常的；
• 想边刷边存的话，主菜单的"后台监听模式"会持续监听剪贴板，复制即下载。

系统存下一个账号的作品与合集，还能自动增量

这是最省时间的功能：把"想收藏整个博主"从手动点按变成一条链接的事。

1. 菜单选择**"批量下载账号作品(抖音)"（要存合集就选"批量下载合集作品(抖音)"**）；
2. 粘贴账号主页链接或合集链接，程序自动解析出账号信息；
3. 账号模式下选择内容类型：发布 / 喜欢 / 收藏 / 收藏夹；
4. 可以填写earliest/latest限定时间范围，只下指定区间内的作品；
5. 确认后多线程并发下载，已下载的作品 ID 会被记录，下次运行自动跳过——也就是天然的增量更新。

想长期跟踪某些账号，可以直接登记进settings.json，之后每次启动程序都自动处理它们：

"accounts_urls": [ { "mark": "我关注的博主", "url": "https://www.douyin.com/user/xxx", "earliest": "2024-01-01", "enable": true } ]

合集同理，填mix_urls字段即可（mark、url、enable三项就够）。隔三差五跑一次，每次只存新增的作品，内容库自己会长大。

两个要注意的点：

• 喜欢/收藏作品平台只返回发布日期，程序需要拉全量再筛选，作品多时比较耗时，可用max_pages限制请求页数；
• 私密账号的作品，要求 Cookie 来自一个已关注该账号的登录态。

另外博主改名也不用担心：昵称或标识变化时，程序会自动更新已下载文件名里的对应部分。

TikTok 平台下载账号作品时，还需要额外配置device_id参数，获取方式和 Cookie 类似，也是在开发者工具里找到对应字段复制：

用 FFmpeg 把错过的抖音直播录成回放

直播这个功能分两半：程序负责找到推流地址，真正录文件的是 FFmpeg。所以第一步是配置：在settings.json的ffmpeg字段填入本机 FFmpeg 的完整路径。没配置的话，程序会提示"未检测到有效的 ffmpeg，不支持直播下载功能"。

配置好之后：

1. 菜单选择**"获取直播拉流地址(抖音)"**；
2. 粘贴直播间分享链接，程序解析出直播数据并列出清晰度（如 FULL_HD1、HD1、SD1）；
3. 输入清晰度名称或对应序号，程序立刻调用 FFmpeg 开始录制；
4. 直播结束后文件自动落盘到下载目录。

操作上的两个提醒：清晰度提示时直接回车 = 只要拉流地址、不开始录制；中途想停，按Ctrl + C，不要直接关终端窗口。

采集评论与热榜数据，顺手做点分析

如果你要的是数据而不是文件，这两个入口很直接：

• "采集作品评论数据(抖音)"：粘贴作品链接，程序按页采集评论与回复；
• "采集抖音热榜数据(抖音)"：无需任何输入，直接采集当前热榜。

采集结果支持保存为CSV / XLSX / SQLite（由settings.json的storage_format字段决定），导进表格或数据库就能做后续分析。评论特别多的作品建议限制采集页数，别一口气拉完；程序内置了智能延时请求机制来保护请求频率，不建议自行调高。

进阶玩法：把采集能力封装成 Web API 服务

如果你有自己的爬虫管线或后端，不想每次开终端手动操作，可以用Web API 模式把下载/采集能力做成一个常驻服务：

1. 主菜单选择"Web API 模式"启动；
2. 浏览器访问http://127.0.0.1:5555/docs，能看到自动生成的接口文档。

常用接口都有对应端点：POST /douyin/detail（单作品）、POST /douyin/account（账号作品）、POST /douyin/mix（合集）、POST /douyin/live（直播）、POST /douyin/comment（评论）等，发一个 HTTP 请求就能拿到结构化数据：

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

仓库自带 Dockerfile，把5555端口映射出来即可部署到服务器长期运行。两点提醒：修改settings.json后要重启程序才生效；Docker 容器访问不到宿主机文件系统，个别依赖本地文件的功能在容器里不可用。

出问题了怎么办：按症状自查

配置项比较多时，建议对照 全部配置项定义 逐一核对；不熟悉 JSON 编辑器的话，改完用在线格式化工具校验一下再重启。

想继续深入：从这三处读起

跑通之后再往下看代码就不难了。三个最值得关注的目录：

• src/downloader/：下载核心逻辑，文件断点续传、完整性校验都在这里；
• src/extract/：数据提取层，把接口返回的原始数据整理成结构化模型；
• src/interface/：各平台接口实现，抖音与 TikTok 分别对应，想加功能从这里入手最快。

最后说句题外话：请遵守平台规则与版权要求，只下载用于个人学习、研究的公开内容。把"手动点保存"变成一条链接、一份配置、一个定时任务，DouK-Downloader 的这部分工作就算完成了。

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