项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-10-23 · 当前星标 ★ 20846
使用教程
环境要求
- 已安装 Docker 与 Docker Compose
- 已安装 git
- 可使用 openssl 生成随机密钥
- 无需自备 PostgreSQL 和 Redis，Docker Compose 已包含这些服务
- 仅在不使用 Docker、改为本地安装时才需要 PostgreSQL 17（含 TimescaleDB 扩展）、Redis 8、Python 3.12 与 uv
安装与启动步骤
-
1克隆代码仓库
仓库里包含 compose 文件、Dockerfile 和数据库迁移脚本，默认分支是 v5，需要先克隆并进入该目录
git clone https://github.com/Evil0ctal/Douyin_TikTok_Download_API.git cd Douyin_TikTok_Download_API -
2生成 .env 密钥
仓库不附带任何默认密码或密钥，必须自行随机生成；这条命令会写入数据库、Redis 与密钥配置
POSTGRES_PASSWORD=$(openssl rand -hex 24) REDIS_PASSWORD=$(openssl rand -hex 24) cat > .env < -
3启动容器栈
用项目名 dtk 在后台拉起全部服务，首次会拉取镜像并执行数据库迁移，需要等待一段时间
docker compose -p dtk -f docker/compose.yml up -d -
4读取初始化令牌
查看 api 容器日志，日志里会打印 setup token，创建第一个管理员账号时要用到
docker compose -p dtk -f docker/compose.yml logs api -
5创建管理员账号
浏览器打开 http://127.0.0.1:8000，用上一步日志里的令牌完成首个管理员初始化，随后进入 Web 控制台
-
6可选：引导脚本部署
不想手动操作可用官方脚本：它会识别发行版、检查 Docker、按机器规格调整资源上限，之后还能重复运行做运维
curl -fsSL https://raw.githubusercontent.com/Evil0ctal/Douyin_TikTok_Download_API/main/install/install.sh -o install.sh less install.sh bash install.sh
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
DTK_SECRET_KEY | 是 | 服务端密钥，用 openssl rand -base64 48 生成 | k9Xq2vT7mB4nR8sL1pY6wZ3aC5dF0gH2jK4mN7qS9tU= |
POSTGRES_PASSWORD | 是 | PostgreSQL 数据库密码，compose 中 postgres 服务使用 | 3f9a1c7e5b2d8046af13cd95e7b2048c6d1f9a3b5c7e8d02 |
REDIS_PASSWORD | 是 | Redis 密码，拼进 DTK_REDIS_URL 中 | 8b2e4d6f0a1c3e5b7d9f2a4c6e8b0d1f3a5c7e9b2d4f6a8c |
DTK_DATABASE_URL | 是 | 异步数据库连接串，指向 compose 内的 postgres:5432/dtk | postgresql+asyncpg://dtk:3f9a1c7e5b2d8046af13cd95e7b2048c6d1 |
DTK_REDIS_URL | 是 | Redis 连接串，格式为 redis://:密码@redis:6379/0 | redis://:8b2e4d6f0a1c3e5b7d9f2a4c6e8b0d1f3a5c7e9b2d4f6a8c@re |
如何确认成功
访问 http://127.0.0.1:8000，能打开登录页并用日志中的 setup token 成功创建第一个管理员即部署成功。
常见问题
Q：启动后抖音、TikTok 身份无法自动生成怎么办？
A：默认不启动浏览器容器，抖音和 TikTok 身份只能导入、不能自动生成。需要加 --profile browser 启用可选浏览器配置，Bilibili 访客身份则始终走普通 HTTP 生成。
Q：可以直接用官方 demo 实例当服务用吗？
A：不建议。demo 是只读共享实例，请求不写日志和归档，限流为每 10 秒 30 次，超限会被冷却 10 秒，且可能随时下线、重置或关闭。
Q：国内服务器拉镜像很慢或超时怎么办？
A：README 明确提示中国大陆用户应先把镜像源切换好再开始安装，否则拉取大概率超时，具体见文档的网络准备章节。
Q：必须自己装 PostgreSQL 和 Redis 吗？
A：走 Docker Compose 不用，容器已包含。只有不用 Docker 时才需自备 PostgreSQL 17（必须带 TimescaleDB 扩展，普通 postgres:17 不行）、Redis 8、Python 3.12 与 uv。
注意事项
- 仓库中不含任何默认密码或密钥，务必先写好 .env 再启动，不要沿用示例值上线。
- 执行引导脚本前建议先用 less 阅读 install.sh 内容；安装完成后再次运行该脚本（或加 --manage）可进入运维菜单，做升级、备份、改密等操作。
- 默认通过 8000 端口访问 Web 控制台；生产环境请自行加反向代理与访问控制。
- 中国大陆环境先配置镜像源，再执行 docker compose 拉取，避免超时。
核心亮点
- 同时覆盖抖音、TikTok、B站三大平台，接口统一，减少多套采集代码的维护成本
- 内置 MCP Server，AI Agent 可直接调用，无需额外封装适配层
- 自带自愈身份池和 PostgreSQL 归档，采集稳定性和数据持久化考虑较完整
不足之处
- 依赖第三方平台页面结构，平台改版可能导致采集失效，需持续跟进维护
- 自托管部署需要自行维护 PostgreSQL 和身份池，对非运维背景用户有一定成本
适用场景
- 内容运营团队批量采集竞品短视频数据做选题分析
- AI Agent 工作流中通过 MCP 实时获取视频元数据与下载链接
- 研究人员下载视频后离线转写文字，做内容语料分析
替代项目
yt-dlp、TikTokDownloader
上一篇：Data-Copilot
下一篇：Qflow
同类项目推荐
cli
开源
在终端和 AI Agent 里直接操作飞书全套办公能力
The official Lark/飞书 CLI tool, maintained by the larksuite team — built for human···
FlowBot
开源
用 API 控制微信/企微，自动化运营零封号
微信，企微，企微机器人，微信机器人，workbot，worktool，wetool，RPA，协议，vbot，逆向···
clearcote-browser
开源
源码级隐身 Chromium，Playwright 直接换，自动化更难被封
Open-source stealth Chromium with engine-level fingerprint spoofing - de-Googled, dr···
insights-lm-local-package
开源
本地私密版 NotebookLM，文档聊天、音频摘要全离线
Open-source, fully private and local alternative to NotebookLM. Chat with your docum···
blurr
开源
让手机应用像人一样自动干活，解放双手
This app can now use Android, just like a human.
claude-code-workflow
开源
一套配置，让 Claude Code、Codex、Cursor 工作流统一高效
QuietHarness：Claude Code、Codex、Cursor 共用的轻量 AI 工作系统
multizen-browser
开源
给每个 AI 任务一个独立指纹浏览器，多账号互不串味
Anti-detect browser for AI agents and human operators. Isolated Chromium profiles (c···
astron-rpa
开源
让 AI Agent 直接操控软件，自动化流程开箱即用
Agent-ready RPA suite with out-of-the-box automation tools. Built for individuals an···
Konnect
开源
让 Claude 直接帮你画 PCB，从原理图到制造文件
AI-assisted PCB design for KiCAD 10. Native KiCAD plugin — a single Rust binary exp···