diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..7ba4c08 --- /dev/null +++ b/.dockerignore @@ -0,0 +1,10 @@ +.git +.github +build +frontend +docs +work +logs +*.log +deploy/control-center/.env +deploy/control-center/data diff --git a/AGENTS.md b/AGENTS.md index e87f24b..69befe2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -28,3 +28,9 @@ Runtime data, cookies, account files, logs, `config.json`, and fonts must remain ## Agent-Specific Instructions Do not launch browsers or browser automation for UI validation unless explicitly requested. Use type checks, builds, and existing tests. + +## Remote Control Documentation +`docs/远程控制.md` is the source of truth for the optional remote-control system. Any change to `internal/remote/`, `cmd/douyu-control/`, remote settings, remote Web UI, enrollment/token behavior, command protocol, log formats, exports, or control-center storage must update that document in the same change. + +## Proxy Documentation +`docs/代理池与白名单.md` is the source of truth for proxy extraction, whitelist handling, account grouping, standby proxies, runtime failover, and proxy scheduling. Any change to `internal/proxy/`, `internal/seckill/proxy_groups.go`, proxy timing/settings, or proxy logs/statistics must update that document in the same change. diff --git a/README.MD b/README.MD index 5f7835e..972a8d8 100644 --- a/README.MD +++ b/README.MD @@ -59,13 +59,19 @@ GOOS=linux GOARCH=amd64 wails build | `DOUYU_CONTROL_ADDR` | 远端控制台监听地址 | `:18080` | | `DOUYU_CONTROL_DATA` | 远端控制台数据目录 | `remote-data` | | `DOUYU_CONTROL_OPERATOR_TOKEN` | 网页控制台令牌 | 启动时随机生成 | -| `DOUYU_CONTROL_ENROLL_TOKEN` | 可选的新实例注册口令 | 空 | +| `DOUYU_CONTROL_ENROLL_TOKEN` | 新实例注册令牌 | 空 | | `DOUYU_CONTROL_ENROLL_WINDOW` | 无注册口令时的自动注册窗口 | `10m` | ## 远端控制(可选) 远端控制不参与本地定时、代理准备、锁单和支付链路。网络中断时实例继续本地抢购,事件写入本地缓冲后可重连补传。 +完整设计与维护说明见 [docs/远程控制.md](docs/远程控制.md)。 + +代理池、白名单、备用代理和故障回退的当前实现与待讨论方案见 [docs/代理池与白名单.md](docs/代理池与白名单.md)。 + +代理默认启用严格模式:定时任务提前 2 分钟准备,代理未就绪时不启动且不回退直连;品赞提取强制 JSON,同机多实例共享白名单协调锁,主界面直接显示 `G1`、`G2` 或“直连”。 + 构建并启动控制中心: ```bash @@ -73,11 +79,15 @@ GOOS=linux GOARCH=amd64 wails build ./build/bin/douyu-control -addr :18080 -data ./remote-data ``` -程序会打印一个带自动登录信息的管理链接。桌面端在“设置 -> 远端控制”中只需要填写控制中心地址,实例首次连接会自动注册并把独立令牌保存在本机。默认自动注册窗口为控制中心启动后的 10 分钟,窗口关闭后不再接受新实例。 +程序会打印一个带自动登录信息的管理链接。桌面端在“设置 -> 远端控制”中填写控制中心地址和注册令牌,实例首次连接会换取独立令牌并保存在本机。 + +桌面端只填写根地址,例如 `https://control.example.com`,不要带 `/#admin=...` 或子路径。 + +公网部署使用 [deploy/control-center](deploy/control-center/README.md) 中的 Docker Compose 和 Caddy 示例。容器只监听回环地址,HTTPS 由宿主机现有 Caddy 终止。 说明: -- 实例主动通过 WebSocket 外连并自动注册,不需要为每台抢购电脑开放入站端口,也不需要手工配置实例令牌。 +- 实例主动通过 WebSocket 外连并自动注册,不需要为每台抢购电脑开放入站端口,也不需要手工配置实例令牌;只需填写控制中心地址和统一注册令牌。 - 控制台按 `machineId` 动态聚合任意数量的实例,可查看机器、实例、运行结果和实时结构化日志;不假定固定实例数。 - 当前支持远端刷新状态、停止抢购和取消定时;启动/定时任务仍以本地配置为准。 - Cookie、CSRF、代理密码、白名单签名密钥和 Trace 正文不会上传。 diff --git a/deploy/control-center/.env.example b/deploy/control-center/.env.example new file mode 100644 index 0000000..c05c923 --- /dev/null +++ b/deploy/control-center/.env.example @@ -0,0 +1,17 @@ +# 发布到镜像仓库后改为固定版本镜像,例如 ghcr.io/owner/douyu-control:v1.0.0 +DOUYU_CONTROL_IMAGE=douyu-control:local + +# 中国大陆服务器可使用 https://goproxy.cn,direct +GOPROXY=https://proxy.golang.org,direct + +# 宿主机只监听回环地址,由 Caddy 暴露 HTTPS。 +DOUYU_CONTROL_HOST_PORT=18080 + +# 管理网页令牌,与注册令牌必须不同。 +DOUYU_CONTROL_OPERATOR_TOKEN=replace-with-openssl-rand-hex-32 + +# 桌面端“注册令牌”填写同一个值。 +DOUYU_CONTROL_ENROLL_TOKEN=replace-with-another-openssl-rand-hex-32 + +# 仅在未设置注册令牌时启用自动注册窗口。 +DOUYU_CONTROL_ENROLL_WINDOW=10m diff --git a/deploy/control-center/.gitignore b/deploy/control-center/.gitignore new file mode 100644 index 0000000..24f9f8d --- /dev/null +++ b/deploy/control-center/.gitignore @@ -0,0 +1,2 @@ +.env +data/ diff --git a/deploy/control-center/Caddyfile.example b/deploy/control-center/Caddyfile.example new file mode 100644 index 0000000..0d502e0 --- /dev/null +++ b/deploy/control-center/Caddyfile.example @@ -0,0 +1,14 @@ +control.example.com { + encode zstd gzip + + reverse_proxy 127.0.0.1:18080 { + flush_interval -1 + } + + header { + Strict-Transport-Security "max-age=31536000" + Referrer-Policy "no-referrer" + X-Content-Type-Options "nosniff" + X-Frame-Options "DENY" + } +} diff --git a/deploy/control-center/Dockerfile b/deploy/control-center/Dockerfile new file mode 100644 index 0000000..7c82010 --- /dev/null +++ b/deploy/control-center/Dockerfile @@ -0,0 +1,45 @@ +# syntax=docker/dockerfile:1 + +FROM golang:1.26-alpine AS build + +ARG TARGETOS=linux +ARG TARGETARCH=amd64 +ARG GOPROXY=https://proxy.golang.org,direct + +ENV GOPROXY=${GOPROXY} + +WORKDIR /src + +COPY go.mod go.sum ./ +RUN go mod download github.com/gorilla/websocket + +COPY internal ./internal +COPY cmd/douyu-control ./cmd/douyu-control + +RUN CGO_ENABLED=0 GOOS=${TARGETOS} GOARCH=${TARGETARCH} \ + go build -trimpath -ldflags="-s -w" -o /out/douyu-control ./cmd/douyu-control + +FROM alpine:3.22 + +RUN apk add --no-cache ca-certificates tzdata \ + && addgroup -S -g 10001 douyu \ + && adduser -S -D -H -u 10001 -G douyu douyu \ + && mkdir -p /data \ + && chown douyu:douyu /data \ + && chmod 0700 /data + +ENV TZ=Asia/Shanghai \ + DOUYU_CONTROL_ADDR=:18080 \ + DOUYU_CONTROL_DATA=/data + +COPY --from=build /out/douyu-control /usr/local/bin/douyu-control + +USER 10001:10001 + +EXPOSE 18080 +VOLUME ["/data"] + +HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \ + CMD wget -qO- http://127.0.0.1:18080/api/health >/dev/null || exit 1 + +ENTRYPOINT ["douyu-control"] diff --git a/deploy/control-center/README.md b/deploy/control-center/README.md new file mode 100644 index 0000000..6463baf --- /dev/null +++ b/deploy/control-center/README.md @@ -0,0 +1,109 @@ +# 远端控制中心部署 + +该目录只包含控制中心的部署文件。Go 源码仍位于仓库的 `cmd/douyu-control` 和 `internal/remote`,避免桌面端 Agent 与控制中心协议分叉。 + +## 架构 + +```text +Internet + -> Caddy 443 + -> 127.0.0.1:18080 + -> douyu-control 容器 + -> ./data +``` + +Caddy 不放入该 Compose。继续使用宿主机现有 Caddy,避免重复申请证书和占用 80/443。 + +## 首次部署 + +```bash +cd deploy/control-center +cp .env.example .env +openssl rand -hex 32 +openssl rand -hex 32 +``` + +把两个随机值分别填入 `.env`: + +```text +DOUYU_CONTROL_OPERATOR_TOKEN=管理网页令牌 +DOUYU_CONTROL_ENROLL_TOKEN=桌面实例注册令牌 +``` + +创建数据目录并交给容器用户: + +```bash +sudo install -d -m 0700 -o 10001 -g 10001 data +docker compose up -d --build +``` + +如果服务器无法访问 `proxy.golang.org`,将 `.env` 中的 `GOPROXY` 改为可用的 Go 模块代理,例如 `https://goproxy.cn,direct`。 + +检查: + +```bash +curl http://127.0.0.1:18080/api/health +docker compose ps +docker compose logs -f --tail=100 +``` + +## Caddy + +把 `Caddyfile.example` 中的配置改好域名后加入宿主机现有 Caddy 站点配置,然后验证并重载: + +```bash +sudo caddy validate --config /etc/caddy/Caddyfile +sudo systemctl reload caddy +``` + +公网防火墙只开放 `80/443`,不要开放 `18080`。Caddy 会自动处理 HTTPS 和 Agent WebSocket Upgrade。 + +## 桌面实例 + +每个实例填写: + +```text +控制中心地址: https://control.example.com +注册令牌: 与 DOUYU_CONTROL_ENROLL_TOKEN 相同 +``` + +实例首次连接时使用注册令牌换取独立实例令牌,之后复用本机凭据。控制中心不需要保存桌面端的注册令牌。 + +## 管理网页 + +```text +https://control.example.com/#admin= +``` + +`#admin` 不会发送给服务器,页面读取后会从地址栏移除。 + +## 数据与备份 + +```text +data/ + events.ndjson + runs.ndjson + agent_tokens.json +``` + +`agent_tokens.json` 丢失后,已有实例需要重新注册。至少每天备份一次整个 `data` 目录。 + +当前 NDJSON 不会自动轮转。长期运行前需要增加应用层保留策略,不能只依赖 Docker 容器日志轮转。 + +## 升级 + +使用本地构建: + +```bash +docker compose build --pull +docker compose up -d +``` + +使用镜像仓库时,将 `.env` 中的 `DOUYU_CONTROL_IMAGE` 改为固定版本,然后: + +```bash +docker compose pull +docker compose up -d +``` + +升级不会删除 `data`。控制中心只能运行一个副本,不能直接水平扩容。 diff --git a/deploy/control-center/compose.yaml b/deploy/control-center/compose.yaml new file mode 100644 index 0000000..142c337 --- /dev/null +++ b/deploy/control-center/compose.yaml @@ -0,0 +1,34 @@ +name: douyu-control + +services: + control-center: + image: ${DOUYU_CONTROL_IMAGE:-douyu-control:local} + build: + context: ../.. + dockerfile: deploy/control-center/Dockerfile + args: + GOPROXY: ${GOPROXY:-https://proxy.golang.org,direct} + env_file: + - .env + environment: + DOUYU_CONTROL_ADDR: ":18080" + DOUYU_CONTROL_DATA: "/data" + TZ: "Asia/Shanghai" + ports: + - "127.0.0.1:${DOUYU_CONTROL_HOST_PORT:-18080}:18080" + volumes: + - ./data:/data + restart: unless-stopped + read_only: true + tmpfs: + - /tmp + security_opt: + - no-new-privileges:true + cap_drop: + - ALL + stop_grace_period: 20s + logging: + driver: json-file + options: + max-size: "20m" + max-file: "3" diff --git a/docs/代理池与白名单.md b/docs/代理池与白名单.md new file mode 100644 index 0000000..120c4f6 --- /dev/null +++ b/docs/代理池与白名单.md @@ -0,0 +1,647 @@ +# 代理池与白名单 + +本文档是斗鱼抢购系统代理池、动态提取、白名单、账号分组、备用代理和故障回退功能的分析与维护入口。 + +任何涉及以下内容的修改,都必须在同一变更中同步更新本文档: + +- `internal/proxy/` +- `internal/seckill/proxy_groups.go` +- 定时代理准备和立即抢购代理准备 +- 白名单添加、代理提取、代理校验 +- 账号分组、备用代理、故障切换 +- 代理相关配置和共享配置 +- 代理池演练 +- 代理日志、统计和故障结论 + +## 1. 优先级 + +本地抢购始终优先。 + +- 代理功能不能依赖远端控制中心。 +- 远端网络中断不能影响代理准备和本地抢购。 +- 代理后台失败允许回退,但回退策略属于抢购策略的一部分,必须单独评审。 +- 代理日志应能准确说明实际使用的是代理还是直连。 + +## 2. 当前总体流程 + +```text +读取代理配置 + ↓ +按账号数量分组 + ↓ +计算活动代理和备用代理数量 + ↓ +调用代理提取 API + ↓ +必要时添加/校验白名单 + ↓ +校验代理出口和延迟 + ↓ +账号绑定代理客户端 + ↓ +运行期间监控代理传输故障 + ↓ +优先切换备用代理 + ↓ +无备用代理时切换直连 +``` + +定时抢购和立即抢购使用同一套分组逻辑,但准备时间和超时不同。 + +## 3. 主要代码 + +| 路径 | 职责 | +|---|---| +| `internal/proxy/service.go` | 代理平台抽象、提取、自动白名单 | +| `internal/proxy/ipzan.go` | 品赞 API、白名单签名和响应解析 | +| `internal/proxy/generic.go` | 通用代理 API 和文本格式解析 | +| `internal/client/proxy.go` | 代理 URL、HTTP 客户端和连接错误处理 | +| `internal/client/proxy_health.go` | 传输故障监控回调 | +| `internal/client/proxy_probe.go` | 代理只读探测 | +| `internal/seckill/proxy_groups.go` | 分组、提取、校验、备用、故障切换 | +| `internal/seckill/scheduler.go` | 抢购主流程和代理准备入口 | +| `internal/seckill/schedule_timer.go` | 定时任务触发前的代理准备 | +| `internal/app/app_proxy.go` | 手动提取和启动时刷新 | +| `internal/app/app_proxy_drill.go` | 代理池演练 | +| `internal/app/app_shared_proxy_config.go` | 跨实例加载/保存共享代理配置 | +| `frontend/src/components/modal/SettingsModal.vue` | 桌面端代理设置和演练界面 | + +## 4. 配置 + +主要配置字段: + +| 字段 | 说明 | +|---|---| +| `proxyEnabled` | 是否启用代理 | +| `proxyRequired` | 严格代理模式:代理未就绪时不启动,也不自动回退直连 | +| `proxyUrl` | 当前静态代理地址 | +| `proxyApi` | 动态代理提取 API | +| `proxyExpiresAt` | 当前静态代理过期时间 | +| `autoFetchProxyOnSchedule` | 定时抢购前自动提取代理 | +| `accountsPerProxy` | 每个活动代理承载的账号数 | +| `proxySparePercent` | 备用代理比例 | +| `proxyAutoWhitelist` | 提取前自动添加白名单 | +| `proxyWhitelistReplace` | 白名单满时替换最早 IP | +| `proxyWhitelistPassword` | 品赞登录密码 | +| `proxyWhitelistSignKey` | 品赞 AES 签名密钥 | + +默认值: + +```text +账号/组 = 5 +备用比例 = 50%(最低 50%) +严格代理模式 = 开启 +``` + +备用代理数量按活动代理数量向上取整,至少为 1: + +```text +备用数量 = ceil(活动代理数 × 备用比例 / 100) +``` + +因此 4 个活动代理默认有 2 个备用代理。 + +## 5. 共享代理配置 + +共享配置用于让同一台电脑或一组电脑使用相同代理参数。 + +共享文件不保存: + +- 当前运行时代理 URL +- 当前代理过期时间 +- 账号或 Cookie + +共享文件当前包含: + +- 代理启用状态 +- 严格代理模式 +- 代理提取 API +- 账号分组 +- 备用比例 +- 定时预取 +- 自动白名单 +- 白名单密码和签名密钥 +- 远端控制配置 + +共享文件可能包含敏感凭据,权限必须限制为仅当前用户可读写。 + +## 6. 代理提取 + +支持的来源: + +1. 动态提取 API。 +2. 一个或多个静态代理。 +3. 动态代理不足时回退静态代理。 + +品赞代理返回格式必须是 JSON。 + +只有 JSON 才能保留每个代理的独立用户名和密码。TXT 通常只返回 `IP:端口`,会丢失代理认证信息,实际连接时容易出现 `407 Proxy Authentication Required`。 + +因此: + +- 品赞控制台中的提取格式应选择 JSON。 +- 程序对所有品赞提取请求都会强制使用 `format=json`,包括账号密码模式和普通模式。 +- 手工粘贴或修改提取 API 时,不得改回 TXT。 +- 静态 HTTP 代理如果带账号密码,也必须保留完整的 `http://user:pass@ip:port` 格式。 + +提取流程: + +1. 计算活动代理数量和备用目标。 +2. 调用动态 API。 +3. 去重。 +4. 校验未过期。 +5. 通过只读接口验证代理。 +6. 验证失败则继续轮次提取。 +7. 动态代理不足时尝试静态代理。 + +当前常量: + +```text +提取基础轮次 = 3 +最大轮次 = 20 +提取重试间隔 = 1200ms +单次请求超时 = 15s +代理校验超时 = 3s +校验 worker = 3 +校验尝试次数 = 1 +``` + +## 7. 白名单 + +### 当前流程 + +品赞启用自动白名单时: + +1. 先尝试提取代理。 +2. 平台提示当前 IP 不在白名单。 +3. 从平台错误中读取实际公网 IP。 +4. 同一台电脑的多个实例通过跨进程文件锁串行处理该 IP。 +5. 在锁内复用 10 分钟内的成功标记,避免重复添加。 +6. 无成功标记时先校验白名单;未添加则等待 1.2 秒,避开品赞 1 秒限频。 +7. 使用登录密码、API secret 和签名密钥生成签名并添加。 +8. 写入本机成功标记后释放锁,再继续提取代理。 + +品赞返回的常见限制: + +```text +白名单仅支持1秒访一次 +访问频率过快,休息一下 +``` + +### 限频处理 + +以下消息现在按可重试错误处理,不再中断代理准备: + +```text +添加白名单失败: 访问频率过快 +白名单仅支持1秒访一次 +提取频率过快 +``` + +代理提取重试间隔已调整为 1.2 秒。定时任务会在 `T-120s` 开始准备,并持续重试到 `T-15s`,为限频恢复留出窗口。 + +## 8. 账号分组 + +账号按名称排序后顺序分组,保证相同账号集合尽量得到稳定分组。 + +例如: + +```text +20 个账号,每组 5 个 +→ 4 个活动代理组 +→ 默认 2 个备用代理 +``` + +每个活动组使用独立 HTTP 客户端;同组账号共享一个代理出口。 + +## 9. 代理状态可视化 + +### 目标 + +主界面必须直接显示当前实例的代理准备状态,以及每个账号实际属于哪个代理组,不能要求用户分析抢购日志。 + +需要同时覆盖: + +- 桌面端当前实例主界面。 +- 远端 Web 控制台中的每个实例。 +- 代理池准备阶段。 +- 抢购运行阶段。 +- 备用切换和直连回退之后。 + +### 当前实现 + +调度器现在维护结构化代理状态,不再要求前端解析日志: + +```text +ProxyStatusView + enabled / required / state + activeCount / standbyCount / standbyTarget / directCount + lastError / updatedAt + groups[] + accounts[] +``` + +状态值: + +```text +disabled 代理未启用 +empty 尚未准备 +preparing 正在提取、加白名单或校验 +ready 活动代理和备用代理达到目标 +degraded 代理仍可用,但备用不足或存在失败组 +failed 准备失败或严格模式阻止运行 +direct_fallback 非严格模式已回退直连 +stale 配置已变更,等待重新准备 +``` + +代理组和账号映射都来自运行时结构: + +- 组号、账号数、账号列表。 +- 脱敏后的出口、地区、RTT。 +- 使用中、失败或直连状态。 +- 切换次数和最近错误。 +- 每个账号当前是 `G1`、`G2`、`直连` 还是未分配。 + +### 主界面 + +主界面新增代理状态条,显示: + +```text +活动 4 · 备用 2/2 · 直连 0 +G1 5号 · G2 5号 · G3 5号 · G4 5号 +``` + +账号作战表新增“代理”列。每组直接显示 `G1`、`G2` 等标签,直连显示红色“直连”,悬停可查看脱敏出口。 + +准备中、降级、失败、直连回退和配置变更都有独立状态文案。严格代理模式就绪时会明确显示“严格代理已就绪”。 + +### 远端展示 + +每个实例行显示活动、备用和直连数量。“代理”按钮可展开当前分组、出口、地区、RTT、切换次数和错误。 + +Agent 通过结构化 `proxyStatus` 上报,桌面端通过 `GetProxyStatus` 读取;两条链路使用同一个 `ProxyStatusView`。 + +### 更新时点 + +状态会在以下时点更新: + +- 开始代理准备。 +- 分组和校验完成。 +- 账号绑定完成。 +- 代理传输异常。 +- 切换备用代理。 +- 回退直连。 +- 补提取成功并重新绑定失败组。 +- 配置变更。 + +代理 URL 只暴露脱敏结果,不包含用户名和密码。 + +## 10. 代理校验 + +当前校验使用只读接口,不会: + +- 读取 Cookie +- 锁单 +- 支付 +- 消耗积分 + +校验内容: + +- 代理是否可连接 +- 出口是否可用 +- 返回延迟 +- 接口是否能在超时内完成 + +校验成功不代表代理在抢购瞬间一定稳定。2026-11-21 的日志显示,代理在 17:59:32 左右获取并校验成功,18:00:06 左右仍发生了集中传输故障。 + +## 11. 定时抢购当前准备时序 + +当前代码: + +```text +T-120s 开始定时代理准备 +T-120s 至 T-15s 持续重试白名单、提取和校验 +T-15s 关闭代理准备窗口 +T-8s 时间临近复校 +T-2s 预热 +T-0s 本地定时触发 +``` + +定时触发前会再次检查严格代理门禁。 + +严格模式开启且代理已启用时,即使“定时自动预取”未勾选,也会在 `T-120s` 执行代理准备,避免定时触发时因没有准备记录被门禁直接拦截。普通模式仍按“定时自动预取”开关决定是否提前提取。 + +严格代理模式开启时,代理准备失败会: + +1. 清除未完成的代理客户端。 +2. 标记代理状态为失败。 +3. 定时触发时阻止抢购并记录原因。 +4. 不使用直连兜底。 + +严格模式关闭时,准备失败仍会记录并回退直连,保证旧策略可继续使用。 + +立即抢购会同步准备代理,默认超时 5 秒。准备后同样执行严格代理门禁,失败原因会直接返回界面。 + +## 12. 运行期故障切换 + +代理健康监控记录传输层错误。 + +当前切换规则: + +1. 单次网络异常只计数。 +2. 同一代理组连续 2 次传输故障才切换。 +3. 有备用代理时,整组切换到备用代理。 +4. 严格模式且无备用代理时,该组标记失败并等待补提取,不切直连。 +5. 非严格模式且无备用代理时,整组切换到直连。 +6. 补提取成功后会优先重新接回仍在等待的失败组。 +7. 切换后继续补提取备用代理。 + +非严格模式已经主动切换到直连的组,不会在运行中自动切回代理;严格模式保留失败组状态,因此可以在新备用到达后重新绑定。 + +## 13. 代理有效期 + +当前系统支持: + +- 代理 API 返回的 `expiresAt` +- API URL 中的 `minute` 或 `min` +- 未提供时默认按 10 分钟估算 + +当前用户的实际代理套餐有效期为 10 分钟。 + +因此提前 2 分钟准备代理不会导致正常抢购期间过期,但仍应保留至少 5 分钟安全余量。 + +## 14. 代理池演练 + +代理池演练: + +- 使用只读接口 +- 不读取账号 CK +- 不锁单 +- 不支付 +- 不消耗积分 +- 抢购运行中禁止执行 + +演练可模拟账号数,计算活动代理和备用代理数量,并逐个验证代理节点。 + +演练通过只说明当前时点可用;不能保证开抢瞬间不会集中故障。 + +## 15. 2026-11-21 实测摘要 + +日志目录: + +```text +/Users/yml/日志/斗鱼/11.21 +``` + +总体: + +```text +任务数 = 40 +账号名额 = 798 +成功 = 200 +失败 = 598 +成功率 = 25.06% +``` + +失败原因: + +```text +活动火爆 = 596 +点击太快 = 2 +售罄 = 0 +登录失效 = 0 +账号终止 = 0 +``` + +按实际网络路径: + +| 路径 | 实例数 | 账号数 | 成功 | +|---|---:|---:|---:| +| 代理池成功准备 | 10 | 200 | 200 | +| 配置代理但回退直连 | 20 | 398 | 0 | +| 明确直连 | 10 | 200 | 0 | + +代理准备和切换: + +```text +白名单限频导致代理准备失败 = 20 个实例 +成功准备代理池 = 10 个实例 +代理故障切换 = 40 次 +切换备用代理 = 11 次 +切换直连 = 29 次 +备用代理补提取 = 11 次 +补提取后重新接入失败组 = 0 次 +``` + +结论: + +- 当天成功与“代理池真实准备成功”高度一致。 +- 直连和代理回退批次当天没有成功锁单。 +- 主要根因是白名单限频被错误判定为致命错误,不是账号或库存本身。 + +## 16. 当前已知限制 + +### 备用数量不足 + +默认 50% 时,4 个活动代理只有 2 个备用代理,无法覆盖 4 个代理同时故障。 + +备用不足时严格模式会让失败组等待补提取,但抢购窗口不会因为等待代理而延长。 + +### 远端白名单协调尚未实现 + +同一台电脑内的多实例白名单已通过跨进程锁和成功标记去重。 + +跨机器的全局白名单队列仍待远端控制中心实现;当前每台机器仍独立处理自己的公网 IP。 + +### 日志标签可能误导 + +代理失败回退直连后,网络统计仍可能显示为“代理组1”,不能仅凭统计组名判断真实出口。 + +界面已经使用结构化状态显示真实出口;基于历史日志的导出统计仍需继续补齐真实网络路径字段。 + +## 17. 待讨论方案 + +以下保留已落地结论和仍待实现的事项。 + +### A. 提前 2 分钟准备(已实现) + +当前行为: + +- `T-120s` 开始代理准备。 +- `T-15s` 最终关闭代理准备窗口。 +- 中间持续重试白名单、提取和校验。 +- 立即抢购在启动前同步准备,默认超时 5 秒。 + +这样可以覆盖 10 分钟代理有效期,并给白名单限频、提取限频和验证失败留下恢复时间。 + +### B. 远端控制统一管理白名单(待实现) + +方向已确认:由远端控制中心做白名单的全局管理和调度,而不是让每个实例分别请求品赞。 + +推荐采用“远端管理 + 本机兜底”的结构: + +```text +远端控制中心 + ├─ 机器公网 IP 状态 + ├─ 全局白名单命令串行队列 + ├─ 1 秒/次限频 + ├─ 每台机器只保留一个有效白名单 + └─ 白名单状态和最近检查时间 + ↓ +每台电脑的本地协调层 + ├─ 执行远端下发的幂等白名单命令 + ├─ 使用本机保存的品赞凭据 + ├─ 接收/缓存白名单状态 + ├─ 同一台机器多实例去重 + ├─ 开抢前本地复核 + └─ 远端不可用时执行本地兜底 + ↓ +各实例只负责提取自己的代理组 +``` + +远端控制中心应负责: + +- 按 `machineId` 管理,而不是按实例管理。 +- 收集或探测每台电脑实际公网 IP。 +- 串行向各机器下发 `ensure_whitelist` 命令。 +- 等待本机命令回执后再推进队列,保证同一公网 IP 只添加一次。 +- 显示 ready、pending、failed、expired。 +- 在计划抢购前更早执行,例如 `T-10min` 或 `T-5min`。 + +本地协调层应负责: + +- 同一台电脑多实例共享白名单状态。 +- `T-2min` 代理准备前确认白名单仍有效。 +- 远端不可用时使用本地缓存继续。 +- 必要时执行一次本地幂等兜底,不让远端成为单点故障。 +- 品赞密码和签名密钥仍只保存在本机,不集中上传控制中心。 + +不建议: + +- 每个实例直接请求远端。 +- 远端在 `T-0s` 才下发白名单命令。 +- 远端不可用时本地完全无法抢购。 +- 控制中心收集或保存品赞明文密码和签名密钥。 + +白名单属于低频、可提前完成的操作,应该放在代理提取之前,而不是放进最紧张的锁单窗口。 + +### C. 白名单限频与同机去重(本地已实现) + +已实现: + +- “访问频率过快”和“1秒访一次”按可重试错误处理。 +- 提取重试间隔 1.2 秒。 +- 同一台电脑的多个实例共享跨进程白名单锁。 +- 添加成功后写入 10 分钟本地标记,兄弟实例直接复用。 +- 远端不可用不影响本地白名单兜底。 + +### D. 严格代理模式(已实现) + +配置项: + +```text +proxyRequired = true +``` + +默认开启。代理未启用时不影响本地直连抢购。 + +严格代理模式下: + +- 代理未就绪不启动抢购。 +- 不自动回退直连。 +- 运行期无备用代理时该组不改直连,保留失败状态并补提取。 +- 补提取成功后重新接回代理。 +- 立即启动和定时触发都执行同一代理门禁。 + +仍待产品决策: + +- 是否保留一台“明确直连”实例用于对照。 +- 运行期等待代理时是否允许超过抢购窗口。 + +### E. 备用代理策略 + +即使提高到 50%,4 个活动代理也只有 2 个备用,仍不足以覆盖 4 个代理同时故障。 + +候选: + +1. 提高备用比例到 100%。 +2. 保持低备用比例,但失败组等待补提取。 +3. 将备用代理视为共享资源池,动态分配给故障组。 + +需要结合品赞套餐配额和成本决定。 + +### F. 失败组重新接回代理(严格模式已实现) + +严格模式不把失败组改绑直连,而是保留失败状态。备用补提取成功后,优先重新绑定这些组。 + +### G. 日志区分真实出口(界面已实现,统计待补齐) + +桌面端和远端界面已显示 `G1`、`G2`、`直连`。后续需要让基于历史日志的统计也明确区分: + +```text +真实代理 +代理回退直连 +明确直连 +``` + +不能继续把回退直连显示为代理组。 + +## 18. 推荐实施顺序 + +已完成: + +1. 修复白名单限频错误分类。 +2. 把代理准备提前到 2 分钟。 +3. 使用 1.2 秒慢重试和同机跨进程去重。 +4. 增加正式代理状态快照和账号映射。 +5. 在主界面和远端控制台展示代理组状态。 +6. 增加严格代理模式并覆盖立即、定时和运行期路径。 +7. 严格模式下用补提取备用重新接回失败组。 + +后续优先级: + +1. 远端统一白名单协调队列。 +2. 评估 50% 备用是否继续提高,或改为共享备用池。 +3. 修复历史日志和导出统计中的真实出口标签。 +4. 根据实际套餐成本决定是否保留明确直连对照实例。 + +## 19. 验证要求 + +修改代理相关逻辑后至少运行: + +```bash +go test ./internal/... +go test ./... +cd frontend && npm run type-check +./build.sh build +``` + +应覆盖: + +- 白名单限频后重试成功。 +- 多个实例共享同一公网 IP。 +- 严格模式下代理失败不启动抢购。 +- 备用代理切换。 +- 无备用时不回退直连。 +- 新备用到达后失败组重新接回代理。 +- 代理回退直连的真实日志标签。 +- 代理有效期计算。 +- 每个账号到代理组的映射。 +- 备用切换后分组状态更新。 +- 直连回退后界面不显示为真实代理。 +- 远端收到的代理状态与桌面端一致。 + +## 20. 决策记录 + +| 日期 | 结论 | 状态 | +|---|---|---| +| 2026-11-21 | 本地抢购优先,代理和远端均不得阻塞抢购主链路 | 已确认 | +| 2026-11-21 | 10 分钟代理提前 2 分钟准备,并在 T-15s 截止 | 已实现 | +| 2026-11-21 | 同一台电脑多实例不应重复添加白名单 | 已实现本机跨进程去重 | +| 2026-11-21 | 白名单优先由远端控制中心统一排程和管理,本地保留兜底 | 方向确认,待实现 | +| 2026-11-21 | 品赞所有提取请求必须使用 JSON 格式 | 已实现 | +| 2026-11-21 | 白名单和提取限频必须按可重试错误处理 | 已实现 | +| 2026-11-21 | 严格代理模式和无直连策略需要支持 | 已实现,默认开启 | +| 2026-11-21 | 备用代理默认和最低比例调整为 50% | 已实现 | +| 2026-11-21 | 50% 备用是否足以覆盖集中故障 | 待评审 | +| 2026-11-21 | 主界面必须直接显示实例内各代理组和账号归属,不能依赖日志分析 | 已实现 | diff --git a/docs/远程控制.md b/docs/远程控制.md new file mode 100644 index 0000000..9811052 --- /dev/null +++ b/docs/远程控制.md @@ -0,0 +1,513 @@ +# 远端控制与日志汇总 + +本文档是斗鱼抢购系统远端控制功能的唯一维护入口。 + +任何涉及以下内容的修改,都必须在同一提交中同步更新本文档: + +- `internal/remote/` +- `cmd/douyu-control/` +- 桌面端远端设置、主界面远端状态 +- 远端 Web 控制台 +- 实例注册、令牌、命令协议 +- 远端日志、运行记录、导出格式 +- 远端数据目录和部署方式 + +## 1. 设计原则 + +本地抢购始终拥有最高优先级。 + +- 远端控制不参与定时计算、代理准备、锁单、支付和结果核对。 +- 远端连接失败、服务器宕机或网络中断不能阻塞本地抢购。 +- 本地定时任务必须在本地触发,不能依赖远端实时发送启动命令。 +- 远端日志使用异步队列,队列满时允许丢弃远端事件,优先保护抢购链路。 +- 远端控制当前定位于监控、日志汇总、结果查看和应急停止。 + +## 2. 总体架构 + +```text +抢购电脑 + 实例 1 ─┐ + 实例 2 ─┼─ 每个实例独立异步上报 + 实例 N ─┘ + │ + │ WebSocket 主动外连 + HTTP 自动注册 + ↓ +远端控制中心 douyu-control + ├─ 机器/实例在线状态 + ├─ 结构化实时日志 + ├─ 抢购运行摘要 + ├─ 命令下发与回执 + ├─ CSV / JSON 导出 + └─ Web 管理页面 + ↑ + │ 浏览器访问 + │ +管理电脑 / 手机 +``` + +一台机器可以运行任意数量的实例。服务端只按 `machineId` 聚合,不假定固定数量、实例编号连续或每台机器必须启动几个实例。 + +## 3. 主要代码 + +| 路径 | 职责 | +|---|---| +| `internal/remote/protocol.go` | 实例状态、日志、命令和 WebSocket 消息结构 | +| `internal/remote/agent.go` | 桌面实例连接、重连、心跳、命令执行 | +| `internal/remote/credentials.go` | 自动注册和实例凭据保存 | +| `internal/remote/spool.go` | 非阻塞日志落盘、断线续传偏移 | +| `internal/remote/machine.go` | 本机稳定机器 ID | +| `internal/remote/server.go` | HTTP API、WebSocket Agent 接入、鉴权 | +| `internal/remote/token_store.go` | 服务端实例令牌签发和持久化 | +| `internal/remote/hub.go` | 机器状态、运行记录、日志、导出 | +| `internal/remote/web/index.html` | 远端 Web 控制台 | +| `internal/app/app_remote.go` | 桌面 App 与远端 Agent 的连接 | +| `internal/logger/logger.go` | 本地日志到远端观察器的非阻塞分发 | +| `cmd/douyu-control/main.go` | 控制中心启动入口 | +| `frontend/src/components/layout/RightConsole.vue` | 主界面远端状态入口 | +| `frontend/src/components/modal/SettingsModal.vue` | 桌面端远端设置 | + +## 4. 身份与聚合 + +### 机器 ID + +每个抢购机器生成一次稳定的随机 `machineId`,同一台电脑上的所有实例共享。 + +默认位置: + +```text +<机器数据根目录>/remote/machine_id +``` + +控制台按 `machineId` 聚合机器,再展示这台机器下所有在线或最近连接的实例。 + +### 实例 ID + +实例 ID 使用软件当前的实例名称,例如: + +```text +默认实例 +实例 2 +实例 3 +临时实例 +``` + +服务端不要求实例编号连续,也不要求每台机器实例数量一致。 + +## 5. 自动注册与令牌 + +实例令牌全自动获取,不需要人工复制。首次注册需要控制中心注册令牌,桌面端填写正确的控制中心地址和注册令牌即可。 + +### 首次注册 + +1. 桌面实例启用远端控制,填写控制中心地址和注册令牌。 +2. Agent 携带 `X-Enroll-Token` 请求 `POST /api/enroll`。 +3. 控制中心为该 `machineId + instanceId` 签发独立令牌。 +4. 令牌保存在本机实例数据目录。 +5. Agent 使用令牌连接 `/ws/agent`。 +6. 后续重连直接复用本地令牌。 + +### 自动注册窗口 + +如果服务端没有配置注册口令,则控制中心启动后开放一个注册窗口。 + +- 默认窗口:10 分钟。 +- 可通过 `-enroll-window` 或 `DOUYU_CONTROL_ENROLL_WINDOW` 修改。 +- 窗口关闭后不接受新的实例注册。 +- 已注册实例不受窗口关闭影响。 +- 已有令牌继续有效。 + +公网部署必须配置 `-enroll-token` 或 `DOUYU_CONTROL_ENROLL_TOKEN`,避免开放自动注册窗口。桌面端“注册令牌”填写同一个值。 + +注册令牌只用于首次换取实例令牌,不会作为 WebSocket 连接令牌持续使用。 + +### 令牌文件 + +服务端: + +```text +<控制中心数据目录>/agent_tokens.json +``` + +桌面实例: + +```text +<机器数据根目录>/remote/instances/<实例数据目录名>.json +``` + +### 鉴权 + +- 管理接口必须携带管理令牌。 +- Agent WebSocket 必须携带由服务端签发的实例令牌。 +- 无有效令牌访问受保护接口返回 `401`。 +- 实例令牌与 `machineId + instanceId` 不匹配时,WebSocket 会被关闭。 + +旧版共享 `-agent-token` 仍保留兼容,但不是默认使用方式。 + +## 6. 桌面端配置 + +设置路径: + +```text +设置 -> 远端控制 +``` + +字段: + +| 字段 | 说明 | +|---|---| +| 启用远端上报 | 开启或关闭当前实例的远端功能 | +| 控制中心地址 | 例如 `https://control.example.com` | +| 注册令牌 | 与控制中心的 `DOUYU_CONTROL_ENROLL_TOKEN` 相同 | +| 机器显示名称 | 留空时使用主机名 | + +实例令牌不需要填写,也不会显示在设置中。旧版 `remoteToken` 仅作为兼容字段保留。 + +控制中心地址必须是根地址,例如 `https://control.example.com`。不要填写 `/#admin=...`、查询参数或子路径。 + +主界面顶栏会显示远端状态: + +- `远端 · 未启用` +- `远端 · 连接中` +- `远端 · 已连接` + +点击状态按钮会打开设置并定位到远端区域。 + +远端配置也可以写入共享配置 JSON 的 `remote` 字段,其中 `enrollmentToken` 用于给新实例统一注册。共享文件可能包含注册令牌,应当限制文件权限。 + +## 7. 启动控制中心 + +### Docker Compose + +部署文件位于: + +```text +deploy/control-center/ +``` + +该目录包含 Dockerfile、Compose、环境变量示例、Caddy 示例和部署说明。继续复用宿主机现有 Caddy,Compose 只暴露回环地址: + +```text +127.0.0.1:18080 +``` + +完整步骤见: + +```text +deploy/control-center/README.md +``` + +### 单二进制 + +构建: + +```bash +./build.sh control +``` + +本地启动: + +```bash +./build/bin/douyu-control \ + -addr :18080 \ + -data '/Users/yml/Library/Application Support/douyu-go-control' +``` + +不指定管理令牌时,程序会随机生成,并打印可自动登录的 Web 地址: + +```text +http://127.0.0.1:18080/#admin=<管理令牌> +``` + +`#admin` 是浏览器本地片段,不会发送给服务器。Web 页面读取后保存到浏览器本地,并立即从地址栏移除。 + +局域网其他电脑访问时使用本机局域网 IP,例如: + +```text +http://192.168.10.6:18080/#admin=<管理令牌> +``` + +桌面实例填写不带 `#admin` 的地址: + +```text +http://192.168.10.6:18080 +``` + +公网部署时改为: + +```text +https://control.example.com +``` + +## 8. 启动参数与环境变量 + +| 参数 | 环境变量 | 默认值 | 说明 | +|---|---|---|---| +| `-addr` | `DOUYU_CONTROL_ADDR` | `:18080` | HTTP 监听地址 | +| `-data` | `DOUYU_CONTROL_DATA` | `remote-data` | 控制中心数据目录 | +| `-operator-token` | `DOUYU_CONTROL_OPERATOR_TOKEN` | 随机生成 | Web 管理令牌 | +| `-enroll-token` | `DOUYU_CONTROL_ENROLL_TOKEN` | 空 | 新实例注册口令 | +| `-enroll-window` | `DOUYU_CONTROL_ENROLL_WINDOW` | `10m` | 无注册口令时的自动注册窗口 | +| `-agent-token` | `DOUYU_CONTROL_AGENT_TOKEN` | 空 | 兼容旧版共享实例令牌 | + +公网使用时必须在前面配置 HTTPS 反向代理。 + +## 9. Web 控制台功能 + +### 机器与实例 + +- 按机器动态聚合并展示任意数量实例。 +- 显示在线状态、运行状态、账号数和当前结果数量。 +- 点击“结果”展开当前账号结果。 +- 点击“日志”只看该实例日志。 +- 点击“刷新”立即请求实例状态。 +- 点击“停止”请求本地实例停止抢购。 +- 点击“取消定时”请求本地实例取消尚未触发的定时任务。 + +### 最近运行 + +- 显示最近运行记录:开始时间、机器、实例、运行状态和结果数量。 +- 点击某条运行记录,只看该 `runId` 的日志。 + +### 实时日志 + +日志字段: + +```text +机器 ID +机器名称 +实例 ID +实例名称 +运行 ID +本地时间 +类别 +等级 +账号 +日志正文 +``` + +日志支持: + +- 按实例筛选。 +- 按运行筛选。 +- 按实例名、账号或正文过滤。 +- 恢复全部日志。 +- 清空当前浏览器显示,不删除服务端数据。 + +## 10. 导出 + +Web 控制台提供: + +- `导出 CSV` +- `导出 JSON` + +导出会应用当前选择条件: + +- 当前实例。 +- 当前运行。 +- 当前文本过滤条件。 +- 没有选择实例时导出全部机器日志。 + +CSV 使用 UTF-8 BOM,兼容 Excel 中文。 + +CSV 列: + +```text +seq +time +machine_id +machine_name +instance_id +instance_name +run_id +category +level +account +message +``` + +接口: + +```text +GET /api/export?format=csv +GET /api/export?format=json +``` + +可选参数: + +```text +machineId +instanceId +runId +q +from RFC3339 +to RFC3339 +``` + +## 11. 数据保存位置 + +### 控制中心 + +```text +<控制中心数据目录>/ + events.ndjson # 所有结构化日志 + runs.ndjson # 运行摘要历史 + agent_tokens.json # 实例独立令牌 +``` + +`events.ndjson` 是日志统计和导出的权威数据源。 + +### 抢购实例 + +```text +<实例数据目录>/remote/ + events.ndjson # 待上传事件 + events.offset # 已上传偏移 +``` + +本机机器和凭据: + +```text +<机器数据根目录>/remote/machine_id +<机器数据根目录>/remote/instances/<实例>.json +``` + +软件原本的人类可读日志仍保存在各实例的 `LogDir`,远端功能不会删除或替换本地日志。 + +## 12. 异步与离线行为 + +- 日志先进入内存队列,再由独立 goroutine 追加到本地远端事件文件。 +- 网络发送与抢购请求完全解耦。 +- 队列满时丢弃远端事件,并增加 `DroppedEvents` 计数。 +- Agent 断线后继续写本地事件文件。 +- 重连后从 `events.offset` 继续上传。 +- 心跳每 5 秒发送一次状态。 +- 连接失败使用指数退避,最长 30 秒。 +- 服务端重启不会清空已注册实例令牌。 + +## 13. 命令 + +当前支持: + +| 命令 | 作用 | +|---|---| +| `ping` | 连通性检查 | +| `status` | 立即刷新实例状态 | +| `stop` | 请求停止当前抢购 | +| `cancel_schedule` | 取消尚未触发的定时任务 | + +暂不支持: + +- 远端启动抢购。 +- 远端创建定时任务。 +- 远端修改账号或 Cookie。 +- 任意 Shell 命令。 + +这是刻意的安全边界。抢购启动和时序必须由本地实例负责。 + +## 14. 安全要求 + +- 远端日志不能包含 Cookie、CSRF、代理密码、白名单签名密钥或 Trace 原始请求正文。 +- Trace 文件不会自动上传。 +- 公网部署必须使用 HTTPS/WSS。 +- 公网部署必须设置注册令牌,不允许长期开放自动注册窗口。 +- 桌面端注册令牌只用于 `POST /api/enroll`,注册成功后连接使用服务端签发的独立实例令牌。 +- 管理令牌和实例令牌必须使用高强度随机值。 +- 管理操作应保留命令审计。 +- 日志中包含斗鱼账号名称,导出文件应按敏感数据处理。 +- 不应允许远端修改账号凭据或执行任意命令。 + +## 15. 当前限制 + +- `/Users/yml/日志/斗鱼/11.21` 这类历史文本日志不会自动导入。 +- 只有启用远端之后产生的结构化日志会自动收集。 +- 历史文本日志需要单独实现导入/回填工具。 +- 服务端当前使用 NDJSON 持久化,不是数据库。 +- 尚未实现日志按天自动清理、全文检索、用户权限分级和集群部署。 +- 远端控制台依赖一个常驻的 `douyu-control` 服务进程,但管理端不需要安装 Windows/macOS 客户端。 + +## 16. 验证 + +远端相关修改至少运行: + +```bash +go test ./... +go test -race ./internal/remote +cd frontend && npm run type-check +docker compose -f deploy/control-center/compose.yaml config +./build.sh control +./build.sh build +``` + +手工检查: + +```text +GET /api/health +GET /api/dashboard 无令牌返回 401 +POST /api/enroll 注册窗口内可签发令牌 +GET /api/export?format=csv 能下载带 BOM 的日志 +GET /api/export?format=json 能下载结构化日志 +``` + +## 17. 变更记录 + +| 日期 | 变更 | +|---|---| +| 2026-11-21 | 建立远端控制、自动注册、动态机器聚合、实时日志、运行记录、主界面状态入口、CSV/JSON 导出 | +| 2026-11-21 | 实例快照增加结构化代理状态,Web 控制台可查看代理组、出口和账号分组 | +| 2026-11-21 | 增加独立注册令牌配置和 `deploy/control-center` Docker/Caddy 部署目录 | + +## 18. 代理白名单协同规划 + +远端控制中心后续统一管理代理白名单,但不得成为本地抢购的单点依赖。 + +建议能力: + +- 按 `machineId` 收集每台电脑的公网 IP。 +- 为每台机器维护一个白名单状态,而不是每个实例一个。 +- 使用全局串行队列下发幂等的 `ensure_whitelist` 命令。 +- 命令由机器本地 Agent 使用本机凭据执行并回报结果。 +- 控制中心等待回执后再推进下一台机器。 +- 遵守平台频率限制,例如每秒最多一次。 +- 展示 `pending`、`ready`、`failed`、`expired` 和最近检查时间。 +- 在抢购前更早完成,例如 `T-10min` 或 `T-5min`。 +- 将白名单状态推送给该机器的所有实例。 + +边界要求: + +- 本地实例仍需缓存白名单状态。 +- 远端不可用时,本地必须能继续执行幂等兜底。 +- 白名单管理不能依赖 `T-0s` 的远端实时命令。 +- 品赞登录密码和签名密钥保存在抢购电脑本地,不集中上传控制中心,不得进入日志或远端事件。 +- 代理提取结果必须使用 JSON;TXT 会丢失用户名密码。 + +当前状态:方向已确认,尚未实现。 + +## 19. 实例代理状态展示 + +远端控制台中的每个实例必须直接显示代理状态和账号分组,而不是要求用户查看日志推导。 + +实例摘要建议显示: + +```text +活动代理 4 · 备用 1/1 · 直连回退 0 +``` + +实例展开后显示: + +- 代理组编号。 +- 每组账号数量。 +- 脱敏后的代理出口、地区和 RTT。 +- 当前状态:使用中、备用、失败、直连。 +- 最近切换次数和最后错误。 +- 每个账号属于哪个组。 +- 白名单状态。 + +Agent Snapshot 已增加结构化 `proxyStatus` 字段,日志只作为审计时间线,不能作为界面状态来源。 + +当前状态:已实现。 + +- 实例摘要显示活动代理、备用代理和直连数量。 +- “代理”按钮展开组号、账号数、状态、脱敏出口、地区、RTT、切换次数和最近错误。 +- 状态区分准备中、就绪、降级、失败和直连回退。 +- 代理快照不包含代理用户名、密码或白名单签名密钥。 +- 桌面端和远端使用同一份 `ProxyStatusView`,避免两边口径不一致。 diff --git a/frontend/src/components/account/AccountTable.vue b/frontend/src/components/account/AccountTable.vue index bcaeace..17dfab0 100644 --- a/frontend/src/components/account/AccountTable.vue +++ b/frontend/src/components/account/AccountTable.vue @@ -6,6 +6,7 @@ import { useProducts } from '@/composables/useProducts' import type { Product } from '@/composables/useProducts' import { useActivity } from '@/composables/useActivity' import { useToast } from '@/composables/useToast' +import { useProxyStatus } from '@/composables/useProxyStatus' import { formatExchangeTime, formatShortExchangeTime } from '@/utils/formatTime' import { ExportLatestXiaodianReport, @@ -35,6 +36,7 @@ const { const { products, selectedProductId, selectedProductName, selectProduct, clearSelection } = useProducts() const { currentActivity } = useActivity() const { showToast } = useToast() +const { getAccountProxy } = useProxyStatus() const isXiaodian = computed(() => currentActivity.value?.id === 'xiaodian') const productFilterMap = ref>({}) const openProductAccount = ref(null) @@ -411,6 +413,7 @@ const closeExchangeRecords = () => { 扭蛋碎片 角色信息 兑换记录 + 代理 状态 最后结果 操作 @@ -418,7 +421,7 @@ const closeExchangeRecords = () => { - 暂无账号,请加载账号 + 暂无账号,请加载账号