Douyin TikTok Download API Docker 部署与配置教程

Docker 部署与配置完整教程

本文记录从 Docker Hub 拉取镜像 到 服务成功跑通 的完整过程。

说明：本文仅包含 Docker 部署与原项目配置， 不涉及任何二次开发或功能修改。

一、Docker 拉取镜像

docker pull evil0ctal/douyin_tiktok_download_api:latest

正常情况下会看到类似输出：

Status: Downloaded newer image for evil0ctal/douyin_tiktok_download_api:latest

如果此步骤出现 Client.Timeout exceeded， 一般是服务器访问 Docker Hub 网络问题，与镜像本身无关。

二、启动容器

docker run -d \
  --name douyin_tiktok_api \
  -p 8080:80 \
  evil0ctal/douyin_tiktok_download_api:latest

查看容器状态：

docker ps

CONTAINER ID   IMAGE                                         COMMAND        STATUS
bcafab012be3   evil0ctal/douyin_tiktok_download_api:latest   "./start.sh"   Up

容器状态为 Up，说明服务已成功启动。

三、访问 Swagger 接口文档

curl http://127.0.0.1:8080/docs

或在浏览器中访问：

http://服务器IP:8080/docs

如果返回 Swagger UI 页面， 说明 API 服务运行正常。

四、进入容器（重要说明）

docker exec -it douyin_tiktok_api /bin/bash

进入容器后尝试编辑配置文件：

vim config.yaml
vi config.yaml

bash: vim: command not found
bash: vi: command not found

这是正常现象。
该镜像为极简镜像，默认不包含 vi / vim / nano。

五、是否要从容器中退出？

建议直接退出容器，在宿主机修改配置文件。

exit

六、正确修改 config.yaml 的方式（推荐）

1️⃣ 从容器拷贝配置文件到宿主机

docker cp douyin_tiktok_api:/app/crawlers/douyin/web/config.yaml ./config.yaml

2️⃣ 在宿主机本地编辑

vi config.yaml

你唯一需要修改的内容：

Cookie: 你的抖音 Cookie

请勿修改 User-Agent、headers 结构、msToken、ttwid 等字段， 否则可能导致请求失败。

3️⃣ 拷贝修改后的文件回容器

docker cp ./config.yaml douyin_tiktok_api:/app/crawlers/douyin/web/config.yaml

4️⃣ 重启容器使配置生效

docker restart douyin_tiktok_api

七、配置生效验证

1. 再次访问 /docs
2. 调用 Douyin 下载接口
3. Cookie 有效：返回视频信息或下载地址
4. Cookie 失效：返回 403 或解析失败

八、总结

docker pull
→ docker run
→ docker ps
→ 访问 /docs
→ docker cp 修改配置
→ docker restart

这是一套稳定、可复现、适合写博客和运维记录的标准流程。

本文记录到「服务成功跑通为止」，不涉及任何源码或功能修改。