抖音/TikTok 音视频下载与数据采集：DouK-Downloader 完整使用指南
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
想要把抖音或 TikTok 的作品存到本地，或者批量采集某个账号的数据，DouK-Downloader 是一款免费开源的下载工具。它提供终端、后台监听、Web API 三种使用方式，覆盖单条作品下载、批量采集、音频提取和直播录制。本文按任务拆解操作步骤，帮你从零跑通安装、Cookie 配置到日常使用。
📍 项目定位
DouK-Downloader（曾用名 TikTokDownloader）是一款面向抖音和 TikTok 的作品下载与数据采集开源工具，采用 GPL v3.0 协议开放。程序基于 Python 3.12+ 和 HTTPX 模块实现，能处理账号发布、喜欢、收藏作品的批量下载，也能采集评论、搜索、热榜等数据，并获取直播拉流地址。代码按职责拆分成下载器、提取器、加密等模块，放在 src/ 目录下；使用教程与获取文档则集中在 docs/ 目录中。
🚀 安装与首次配置
整条流程是：拉代码 → 跑程序 → 写 Cookie → 重新开始下载。
- 克隆仓库并启动程序（推荐用 uv 管理依赖）：
git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader uv sync --no-dev uv run main.py- 首次启动会先展示免责声明，按提示确认。
- 获取 Cookie：用浏览器打开抖音网页版，按 F12 打开开发者工具，切到"网络"选项卡并勾选"保留日志"，刷新页面后在任一请求中复制完整的 Cookie 值。
- 回到程序界面，选择"手动输入 Cookie"或"从剪贴板读取 Cookie"，把刚才复制的内容写入配置文件。
- 重新启动程序，即可进入主菜单开始下载。
Cookie 只需配置一次，失效时再重新获取即可；登录态的 Cookie 通常能下载到更高分辨率的视频。更完整的字段说明（包括 odin_tt 等）可查阅仓库内的 Cookie 获取教程。
📋 按任务实操
下载单条作品
启动后选择"终端交互模式"，进入"批量下载链接作品"，粘贴抖音或 TikTok 的分享链接。程序会自动解析并保存视频、封面等文件，无需其他参数。
批量采集指定账号
两种方式：一是在终端菜单中逐条输入账号主页链接；二是直接编辑 settings.json 中的accounts_urls数组，每项填mark（账号标识）、url、tab、enable，再运行对应的批量任务。程序会自动跳过已下载的文件，支持增量下载，账号昵称变化时也会同步重命名已保存的文件。
提取音频
在 settings.json 里把music设为True（默认False保存完整视频）。之后运行下载任务时只落盘音频，适合批量提取背景音乐。
录制直播
程序可获取抖音和 TikTok 的直播拉流地址，并调用 FFmpeg 完成实时录制，运行前需在本机安装 ffmpeg，路径异常时可在配置文件的ffmpeg字段中手动指定。
持久化采集数据
把storage_format设为csv、xlsx或sqlite之一，程序会把作品、评论等采集到的数据写入文件；默认不保存任何数据。
🔌 开发者接入（Web API）
如果你要把下载能力接进自己的应用，可以选择"Web API 模式"启动。服务默认监听 5555 端口，启动后访问http://127.0.0.1:5555/docs或http://127.0.0.1:5555/redoc即可浏览自动生成的接口文档。所有功能都以 HTTP 接口暴露，入参出参均为 JSON，一个最小的评论采集调用如下：
from httpx import post api = "http://127.0.0.1:5555/douyin/comment" data = {"detail_id": "0123456789", "pages": 2} response = post(api, json=data) print(response.json())⚙️ 配置与调优
settings.json 是唯一的配置入口，改动后需重启程序生效。常用字段如下：
| 字段 | 作用 | 建议值 |
|---|---|---|
cookie | 抖音平台身份凭证 | 浏览器复制到的有效值 |
folder_name | 下载文件的存放文件夹 | Download |
name_format | 文件命名规则 | create_time type nickname desc |
music | 只保存音频 | False（提取音频时改True） |
download | 是否下载文件 | True |
storage_format | 数据落盘格式 | csv/xlsx/sqlite |
proxy | 请求代理 | 默认留空 |
timeout | 单次请求超时（秒） | 10 |
max_retry | 失败重试次数 | 5 |
chunk | 每次下载的数据块大小 | 2097152（2MB） |
max_pages | 单次任务请求页面上限 | 0表示不限制 |
网络不稳定时优先更新 Cookie 和配置proxy，而不是无脑调大重试次数。
❓ 常见问题
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 视频分辨率偏低 | Cookie 未登录或已失效 | 重新获取登录态 Cookie 并写入配置文件 |
| 数据获取失败或为空 | Cookie 失效、请求频率受限 | 更新 Cookie，或启用proxy走代理 |
| 私密账号作品下不到 | 未关注该账号 | 使用已关注该账号的登录态 Cookie |
| 修改配置无效果 | 程序未重启 | 保存 settings.json 后重启程序 |
| 想多开程序实例 | 多开非优化场景 | 复制整个项目文件夹再启动另一份 |
遇到以上问题仍无解时，可查看 docs/ 目录中的教程和 README.md 里的功能列表、Docker 部署说明，那里也附有作者邮箱与社区入口，方便你反馈 bug 或提需求。
DouK-Downloader 把下载、采集、录制放在同一套配置与接口之下，日常使用记住"Cookie 有效、配置在 settings.json、任务按菜单走"这三点就足够了。
【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
