DouK-Downloader 完整指南：5 分钟跑通抖音 / TikTok 视频下载与归档
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
想把这个账号的所有作品一次归档，而不是手动逐条另存？DouK-Downloader（曾用名 TikTokDownloader）是一款完全免费、完全开源的抖音 / TikTok 下载工具，从单条作品下载、账号批量归档到评论热榜数据采集、直播录制，都能在本地完成，采集结果可导出为 CSV、XLSX、SQLite。
这类工具解决什么问题
先对号入座，看你是不是它的使用者：
- 内容运营 / 粉丝向用户：定期归档某个抖音或 TikTok 账号发布、喜欢、收藏的所有作品，按文件夹自动分类保存。
- 数据收集者：采集作品点赞、评论、账号详情、搜索结果、热榜数据，落到本地数据库再分析。
- 直播观众 / 创作者：获取抖音或 TikTok 直播拉流地址，直接录制成视频文件。
- 开发者：通过 Web API 把下载和采集能力挂进自己的服务里，按需发 HTTP 请求。
第一次运行：完成第一个视频下载
不想配置 Python 环境的话，直接去 Releases 下载编译好的可执行文件，解压后运行main即可。走源码路线需要 Python 3.12 以上：
git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader uv sync --no-dev uv run main.py首次启动先确认免责声明，然后写一次 Cookie：打开抖音网页版，按 F12 切到「网络」选项卡，在筛选器输入cookie-name:odin_tt，点开任意作品评论区，复制请求里的完整 Cookie 值；回到程序选「从剪贴板读取 Cookie」回车确认。详细步骤见 docs/Cookie获取教程.md。
配置完成后选「终端交互模式 → 批量下载链接作品 → 手动输入待采集的作品链接」，粘贴视频链接回车。文件先落临时目录、完成后移入储存目录，已下载的作品 ID 会被记录，重复运行自动跳过。
核心能力：按你要完成的事划分
单条与批量链接下载粘贴作品链接即可下载视频、图集、音乐，支持断点续传和文件完整性校验。链接多就一次全粘，程序会逐个处理并跳过已完成的。
账号与合集批量归档支持下载抖音账号的发布、喜欢、收藏、收藏夹作品，以及抖音合集、TikTok 合辑；作品按账号 / 合集标识分文件夹保存，昵称变化时还会自动改回文件名里的标识。
数据采集与导出可采集作品评论、账号详情、用户 / 作品 / 直播搜索、热榜数据，持久化到 CSV、XLSX 或 SQLite，方便二次分析。
直播拉流与录制获取抖音 / TikTok 直播拉流地址后，本机装有 ffmpeg 就会自动调用它录制备用（实现见 src/module/ffmpeg.py）。录制是长任务，结束请Ctrl + C，别直接关终端。
剪贴板监听切到「后台监听模式」后程序常驻，剪贴板一出现新链接就自动触发下载，适合挂机追更。
进阶调优
增量追更账号作品场景：每周定期同步关注的账号，不想重复下载。做法：在主菜单保持「作品下载记录」开启，已下作品 ID 存入数据库（见 src/manager/recorder.py），第二次运行只拉增量。注意：该功能关闭时增量逻辑失效，「删除作品下载记录」入口也会一并禁用。
多账号统一管理场景：长期跟踪十几个账号，不想每次手输链接。做法：把账号 URL、标识（mark）、max_pages翻页深度写进settings.json集中管理。注意：配置改完要重启程序才生效。
限流与风控应对场景：批量采集时提示频率受限或请求失败。做法：在settings.json配置proxy参数走代理。注意：程序内置智能延时请求机制，不要把间隔手动调成无间隔，否则容易触发风控。
高频问题速答
为什么下载不到最高分辨率？Cookie 失效或处于未登录态。重新按教程获取并写入登录态 Cookie 即可。
macOS 上可执行文件打不开？二进制的代码未签名，被系统安全机制拦下。终端执行xattr -cr 项目文件夹路径移除标记后重试。
私密账号的作品为什么拿不到？接口要求用已登录且已关注该私密账号的 Cookie。换用符合条件账号的 Cookie 再试。
请求失败或频率受限怎么办？属于平台风控，多为请求过频。挂代理并保留程序自带的智能延时，同时可尝试刷新 Cookie。
能同时开多个程序实例吗？项目未针对多开优化。复制整个项目文件夹，让每个副本独立运行，避免数据混乱。
边界与资源
它不支持付费作品下载；README 同时提示内置的加密参数算法已停止维护，个别功能可能需要自行准备参数生成代码；Web UI 界面因代码重构尚未重新开放，目前可用的是终端交互、后台监听和 Web API 三种方式（Web API 默认监听127.0.0.1:5555，访问/docs可看接口文档）。
更多细节读这两份文档：docs/Cookie获取教程.md、docs/DouK-Downloader文档.md。
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
