DouK-Downloader 抖音 TikTok 作品下载与数据采集完整指南3 分钟跑通首次下载【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloaderDouK-Downloader历史名称 TikTokDownloader是一款基于 HTTPX 异步请求库的抖音 / TikTok 作品下载与数据采集工具。本文带你完成环境搭建、Cookie 写入与首次作品下载并拆解到源码级的关键实现。一、它解决什么问题核心痛点一句话免抓包脚本地批量获取抖音 / TikTok 作品文件与结构化数据。使用场景能力点作品下载抖音视频 / 图集 / 实况 / 动图、最高画质TikTok 视频原画 / 图集音乐与动态 / 静态封面账号维度抖音发布 / 喜欢 / 收藏 / 收藏夹批量下载TikTok 发布 / 喜欢作品多账号批量链接维度批量下载链接作品后台监听剪贴板链接自动下载直播录制获取抖音 / TikTok 直播拉流地址调用 ffmpeg 录制直播数据采集作品评论、合集 / 合辑、账号详细数据、综合 / 视频 / 用户 / 直播四类搜索、抖音热榜工程能力增量下载、断点续传、多线程、自动跳过已下载、CSV/XLSX/SQLite 持久化、代理请求、Web API 服务化⚠️ 以下功能在 README 中明确标注「弃用 / 失效 / 重构中」使用当前版本时请勿依赖功能状态原因Web UI 交互模式重构中代码尚未更新菜单仅提示「该功能正在重构」见 TikTokDownloader.py 的disable_function约第 138-145 行内置加密参数算法已过期失效、不再维护为合规不再维护 xBogus / aBogus 等内置算法部分功能可能无法正常工作需自行准备生成代码从浏览器读取 Cookie已弃用README 删除线标注对应代码已注释TikTokDownloader.py 约第 469-484 行扫码登录获取 Cookie已失效README 删除线标注主菜单对应代码已注释二、最小上手路径环境、安装与首次下载环境硬指标只有一条Python 不低于 3.12。Windows 10 及以上、macOS、Linux 均可README 推荐 Windows 11 自带终端以获得最佳交互体验。获取源码后pip 与 uv 两条等价路径任选其一git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader python -m venv venv # 可选 pip install -r requirements.txt python main.pycd TikTokDownloader uv sync --no-dev # uv 路径README 推荐 uv run main.py依赖清单requirements.txt即技术栈本身httpx异步请求、rich彩色终端、fastapi/uvicorn服务化、pydantic数据校验、aiosqlite/openpyxl持久化。Cookie 写入核心前置条件 Cookie浏览器端身份凭证决定接口权限与视频画质仅在失效后需要重新写入。获取步骤参考 Cookie获取教程.md浏览器访问抖音网页版按 F12 打开开发人员工具「网络」选项卡勾选「保留日志」筛选框输入cookie-name:odin_tt点击任意作品评论区后选取一个请求复制Cookie的完整值。3 分钟跑通首次下载程序入口是 main.py创建TikTokDownloader实例并调用run()。按以下步骤操作看到项目标题与免责声明 → 输入YES确认该选择持久化仅首次出现主菜单选择手动输入 Cookie (抖音)→ 粘贴 Cookie 回车或选从剪贴板读取 Cookie复制后直接回车返回主菜单 → 选择终端交互模式选择批量下载链接作品(抖音)→手动输入待采集的作品链接粘贴一个抖音作品链接回车等待进度条走完文件落在root/folder_name目录下任意菜单直接回车返回上级输入Q或q结束程序。最小可运行示例写入 Cookie 后python main.py # 终端交互模式 - 批量下载链接作品(抖音) # - 手动输入待采集的作品链接 - 粘贴作品链接回车 # 产物出现在 Download/ 目录文件名含创建时间、账号昵称、作品描述三、settings.json 关键参数精讲程序首次启动会在项目根目录自动生成settings.json生成逻辑见 settings.py 的__create约第 151-162 行全部默认值定义在Settings.default约第 21-121 行。只挑真正影响行为的少数参数cookie / cookie_tiktok默认。抖音 / TikTok 身份凭证支持字符串或字典两种写法。__check_cookieparameter.py 约第 280-287 行同时接受两种类型非法类型记警告并返回空值。未登录时账号页、私密账号作品等接口会直接失败画质偏低时优先怀疑它。root默认。储存根路径。__check_root约第 368-382 行先判目录是否存在再尝试在父目录下创建都不行才回退项目根路径并写警告日志。填已存在的目录最省心。name_format默认create_time type nickname desc。作品文件命名模板。__check_name_format约第 404-415 行要求每个键都在NAME_KEYS七键内id/desc/create_time/nickname/uid/mark/type见第 55-63 行任一非法即整体回退默认组合。max_pages默认0等价 99999。分页请求次数上限。__check_max_pages约第 525-535 行将0与非正整数统一按 99999 处理。喜欢 / 收藏接口只返回发布日期而非操作日期程序必须拉全量再筛选此参数是唯一的量级阀门。proxy / proxy_tiktok默认。平台代理地址。__check_proxy约第 453-502 行启动时实际请求平台页面测连超时或报错直接返回None代理静默失效日志里找「代理测试成功 / 失败」确认。storage_format默认。数据持久化格式可选csv/xlsx/sqlSQLite映射见 manager.py 的DataLogger约第 611-616 行。__check_storage_format约第 545-559 行对非法值回退空值并警告。纯采集不下文件的场景必须配置此项否则数据不落盘。其余两个值得知道的timeout默认 10 秒允许范围 2-10与max_retry默认 5 次范围 0-5校验分别在__check_timeout约第 537-543 行与__check_max_retry约第 517-523 行。旧版本字段有自动映射settings.pyrename_params约第 122-143 行default_mode→run_command、update_cookie→douyin_platform、original_cover→static_cover。 配置修改后需重启程序才生效不支持热加载。四、进阶用法Docker 容器与 Web API 服务化Docker 一行起容器镜像有三种获取方式用仓库根目录 Dockerfile 本地构建双阶段构建构建器python:3.12-bullseye编译依赖最终镜像python:3.12-slimEXPOSE 5555、VOLUME /app/Volumedocker pull joeanamier/tiktok-downloaderdocker pull ghcr.io/joeanamier/tiktok-downloader。docker run --name 容器名称 -p 主机端口:5555 \ -v tiktok_downloader_volume:/app/Volume -it 镜像名称 docker start -i 容器名称镜像名称需与第一步拉取的镜像名一致如joeanamier/tiktok-downloader。容器内无法访问宿主机文件系统与本地浏览器从浏览器读取 Cookie等依赖宿主环境的功能不可用README 明确说明。Web API 接口模式主菜单选择Web API 模式程序在0.0.0.0:5555启动 FastAPI 服务常量定义于 static.pySERVER_HOST/SERVER_PORT约第 9-13 行服务实现见 main_server.py 的APIServer.run_server约第 82-101 行。访问http://127.0.0.1:5555/docs或/redoc可查阅自动生成的交互文档。鉴权机制每个接口经token_dependencymain_server.py 约第 46-51 行读取请求头中的token交由 function.py 的is_valid_token()第 73 行校验失败返回HTTP 403。项目默认无需令牌公开部署时建议在该函数处设置固定令牌防恶意请求并可用/token接口测试有效性。from httpx import post data {detail_id: 0123456789, pages: 2} headers {token: } resp post(http://127.0.0.1:5555/douyin/comment, jsondata, headersheaders) print(resp.json()) 生产化各一句多实例请复制整个项目文件夹隔离运行对外暴露前挂一层反向代理终结 TLS 并做限流长期运行将 uvicorn 日志重定向到文件落盘。无人值守场景可在settings.json的run_command配置启动时预执行的功能指令免去重复选菜单校验逻辑见 parameter.py 的__check_run_command约第 561-563 行。五、源码导读一条链路串起五个模块完整链路一句话串起用户输入经 link/extractor.py 解析短链为完整链接interface/ 下各接口类发起分页请求extract/extractor.py 统一提取字段downloader/ 先写入临时文件夹再移动到储存文件夹storage/ 按storage_format持久化数据调度中枢是 TikTokDownloader.py 的主菜单分发与run_command直达。三个核心模块调度层TikTokDownloadersrc/application/TikTokDownloader.py负责菜单分发、Cookie 写入、版本检查run约第 430 行另开守护线程periodic_update_params约第 439-460 行以COOKIE_UPDATE_INTERVAL 15 * 60秒static.py 第 16 行为周期自动刷新 msToken、tt_wid 并回写 Cookie因此长运行无需手动更新凭证。接口层API模板src/interface/template.py统一generate_params/request_data/check_response三段式约第 95、248、221 行子类 account.py、detail.py、comment.py、live.py、search.py 各自只关心 URL 与游标规则终端菜单的 15 个功能入口定义在 main_terminal.py 的__function约第 141-209 行。下载层Downloadersrc/downloader/download.pysemaphore Semaphore(MAX_WORKERS)限制并发MAX_WORKERS 4static.py 第 2 行__update_headers_range约第 938-949 行根据临时文件已有字节数注入Range: bytesposition-实现断点续传request_file约第 584 行先落临时目录完成后save_file移入目标目录。两个值得读的工程细节重试与退避retry.py 的Retry.retry装饰器按max_retry上限循环重试每次失败后await wait()智能延时随机延时见 function.py 第 20 行失败达上限才终止任务第 10-23 行。文件完整性校验static.py 的FILE_SIGNATURES第 29-57 行内置 jpg / png / mp4 / mov 等文件头魔数下载后据此校验真实类型并纠正后缀避免「下载成功但内容损坏」的假成功。六、避坑清单高频现象与解法现象原因解法数据获取失败、视频清晰度偏低Cookie 失效或未登录重新写入 Cookie私密账号需登录且已关注该账号的 Cookie文件没出现在预期目录root为非法路径已回退项目根目录查运行日志中 root 警告改为已存在目录后重启代理配置了却没生效启动时代理测连失败程序自动忽略先手动验证代理可用再确认日志出现「代理测试成功」批量喜欢 / 收藏作品很慢接口只返回发布日期需拉全量再按日期筛选用max_pages控制请求页数缩小日期区间升级后旧作品「丢失」旧版本数据在_internal/Volume新版未继承按 README 更新方案一将旧版_internal/Volume复制到新版_internal多开实例行为异常项目未针对多开优化复制整个项目文件夹各开独立实例 通用操作注意终止程序或 ffmpeg 一律按Ctrl C不要直接点终端关闭按钮批量收藏作品模式仅支持当前登录账号暂不支持多账号本项目不支持付费作品下载。DouK-Downloader 适用于个人作品归档、中小规模账号数据采集与 Web API 服务化集成三类场景双平台能力完整且全部逻辑可读可改。合规提示本项目使用必须自行遵守相关法律法规与平台规则因数据采集与下载行为产生的一切法律责任由使用者自行承担。【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考