DouK-Downloader 抖音与 TikTok 作品下载、数据采集新手指南
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
DouK-Downloader（原名 TikTokDownloader）是一款完全开源的抖音与 TikTok 作品下载、数据采集工具。你可以用它保存单个视频或图集，批量归档某个账号的全部作品，也可以把作品数据导出成 CSV、Excel 或 SQLite 文件。它基于 Python 开发，同时覆盖国内抖音与国际版 TikTok 两个平台，下面按使用场景说明适合人群、安装方式和关键设置。
这个项目适合谁
如果你属于以下情况，可以优先考虑：
- 想把某位创作者的发布作品、喜欢作品、收藏夹内容在本地留档的创作者
- 需要统计点赞数、收藏数、发布时间等字段，做选题或竞品分析的运营人员
- 希望通过 Web API 模式把下载、采集功能嵌入自己脚本或服务的开发者
- 需要获取直播拉流地址并调用 FFmpeg 完成录制的用户
不太适合的场景：它明确不支持付费作品下载；程序内置智能延时请求机制，不适合追求极限高频抓取的使用方式。另外注意，项目内置的加密参数算法已过期失效、不再维护，若个别功能无法工作，需要自行准备对应的参数生成代码，配置方法以官方文档说明为准。
开始前需要准备什么
准备三样东西就能跑起来：
- Python 3.12+ 解释器，并安装 uv；也可以改从 Releases 下载已编译的可执行文件，macOS 用户首次运行前需在终端执行
xattr -cr 项目文件夹路径移除系统安全限制 - 浏览器与账号登录态。按仓库内的 Cookie 获取教程 操作：打开抖音网页版，按 F12 进入开发者工具，切换到"网络"选项卡，勾选"保留日志"，在筛选器输入
cookie-name:odin_tt，加载任意作品评论区后复制完整的 Cookie 值 - 首次启动时把 Cookie 写入配置文件，支持手动输入或从剪贴板读取。Cookie 只在失效后才需要重写，不是每次运行都要粘贴
git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader uv sync --no-dev uv run main.py核心能力如何对应你的任务
- 保存单个作品：在终端交互模式选择"批量下载链接作品"，粘贴分享链接即可。程序会自动跳过已下载的文件，下载时先落到临时文件夹，完成后才移入保存目录，减少文件损坏风险
- 批量归档账号作品：在配置文件的
accounts_urls字段中登记多个账号，通过mark写自定义标识、tab指定发布/喜欢/收藏、enable控制是否启用，程序按列表顺序处理，并支持增量下载新作品 - 导出结构化数据：设置
storage_format后，作品统计字段（点赞、分享、评论数等）会同步落盘，方便用表格软件二次分析 - 接口集成调用：以 Web API 模式启动后，访问
http://127.0.0.1:5555/docs可以浏览自动生成的接口文档，通过 HTTP 请求调用作品、评论等接口 - 直播录制：获取抖音或 TikTok 直播拉流地址后调用 FFmpeg 完成录制，
ffmpeg参数可指定可执行文件路径
几个会影响体验的设置
| 参数 | 默认值 | 作用说明 |
|---|---|---|
folder_name | Download | 作品文件的存放文件夹名 |
name_format | create_time type nickname desc | 文件命名字段组合，可按需增删字段 |
max_pages | 0（不限制） | 请求页数上限，采集喜欢/收藏作品时建议设置，控制耗时 |
max_retry | 5 | 下载失败后的最大重试次数 |
storage_format | 空（不保存） | 数据落盘格式，可选 csv、xlsx、sqlite |
music | False | 是否额外保存独立音乐文件 |
常见问题的快速判断
- 下载不到高画质视频：优先检查 Cookie 是否过期、是否为登录后获取；私密账号的作品需要登录 Cookie，且该账号必须已关注对方
- 请求频繁失败或获取数据异常：先更新 Cookie 再试，其次检查配置文件中的
proxy、proxy_tiktok代理参数，程序启动时会做连通性测试并在日志中提示失败原因 - 个别功能不可用：通常是加密参数算法过期导致，需要按文档自行配置参数生成代码，或留意项目后续版本的更新说明
- 文件名过长或含异常字符：调整
desc_length、name_length、truncate控制描述截断长度；若程序提示某项参数非法，说明已自动回退默认值，可对照日志修正
从试用到稳定使用的下一步
- 先用单条作品链接跑通下载，确认文件与数据记录落在预期目录
- 把 1 到 2 个想长期跟踪的账号加入
accounts_urls，体验增量下载 - 若要做数据分析，开启
storage_format并选定一种保存格式 - 定期检查 logs 目录中的日志，Cookie 失效时重新写入即可恢复
使用采集到的内容时，请注意遵守平台规则、版权要求与当地法律法规，建议将下载与导出数据用于个人备份和合法的分析场景。
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
