+23
Daily
17,515
stars
2,881
forks
93
watchers
84
prs
673
issues
27
releases
README
DouK-Downloader
简体中文 | English
🔥 抖音 / TikTok 平台作品下载/数据采集工具
⭐ 本项目历史名称:TikTokDownloader
⚠️ 项目计划在 6.0 版本进行彻底重构,预期重构完成后支持 GUI 或者 WebUI!
⚠️ 为确保项目合法合规,本项目的加密参数算法不再维护;如因平台更新导致部分功能无法正常使用,请自行准备加密参数生成代码,配置方法请查阅 文档!
📝 项目功能
项目功能清单,适合想要快速了解项目能力的用户查阅(点击展开)
✅ 下载抖音视频/图集
✅ 下载抖音实况/动图
✅ 下载最高画质视频文件
✅ 下载 TikTok 视频/图集
✅ 下载抖音账号发布/喜欢/收藏/收藏夹作品
✅ 下载 TikTok 账号发布/喜欢作品
✅ 采集抖音 / TikTok 详细数据
✅ 批量下载链接作品
✅ 多账号批量下载作品
✅ 自动跳过已下载的文件
✅ 持久化保存采集数据
✅ 支持 CSV/XLSX/SQLite 格式保存数据
✅ 下载动态/静态封面图
✅ 获取抖音直播拉流地址
✅ 获取 TikTok 直播拉流地址
✅ 调用 ffmpeg 下载直播
✅ Web UI 交互界面
✅ 采集抖音作品评论数据
✅ 下载抖音合集作品
✅ 下载 TikTok 合辑作品
✅ 记录点赞收藏等统计数据
✅ 筛选作品发布时间
✅ 支持账号作品增量下载
✅ 支持使用代理采集数据
✅ 支持局域网远程访问
✅ 采集抖音账号详细数据
✅ 作品统计数据更新
✅ 支持自定义账号/合集标识
✅ 自动更新账号昵称/标识
✅ 部署至私有服务器
✅ 部署至公开服务器
✅ 采集抖音搜索数据
✅ 采集抖音热榜数据
✅ 记录已下载作品 ID
✅ 从浏览器读取 Cookie
✅ 支持 Web API 调用
✅ 支持多线程下载作品
✅ 文件完整性处理机制
✅ 自定义规则筛选作品
✅ 按文件夹归档保存作品文件
✅ 自定义设置文件大小上限
✅ 支持文件断点续传下载
✅ 监听剪贴板链接下载作品
💻 程序截图
前往 bilibili 观看演示;前往 YouTube 观看演示
终端交互模式
建议通过配置文件管理账号,更多介绍请查阅 文档
!终端模式截图
!终端模式截图
!终端模式截图
Web UI 交互模式
该模式代码尚未更新,未来重构完成重新开放!
Web API 接口模式
!WebAPI模式截图
!WebAPI模式截图
启动该模式后,访问 http://127.0.0.1:5555/docs 或者 http://127.0.0.1:5555/redoc 可以查阅自动生成的文档!
API 调用示例代码
python
from curl_cffi.requests import post
from rich import print
def demo():
headers = {"token": ""}
data = {
"detail_id": "0123456789",
"pages": 2,
}
api = "http://127.0.0.1:5555/douyin/comment"
response = post(api, json=data, headers=headers)
print(response.json())
demo()
📋 项目说明
快速入门
⭐ Mac OS、Windows 10 及以上用户可前往 Releases 或者 Actions 下载已编译的程序,开箱即用!
⭐ 本项目包含自动构建可执行文件的 GitHub Actions,使用者可以随时使用 GitHub Actions 将最新源码构建为可执行文件!
⭐ 自动构建可执行文件教程请查阅本文档的 构建可执行文件指南 部分;如果需要更加详细的图文教程,请 查阅文章!
注意:由于 Mac OS 平台的可执行文件 main 未经过代码签名,首次运行时会受到系统安全限制。请先在终端执行 xattr -cr 项目文件夹路径 命令移除安全标记,执行一次后即可正常运行。
Node.js(可选依赖):部分功能依赖 Node.js 执行 JavaScript 代码,需要 Node.js 18 及以上版本;建议使用者自行安装,未安装时部分功能可能受到影响。
运行可执行文件 或者 配置环境运行(二选一)
运行可执行文件
下载 Releases 或者 Actions 构建的可执行文件压缩包
解压后打开程序文件夹,双击运行 main
配置环境运行
安装不低于 3.12 版本的 Python 解释器
下载最新的源码或 Releases 发布的源码至本地
使用 pip 安装项目依赖
运行 python -m venv venv 命令创建虚拟环境(可选)
运行 .\venv\Scripts\activate.ps1 或者 venv\Scripts\activate 命令激活虚拟环境(可选)
运行 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt 命令安装程序所需模块
运行 python .\main.py 或者 python main.py 命令启动 DouK-Downloader
使用 uv 安装项目依赖(推荐)
运行 uv sync --no-dev 命令同步环境依赖
运行 uv run main.py 命令启动 DouK-Downloader
阅读 DouK-Downloader 的免责声明,根据提示输入内容
将 Cookie 信息写入配置文件
手动输入 Cookie
参考 Cookie 提取教程,复制所需 Cookie 至剪贴板
选择 手动输入 Cookie 选项,粘贴 Cookie 内容后按照程序提示操作
从剪贴板读取 Cookie
参考 Cookie 提取教程,复制所需 Cookie 至剪贴板
选择 从剪贴板读取 Cookie 选项,程序会自动读取剪贴板的 Cookie 并写入配置文件
从浏览器读取 Cookie(弃用)
选择 从浏览器读取 Cookie 选项,按照提示输入浏览器类型或序号
返回程序界面,依次选择 终端交互模式 - 批量下载链接作品 - 手动输入待采集的作品链接
输入抖音作品链接即可下载作品文件(TikTok 平台需要更多初始设置,详见文档)
更多详细说明请查看 项目文档
⭐ 推荐使用 Windows 终端(Windows 11 自带默认终端)
Docker 容器
Docker 容器部署步骤,适合使用 Docker 部署和运行本项目的用户查阅(点击展开)
获取镜像
方式一:使用 Dockerfile 文件构建镜像
方式二:使用 docker pull joeanamier/tiktok-downloader 命令拉取镜像
方式三:使用 docker pull ghcr.io/joeanaTop issues
#585[优化建议] 小白的快速批量下载方法13 comments · 2025-10-10#478[功能异常] 下载超过35个博主后,就开始出现cookie异常。但是等一个小时后可以恢复12 comments · 2025-05-22#411[功能异常] 批量下载链接抖音视频输入链接文档后长时间无反应11 comments · 2025-02-28#544[功能异常] csv、xlsx纯数字列未转为文本6 comments · 2025-08-23#312关于 文件的 创建时间&修改时间 的功能建议5 comments · 2024-10-13#543windows怎么保留数据更新4 comments · 2025-08-23#802采集报错描述细分3 comments · 2026-09-18#653[优化建议] 强烈建议能在accounts_urls参数下,增加一个排序功能和最大页码的功能2 comments · 2026-01-01
Discussions
#7965.81 comments · 2026-09-13#795v5.8beta无法获取dy直播拉流地址以及一些其他问题1 comments · 2026-09-10#790更新参数失败2 comments · 2026-09-03#758Download original quality from Douyin2 comments · 2026-05-31#753配置文件 owner_url 的 url 参数 无效1 comments · 2026-05-23#749自己主页的喜欢列表6 comments · 2026-05-18#717能否取消下载视频1 comments · 2026-04-04#704可以把批量采集的数据保存到同一个xlsx文件中吗2 comments · 2026-03-16
Latest release
DouK-Downloader V5.8 5.8 2026-09-13更新内容: 1. API 模式搜索接口增加 offset 和 count 参数 2. 修复部分 TikTok 账号提取 sec_user_id 失败的问题 3. 修复 API 模式账号作品接口部分参数不生效的问题 4. 修复配置文件 tab 参数无效导致报错的问题 5. 修复 API 模式搜索接口多页数据报错的问题 6. 修复 API 模式搜索接口结果为空报错的问题 7. 修复 TikTok 平台批量下载账号作品功能 8. 修复 TikTok 平台批量下载合集作品功能 9. 修复报错时可能损坏 XLSX 文件的问题 10. TikTok 平台新增 X-Gnarly 请求参数 11. 实现动态加载外部 Python 代码功能 12. 使用 curl_cffi 替代 httpx 13. 移除 从浏览器读取 Cookie 功能 14. 服务器模式默认启用局域网访问 15. 优化提取 secUid 的正则表达式 16. 修复请求参数编码错误的问题 17. 支持下载最高质量视频文件 18. 修复提取作品 ID 失败的问题 19. 重构项目内置请求延时机制 20. 恢复手动输入 Cookie 功能 21. 增加文件下载缓冲机制 22. 更新数据接口请求参数 23. 更新项目英语翻译 24. 修正项目功能描述 25. 修复其他已知问题 ⚠️ 升级提醒:本次升级请将旧版本程序文件夹下的 _in