douyin-sparkflow/README.md

douyin-sparkflow

Douyin SparkFlow 是一个用于自动续火花的 Web 管理版部署包。推荐用 Docker Compose 部署，启动后在浏览器里完成管理员密码、扫码登录、目标好友勾选和发送窗口设置。

一键部署到服务器

适合 Ubuntu/Debian/CentOS 类服务器：

curl -fsSL https://raw.githubusercontent.com/halfwaystudent/douyin-sparkflow/main/deploy/install-server.sh | bash

也可以指定安装目录或代理订阅：

curl -fsSL https://raw.githubusercontent.com/halfwaystudent/douyin-sparkflow/main/deploy/install-server.sh | APP_ROOT=/opt/douyin-sparkflow PROXY_SUB_URL='你的 Mihomo/Clash 订阅链接' bash

部署完成后打开：

• Web 面板：http://服务器IP:8787
• 扫码登录桌面：Web 面板里的“登录桌面”入口，默认端口 8788

首次使用流程：

1. 创建管理员账号密码。
2. 打开登录桌面，扫码登录抖音。
3. 保存登录态。
4. 刷新好友列表，勾选要续火花的目标好友。
5. 设置发送窗口，例如 10:00-18:00/10m。

本地部署

Windows 本地需要先启动 Docker Desktop，然后运行：

.\deploy\install-local.ps1

带代理订阅：

.\deploy\install-local.ps1 -ProxySubUrl "你的 Mihomo/Clash 订阅链接"

脚本会创建 .env、运行态目录和默认代理配置，然后执行 docker compose up -d --build 并打开 Web 面板。

Linux/macOS 本地可以运行：

./deploy/install-local.sh

常用命令

docker compose ps
docker compose logs -f web
docker compose logs -f scheduler
docker compose up -d --build
docker compose down

刷新代理订阅：

./refresh_proxy.sh
docker compose restart proxy

如果 .env 里的 PROXY_SUB_URL 为空，系统会使用 proxy/config.example.yaml 生成一个直连配置。

首次构建会拉取较大的 Playwright 基础镜像。默认 .env.example 使用国内同步源以加速下载；如果同步源不可用，可以把 .env 里的 PLAYWRIGHT_BASE_IMAGE 改回：

PLAYWRIGHT_BASE_IMAGE=mcr.microsoft.com/playwright/python:v1.56.0-jammy

目录结构

• DouYinSparkFlow/：核心应用、Web UI、登录桌面和发送任务。
• docker-compose.yml：统一容器编排入口，包含 Web、登录桌面、定时器、任务和代理服务。
• deploy/：服务器和本地一键部署脚本。
• proxy/config.example.yaml：安全的代理配置模板。
• .env.example：部署环境变量模板。

不提交的运行态文件

这些内容包含账号、登录态、日志或本机配置，不应提交到 GitHub：

• .env
• state/
• logs/
• proxy/config.yaml
• DouYinSparkFlow/logs/
• DouYinSparkFlow/usersData.json
• DouYinSparkFlow/webui_settings.json
• DouYinSparkFlow/.im_sdk_cache/

许可

核心应用采用 MIT 协议，详见 DouYinSparkFlow/LICENSE。