DouK-Downloader 实操指南从单条保存到批量下载、评论采集与直播录制的完整路径【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloaderDouK-Downloader 是一款完全开源免费的抖音 / TikTok 作品下载与数据采集工具批量下载作品和音乐、采集评论和搜索数据、录制直播采集结果可落成 CSV、XLSX 或 SQLite。想把视频存到本地的个人用户、要定期盯号的创作者、需要接口调用的开发者都是它的目标人群。 从零到第一次成功安装、写 Cookie、下下第一条先把源码拉下来装环境程序基于 Python 3.12网络请求层用 HTTPXgit clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader uv sync --no-dev # 装依赖不想用 uv 可改用 pip install -r requirements.txt uv run main.py # 启动Windows 和 Mac 用户也可以直接去项目发布页下载已编译的main可执行文件解压双击即可Mac 首次运行需在终端执行xattr -cr 项目文件夹路径解除系统安全限制。首次启动会弹出免责声明按提示接受后程序会引导你写入 Cookie浏览器登录抖音的凭据。Cookie 决定你能拿到的视频分辨率只配一次失效了再更新。抓取一份登录态 Cookie 的完整步骤见 Cookie 获取教程动作如下用浏览器打开抖音网页版并登录你的账号按F12打开开发者工具切换到「网络」选项卡勾选「保留日志」在筛选器里输入cookie-name:odin_tt点击任意作品的评论区触发请求选中请求复制请求头里完整的 Cookie 值回到程序选择「手动输入 Cookie」或「从剪贴板读取 Cookie」粘贴后按提示确认写入配置文件Cookie 写好后在主菜单依次选择「终端交互模式」→「批量下载链接作品」→「手动输入待采集的作品链接」粘贴一条抖音作品链接按回车。几秒后打开项目根目录下的Download文件夹——第一条视频已经躺在里面到这里就算跑通了。 按场景找入口从保存一条视频到部署服务不用背功能清单按你要干的事对号入座。以下能力在终端交互模式和 Web API 模式下大部分都能用你的目标入口/操作路径关键参数或配置项保存几条视频终端交互模式 → 批量下载链接作品music、static_cover、desc_length定期采集某账号全部作品终端交互模式 → 批量下载账号作品账号提前写进配置文件accounts_urls中的tab、earliest、latest只要音乐下载时同步提取音频流music: true、storage_format评论、搜索、热榜数据终端交互模式 → 对应采集项数据落盘storage_formatcsv / xlsx / sqlite录制直播获取拉流地址后调用 FFmpeg 实时录制live_qualities、ffmpeg后台自动下载主菜单 → 剪贴板监听复制链接即触发无额外配置部署到服务器主菜单 → Web API 接口模式FastAPItoken校验、局域网访问抖音国内和 TikTok海外是两条独立链路TikTok 侧还需要补齐browser_info_tiktok里的device_id等初始参数获取方式和取 Cookie 类似教程末尾有截图示例。最高频的玩法是账号作品批量采集建议把账号预置到settings.json而不是每次手输accounts_urls: [ { mark: 美食博主, url: https://www.douyin.com/user/xxx, tab: post, earliest: , latest: , enable: true } ]mark是自定义标识博主改昵称后文件名也会跟着自动更新tab取post发布、like喜欢、favorite收藏earliest/latest按发布时间筛选。下载的文件会先进临时目录完整后才移入目标文件夹已下载的作品自动跳过所以可以开着做增量采集。⚙️ settings.json 里只动这几个键首次运行会自动生成带默认值的settings.json改完必须重启程序才生效。不用逐行看值得动的就下面几个folder_name默认Download→ 控制文件落到哪个文件夹 → 想换个归档目录时改。name_format默认create_time type nickname desc→ 控制文件名由哪些字段拼成desc_length默认 64和name_length默认 128限制描述和总长度 → 嫌文件名长就调小或换字段顺序。music默认false→ 控制下载作品时是否同步提取音频 → 只要 BGM 或原声时开。storage_format默认空不记录→ 控制采集的作品、评论、搜索结果是否持久化到Volume目录可选csv、xlsx、sqlite→ 用任何数据类功能前必须先设。proxy/proxy_tiktok默认空 → 控制请求是否走代理 → 批量采集被限流时再配平时留空。timeout/max_retry默认 10 秒超时、重试 5 次 → 控制网络抖动时的表现 → 网络差的环境调大timeout即可。性能上不用折腾chunk单次接收数据块默认 2MB和max_size单文件上限默认不限保持默认程序内置智能延时机制防止请求过频被平台限流别为了快把并发和重试往死里调。 进阶把下载能力挂到局域网当服务主菜单选「Web API 接口模式」或在settings.json配置run_command后服务监听0.0.0.0:5555默认允许局域网访问。浏览器打开http://127.0.0.1:5555/docs就能看到 FastAPI 自动生成的接口文档。所有业务接口用请求头token鉴权本地单跑时默认令牌通过部署到公网或局域网共享前建议自定义 token修改点在src/custom/function.py的is_valid_token()。端点命名规律是/douyin/xxx和/tiktok/xxx覆盖短链解析、作品详情、账号作品、评论、直播地址、搜索、热榜具体以/docs页面为准。最短调用示例from httpx import post response post( http://127.0.0.1:5555/douyin/comment, json{detail_id: 0123456789, pages: 2}, # 采集该作品 2 页评论 headers{token: 你的token}, ) print(response.json())想放到服务器上长期跑直接用 Docker 更省事docker pull joeanamier/tiktok-downloader docker run -p 5555:5555 -v tiktok_downloader_volume:/app/Volume -it joeanamier/tiktok-downloader排错速查现象最可能原因一步处理只能下到低分辨率视频Cookie 未登录或已过期重新抓一份登录态 Cookie 写入配置请求失败、返回空数据Cookie 失效或 IP 被限流更新 Cookie或配置proxy走代理TikTok 功能不可用缺device_id等初始参数按教程补齐browser_info_tiktok私密账号作品下不了未登录或登录账号没关注对方换用已关注该账号的登录态 Cookie改了配置没反应没有重启程序改完settings.json后重启两条交互约定程序提示输入时直接回车返回上级菜单输入Q结束运行运行中要停止请按Ctrl C别直接点终端关闭按钮否则正在写的文件会中断。合规边界与下一步本项目按 GNU GPL v3.0 协议开源二次分发需遵守该协议采集数据仅供个人学习研究请勿用于未授权的内容传播或商业抓取付费作品不在支持范围。内置加密参数算法已停止维护部分接口可能失效遇到异常以项目最新文档为准。下一步动作打开settings.json把storage_format改成csv跑一次评论采集到Volume目录里验收第一份数据文件Cookie 失效时回看 Cookie 获取教程 即可。【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考