mirror of
https://github.com/halfwaystudent/douyin-sparkflow.git
synced 2026-06-27 10:21:24 +08:00
92 lines
3.1 KiB
Markdown
92 lines
3.1 KiB
Markdown
# 🔥 Douyin SparkFlow 使用教程
|
|
|
|
这份教程按第一次部署后的操作顺序写。你需要先完成服务器或本地部署，然后访问 Web 面板。
|
|
|
|
## 1. 登录控制台
|
|
|
|
打开 Web 面板地址，例如：
|
|
|
|
- 服务器部署：`http://服务器IP:8787`
|
|
- 本地部署：`http://127.0.0.1:8787`
|
|
|
|
首次打开时创建管理员账号。后续登录时输入管理员用户名和密码。
|
|
|
|
|
|
|
|
## 2. 查看控制台概览
|
|
|
|
登录后进入 **控制台概览**。这里用于快速确认启用账号、今日成功、失败待补发、待发送、未处理和服务状态。
|
|
|
|
右上角的小太阳和小月亮可以切换白天模式和黑夜模式，选择会保存在当前浏览器中。
|
|
|
|
|
|
|
|
## 3. 打开登录工作区
|
|
|
|
进入 **登录工作区**，在远端浏览器里完成抖音扫码、验证码或其他人工验证步骤。
|
|
|
|
如果内嵌 noVNC 无法连接，点击 **新窗口打开**。登录完成后点击 **保存当前账号**，面板会把登录态写入账号配置。
|
|
|
|
|
|
|
|
## 4. 维护账号与目标好友
|
|
|
|
进入 **账号与目标** 查看已保存的账号。你可以启用或停用账号，修改显示名，维护目标好友。
|
|
|
|
如果账号已经保存，可以点击 **刷新好友列表**，再从好友选择器中选择目标好友。保存后，定时任务会按这些目标执行续火花。
|
|
|
|
|
|
|
|
## 5. 设置运行参数和发送窗口
|
|
|
|
进入 **运行与系统** 调整消息模板、随机策略、消息间隔、代理维护和发送窗口。
|
|
|
|
发送窗口使用北京时间，例如：
|
|
|
|
```text
|
|
10:00-18:00/10m
|
|
```
|
|
|
|
这个例子表示每天 `10:00` 到 `18:00` 之间执行，调度间隔为 `10` 分钟。
|
|
|
|
|
|
|
|
## 6. 处理失败和查看日志
|
|
|
|
在概览页可以点击 **查看明细** 查看今日发送明细。遇到失败时，优先使用 **补发未成功目标**，它只会处理失败队列。
|
|
|
|
**补发全部对象** 会重新处理所有启用账号的所有目标，适合确认目标范围后手动执行。
|
|
|
|
需要排查问题时，进入 **运行日志** 查看最近任务输出。
|
|
|
|
## 7. 使用黑夜模式
|
|
|
|
黑夜模式适合夜间运维或长时间盯屏。点击右上角的小月亮即可切换。
|
|
|
|
|
|
|
|
## 常见问题
|
|
|
|
### 登录工作区打不开
|
|
|
|
先点击 **新窗口打开**。如果仍然不可用，检查 `login-desktop` 容器是否运行，并确认服务器防火墙或安全组已放行登录桌面端口。
|
|
|
|
```bash
|
|
docker compose ps
|
|
docker compose logs -f login-desktop
|
|
```
|
|
|
|
### 账号保存后没有好友列表
|
|
|
|
进入 **账号与目标**，点击 **刷新好友列表**。刷新需要当前账号的登录态有效，如果登录态过期，回到 **登录工作区** 重新登录并保存。
|
|
|
|
### 定时任务没有按预期发送
|
|
|
|
检查 **运行与系统** 里的发送窗口，再查看调度容器日志：
|
|
|
|
```bash
|
|
docker compose logs -f scheduler
|
|
```
|
|
|
|
如果只是少量目标失败，先使用 **补发未成功目标**，不要直接补发全部对象。
|