DouK-Downloader 抖音TikTok 作品下载实战指南【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader你需要把某个抖音账号近三个月的作品全部归档或者只是想把某条视频的评论数据拉下来做分析——手动抓包写脚本维护成本太高。DouK-Downloader原名 TikTokDownloader是基于 HTTPX 的开源抖音/TikTok 作品下载与数据采集工具终端交互、Web API、后台监听三种形态都覆盖。先说两条边界内置的 xBogus/aBogus 加密参数算法已过期且不再维护部分接口需要你自备参数生成代码README 明确标注付费作品不支持下载。快速上手从克隆源码到完成抖音作品下载获取源码并装依赖。Python 版本硬指标是 3.12 及以上README 的 Python 徽章标明的就是 3.12git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader pip install -r requirements.txt python main.py接受免责声明并生成配置。首次运行会生成settings.json出现免责声明时输入 YES 确认该选择会持久化只问这一次。写入 Cookie。这是接口权限和视频画质的前置条件主菜单选手动输入 Cookie (抖音)粘贴回车或复制好后选从剪贴板读取 Cookie。获取方法浏览器登录抖音网页版F12 打开开发者工具「网络」选项卡勾选「保留日志」筛选框输入cookie-name:odin_tt点开任意作品评论区后复制请求里Cookie的完整值详见 docs/Cookie获取教程.md。 Cookie 只在失效后才需要重写平时不用动它。完成第一次下载。返回主菜单选终端交互模式→批量下载链接作品(抖音)→手动输入待采集的作品链接粘贴一个抖音作品链接回车。进度条走完文件就落在root/folder_name目录下默认是项目根的Download/文件名由创建时间、账号昵称、作品描述等拼成。菜单里直接回车返回上级任意界面输入 Q 或 q 退出程序。settings.json 关键参数解析root、name_format 与 storage_format配置修改后必须重启程序才生效没有热加载。下面只讲真正影响行为的 7 个参数其余保持默认即可。cookie/cookie_tiktok平台接口的身份凭证决定接口权限和画质 → 浏览器登录后粘贴完整值失效再更新 → 最易踩的坑未登录的 Cookie 会让私密账号、账号页等接口直接失败画质偏低时第一怀疑对象就是它。root储存根路径 → 填一个已存在的目录 → 非法路径不会报错退出而是静默回退到项目根目录只在日志里留一条警告文件消失多半出在这里。name_format作品文件命名模板从id/desc/create_time/nickname/uid/mark/type七键里空格组合默认create_time type nickname desc→ 按归档习惯自选 → 七键之外出现任何非法键整条模板作废回退默认组合src/config/parameter.py的__check_name_format。storage_format采集数据持久化格式可选csv/xlsx/sqlite→ 纯采数据必须配 → 不配时日志会明确提示不会储存任何数据至文件数据只过内存不落盘。download是否下载文件本身默认true→ 只采数据设为false→ 只配了storage_format忘了关这个开关磁盘上会多一堆视频文件。max_pages分页请求次数上限默认0等价于 99999 → 按账号体量设一个具体值 → 喜欢/收藏接口只返回发布日期而非操作日期程序必须拉全量再按日期筛选这个参数是你唯一的量级阀门不设上限会拉到你怀疑人生。proxy/proxy_tiktok平台代理地址 → 先手动验证代理可用再填 → 启动时程序会真实请求平台页面测连超时或报错直接返回 None 静默忽略务必在日志里确认出现代理测试成功字样。另外两个实用项run_command可预置启动时直达的菜单指令免去每次重复点选旧字段有自动映射default_mode→run_command等见src/config/settings.py的rename_params从老版本升级不用担心配置作废。部署与进阶Docker 一行起容器、Web API 服务化Docker 一行起容器适用场景服务器上不想装 Python 环境或者想用卷把下载产物持久化。docker pull joeanamier/tiktok-downloader docker run --name tiktok-dl -p 5555:5555 \ -v tiktok_downloader_volume:/app/Volume -it joeanamier/tiktok-downloader能力边界Dockerfile 是双阶段构建最终镜像基于 python:3.12-slim数据卷挂载在/app/Volume暴露 5555 端口。容器内访问不到宿主机的浏览器和文件系统从浏览器读取 Cookie 这类依赖宿主环境的入口不可用Cookie 一律走终端粘贴。Web API 接口模式用 HTTP 调用抖音数据采集适用场景你已有自己的系统想通过 HTTP 接口调用抖音作品、评论、搜索等采集能力。python main.py # 主菜单选择「Web API 模式」 # 随后访问 http://127.0.0.1:5555/docs 查看 Swagger 交互文档服务监听在0.0.0.0:5555SERVER_HOST/SERVER_PORT定义在src/custom/static.py每个接口经src/application/main_server.py的token_dependency校验请求头里的tokenfrom httpx import post resp post( http://127.0.0.1:5555/douyin/comment, json{detail_id: 0123456789, pages: 2}, headers{token: }, ) print(resp.json())⚠️ 注意src/custom/function.py的is_valid_token()当前恒返回 True项目默认无需令牌鉴权实际是放开的。公开部署前必须把它改成固定令牌校验并对外挂反向代理终结 TLS 与限流改完可用/token接口自测有效性。后台监听模式复制链接自动下载适用场景日常随手刷到作品复制一下链接就希望文件自动落盘。主菜单选后台监听模式后程序常驻依赖系统剪贴板pyperclip窗口关闭即失效适合挂在专用终端里。源码导读一条抖音作品的数据流跟一条作品链接走一遍就能看清整条链路终端菜单、Web API、剪贴板监听三种入口最终都汇入src/application/main_terminal.py的功能分发链接先经src/link/extractor.py把 iesdouyin 短链展开成标准链接请求统一由src/interface/template.py的API基类发起generate_params→request_data→check_response三段式account.py、comment.py、live.py等子类各自只关心 URL 和游标规则字段在src/extract/extractor.py统一提取src/downloader/download.py先把文件写进临时目录完成后再移入目标目录并发由信号量限制在MAX_WORKERS 4src/custom/static.py最后src/storage/按storage_format把结构化数据持久化。三个值得细读的工程设计重试与退避src/tools/retry.py的Retry.retry装饰器按max_retry默认 5循环每轮失败后await wait()智能延时而不是固定 sleep。文件魔数校验src/custom/static.py的FILE_SIGNATURES内置 jpg/png/mp4/mov 等文件头签名下载完成后据此判断真实类型并纠正后缀防止假 mp4混进归档。Cookie 自动续命src/application/TikTokDownloader.py的periodic_update_params开了一条守护线程按COOKIE_UPDATE_INTERVAL15 分钟周期刷新 msToken、tt_wid 并回写长时间挂机采集不用人工干预。排障速查表Cookie 失效、代理不生效等常见问题现象根因处理下载失败或视频清晰度偏低Cookie 失效或未登录按教程重新获取并写入私密账号需要已关注该账号且处于登录态的 Cookie文件没出现在指定目录root非法已静默回退项目根查日志中 root 警告改为已存在目录后重启代理配了却没生效启动测连失败程序静默忽略手动验证代理可用确认日志出现代理测试成功采集数据没落盘storage_format未设置设为csv/xlsx/sqlite后重启批量喜欢/收藏作品很慢接口只返回发布日期需拉全量再筛选调小max_pages缩小账号配置里的日期区间升级后旧作品丢失旧版数据在老目录_internal/Volume按 README 更新方案把旧目录_internal/Volume拷入新版多开实例行为异常项目未针对多实例优化复制整个项目文件夹各自独立运行终止程序或 ffmpeg 录制一律按 Ctrl C不要直接关终端窗口配置改动不重启不生效批量收藏作品模式只认当前登录账号暂不支持多账号混采。写在最后谁适合用这套工具个人作品归档、中小规模的抖音/TikTok 账号数据采集、以及把采集能力服务化给自有系统调用是它最顺手的三类场景全部逻辑开源可读可改接口层出问题你自己就能定位。采集与下载行为的责任在你自己——商用前建议先读一遍 README 末尾的免责声明确认符合你所在环境的法律与平台规则。【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
DouK-Downloader 抖音TikTok 作品下载实战指南【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader你需要把某个抖音账号近三个月的作品全部归档或者只是想把某条视频的评论数据拉下来做分析——手动抓包写脚本维护成本太高。DouK-Downloader原名 TikTokDownloader是基于 HTTPX 的开源抖音/TikTok 作品下载与数据采集工具终端交互、Web API、后台监听三种形态都覆盖。先说两条边界内置的 xBogus/aBogus 加密参数算法已过期且不再维护部分接口需要你自备参数生成代码README 明确标注付费作品不支持下载。快速上手从克隆源码到完成抖音作品下载获取源码并装依赖。Python 版本硬指标是 3.12 及以上README 的 Python 徽章标明的就是 3.12git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader pip install -r requirements.txt python main.py接受免责声明并生成配置。首次运行会生成settings.json出现免责声明时输入 YES 确认该选择会持久化只问这一次。写入 Cookie。这是接口权限和视频画质的前置条件主菜单选手动输入 Cookie (抖音)粘贴回车或复制好后选从剪贴板读取 Cookie。获取方法浏览器登录抖音网页版F12 打开开发者工具「网络」选项卡勾选「保留日志」筛选框输入cookie-name:odin_tt点开任意作品评论区后复制请求里Cookie的完整值详见 docs/Cookie获取教程.md。 Cookie 只在失效后才需要重写平时不用动它。完成第一次下载。返回主菜单选终端交互模式→批量下载链接作品(抖音)→手动输入待采集的作品链接粘贴一个抖音作品链接回车。进度条走完文件就落在root/folder_name目录下默认是项目根的Download/文件名由创建时间、账号昵称、作品描述等拼成。菜单里直接回车返回上级任意界面输入 Q 或 q 退出程序。settings.json 关键参数解析root、name_format 与 storage_format配置修改后必须重启程序才生效没有热加载。下面只讲真正影响行为的 7 个参数其余保持默认即可。cookie/cookie_tiktok平台接口的身份凭证决定接口权限和画质 → 浏览器登录后粘贴完整值失效再更新 → 最易踩的坑未登录的 Cookie 会让私密账号、账号页等接口直接失败画质偏低时第一怀疑对象就是它。root储存根路径 → 填一个已存在的目录 → 非法路径不会报错退出而是静默回退到项目根目录只在日志里留一条警告文件消失多半出在这里。name_format作品文件命名模板从id/desc/create_time/nickname/uid/mark/type七键里空格组合默认create_time type nickname desc→ 按归档习惯自选 → 七键之外出现任何非法键整条模板作废回退默认组合src/config/parameter.py的__check_name_format。storage_format采集数据持久化格式可选csv/xlsx/sqlite→ 纯采数据必须配 → 不配时日志会明确提示不会储存任何数据至文件数据只过内存不落盘。download是否下载文件本身默认true→ 只采数据设为false→ 只配了storage_format忘了关这个开关磁盘上会多一堆视频文件。max_pages分页请求次数上限默认0等价于 99999 → 按账号体量设一个具体值 → 喜欢/收藏接口只返回发布日期而非操作日期程序必须拉全量再按日期筛选这个参数是你唯一的量级阀门不设上限会拉到你怀疑人生。proxy/proxy_tiktok平台代理地址 → 先手动验证代理可用再填 → 启动时程序会真实请求平台页面测连超时或报错直接返回 None 静默忽略务必在日志里确认出现代理测试成功字样。另外两个实用项run_command可预置启动时直达的菜单指令免去每次重复点选旧字段有自动映射default_mode→run_command等见src/config/settings.py的rename_params从老版本升级不用担心配置作废。部署与进阶Docker 一行起容器、Web API 服务化Docker 一行起容器适用场景服务器上不想装 Python 环境或者想用卷把下载产物持久化。docker pull joeanamier/tiktok-downloader docker run --name tiktok-dl -p 5555:5555 \ -v tiktok_downloader_volume:/app/Volume -it joeanamier/tiktok-downloader能力边界Dockerfile 是双阶段构建最终镜像基于 python:3.12-slim数据卷挂载在/app/Volume暴露 5555 端口。容器内访问不到宿主机的浏览器和文件系统从浏览器读取 Cookie 这类依赖宿主环境的入口不可用Cookie 一律走终端粘贴。Web API 接口模式用 HTTP 调用抖音数据采集适用场景你已有自己的系统想通过 HTTP 接口调用抖音作品、评论、搜索等采集能力。python main.py # 主菜单选择「Web API 模式」 # 随后访问 http://127.0.0.1:5555/docs 查看 Swagger 交互文档服务监听在0.0.0.0:5555SERVER_HOST/SERVER_PORT定义在src/custom/static.py每个接口经src/application/main_server.py的token_dependency校验请求头里的tokenfrom httpx import post resp post( http://127.0.0.1:5555/douyin/comment, json{detail_id: 0123456789, pages: 2}, headers{token: }, ) print(resp.json())⚠️ 注意src/custom/function.py的is_valid_token()当前恒返回 True项目默认无需令牌鉴权实际是放开的。公开部署前必须把它改成固定令牌校验并对外挂反向代理终结 TLS 与限流改完可用/token接口自测有效性。后台监听模式复制链接自动下载适用场景日常随手刷到作品复制一下链接就希望文件自动落盘。主菜单选后台监听模式后程序常驻依赖系统剪贴板pyperclip窗口关闭即失效适合挂在专用终端里。源码导读一条抖音作品的数据流跟一条作品链接走一遍就能看清整条链路终端菜单、Web API、剪贴板监听三种入口最终都汇入src/application/main_terminal.py的功能分发链接先经src/link/extractor.py把 iesdouyin 短链展开成标准链接请求统一由src/interface/template.py的API基类发起generate_params→request_data→check_response三段式account.py、comment.py、live.py等子类各自只关心 URL 和游标规则字段在src/extract/extractor.py统一提取src/downloader/download.py先把文件写进临时目录完成后再移入目标目录并发由信号量限制在MAX_WORKERS 4src/custom/static.py最后src/storage/按storage_format把结构化数据持久化。三个值得细读的工程设计重试与退避src/tools/retry.py的Retry.retry装饰器按max_retry默认 5循环每轮失败后await wait()智能延时而不是固定 sleep。文件魔数校验src/custom/static.py的FILE_SIGNATURES内置 jpg/png/mp4/mov 等文件头签名下载完成后据此判断真实类型并纠正后缀防止假 mp4混进归档。Cookie 自动续命src/application/TikTokDownloader.py的periodic_update_params开了一条守护线程按COOKIE_UPDATE_INTERVAL15 分钟周期刷新 msToken、tt_wid 并回写长时间挂机采集不用人工干预。排障速查表Cookie 失效、代理不生效等常见问题现象根因处理下载失败或视频清晰度偏低Cookie 失效或未登录按教程重新获取并写入私密账号需要已关注该账号且处于登录态的 Cookie文件没出现在指定目录root非法已静默回退项目根查日志中 root 警告改为已存在目录后重启代理配了却没生效启动测连失败程序静默忽略手动验证代理可用确认日志出现代理测试成功采集数据没落盘storage_format未设置设为csv/xlsx/sqlite后重启批量喜欢/收藏作品很慢接口只返回发布日期需拉全量再筛选调小max_pages缩小账号配置里的日期区间升级后旧作品丢失旧版数据在老目录_internal/Volume按 README 更新方案把旧目录_internal/Volume拷入新版多开实例行为异常项目未针对多实例优化复制整个项目文件夹各自独立运行终止程序或 ffmpeg 录制一律按 Ctrl C不要直接关终端窗口配置改动不重启不生效批量收藏作品模式只认当前登录账号暂不支持多账号混采。写在最后谁适合用这套工具个人作品归档、中小规模的抖音/TikTok 账号数据采集、以及把采集能力服务化给自有系统调用是它最顺手的三类场景全部逻辑开源可读可改接口层出问题你自己就能定位。采集与下载行为的责任在你自己——商用前建议先读一遍 README 末尾的免责声明确认符合你所在环境的法律与平台规则。【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
