DouK-Downloader 上手指南：30 分钟跑通抖音/TikTok 作品下载与数据采集
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
DouK-Downloader 是一个开源的抖音/TikTok 作品下载和数据采集工具，能批量保存视频、图集、直播，也能把评论、账号、搜索结果导出成结构化数据。适合第一次想在本地留存作品、或做轻度数据采集的人。
先把它跑起来
这一节只解决一件事：程序怎么启动。前置条件是安装不低于 3.12 版本的 Python，并能正常访问抖音/TikTok 服务器。最短路径是用 uv 同步依赖，依次执行：
git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader uv sync --no-dev uv run main.py首次运行会要求阅读免责声明并选择语言，按提示确认即可，随后进入主菜单。
菜单里常用的有三个入口：终端交互模式（编号菜单逐项操作）、后台监听模式（盯住剪贴板，发现作品链接自动下载）、Web API 模式（把功能暴露成 HTTP 接口）。程序提示输入时，直接回车是返回上级菜单，输入 Q 退出。
Cookie 写一次，画质不掉档
没有 Cookie，通常只能下到标清视频，部分数据接口还会直接失败。拿抖音 Cookie 只需四步：
- 浏览器登录抖音网页版；
- 按 F12 打开开发者工具，切到「网络」标签；
- 勾选「保留日志」，刷新页面并进入任意作品，点选一条请求；
- 复制请求头里 Cookie 字段的完整内容。
回到程序选「从剪贴板读取 Cookie (抖音)」，程序会自动读取并写入配置文件，完成后你会看到写入成功的提示。Cookie 只需写这一次，之后不用每次运行都填，失效时重新获取覆盖即可，图文步骤见 Cookie 获取教程。
⚠️ 建议使用已登录账号的 Cookie，高清画质和私密账号数据都依赖它。
按你的目标选路径
这一节把常用任务拆成三种做法，入口都在终端交互模式的编号菜单里。
只想存一条作品
选「批量下载链接作品 (抖音)」，再选「手动输入待采集的作品链接」，粘贴分享链接回车，程序自动解析并保存。TikTok 作品走同名 TikTok 入口。链接多时改用「从文本文档读取」，一次导入整个 txt。完成后文件落在 settings.json 配置的根目录下，终端会显示下载记录。
归档某个账号的全部作品
选「批量下载账号作品 (抖音)」，粘贴创作者主页链接，程序默认采集其发布作品；喜欢、收藏、收藏夹各有独立入口，也支持按时间范围筛选。程序有去重记录，重复运行会跳过已保存的作品，适合定期增量归档。抖音支持发布、喜欢、收藏、收藏夹，TikTok 支持发布和喜欢。
留住一场直播
复制直播间分享链接，选「获取直播推流地址 (抖音)」，选好清晰度后确认，程序自动调用 FFmpeg 开始录制。终止录制按 Ctrl + C，不要直接关终端窗口。
想自动化怎么办
值得知道的入口有两个。一是 Web API 模式：启动后在浏览器访问 http://127.0.0.1:5555/docs 查看自动生成的接口文档，常用端点包括 /douyin/detail（单个作品）、/douyin/account（账号作品）、/douyin/mix（合集作品）、/douyin/comment（评论）、/douyin/live（直播），可以直接在自己的脚本里调用。
二是后台监听模式：把想长期盯住的链接登记进 settings.json 的 mix_urls（合集）或 accounts_urls（账号）字段，程序会自动采集新增内容。评论、账号详情、搜索、热榜四类数据也可以只采不存文件，把 storage_format 设为 CSV、XLSX 或 SQLite 即可按对应格式导出。
最常调的几个参数
下载行为由项目根目录的 settings.json 控制，改完重启程序生效。
| 字段 | 说明 | 默认值 |
|---|---|---|
| root | 下载保存的根路径 | 空 |
| name_format | 文件命名规则，多个字段空格分隔 | create_time type nickname desc |
| folder_mode | 是否按创作者、合集建文件夹归档 | false |
| music | 是否连背景音乐一起下载 | false |
| proxy | 代理地址，网络受限时填写 | 空 |
| max_retry | 单文件下载失败的重试次数 | 5 |
| storage_format | 数据采集的导出格式 | 空（不保存数据） |
卡住时先查这 5 处
- 提示无法获取数据、请求被拒绝 → Cookie 过期 → 按上节流程重新获取并覆盖
- 只能下到标清视频 → Cookie 权限不足 → 换成已登录账号的 Cookie
- 下载速度很慢 → 网络受限 → 在 settings.json 配置 proxy
- 频繁触发平台风控 → 请求频率过高 → 降低批量规模，保留程序内置的智能延时
- 磁盘空间不足 → 视频与临时文件占满磁盘 → 清理临时文件，或把 root 换到空间充足的目录
这个工具适合个人学习和研究用途，避免大规模批量抓取，不采集涉及他人隐私的内容，商用前请取得相应授权。
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
