diff --git a/README.MD b/README.MD index 4d041ea..5f7835e 100644 --- a/README.MD +++ b/README.MD @@ -56,3 +56,29 @@ GOOS=linux GOARCH=amd64 wails build | `DOUYU_FONT` | 自定义字体路径 | 自动检测系统字体 | | `DOUYU_TRACE` | 启用 HTTP 追踪 | 关闭 | | `DOUYU_TRACE_MAX_BODY` | trace 正文最大字节数 | 无限制 | +| `DOUYU_CONTROL_ADDR` | 远端控制台监听地址 | `:18080` | +| `DOUYU_CONTROL_DATA` | 远端控制台数据目录 | `remote-data` | +| `DOUYU_CONTROL_OPERATOR_TOKEN` | 网页控制台令牌 | 启动时随机生成 | +| `DOUYU_CONTROL_ENROLL_TOKEN` | 可选的新实例注册口令 | 空 | +| `DOUYU_CONTROL_ENROLL_WINDOW` | 无注册口令时的自动注册窗口 | `10m` | + +## 远端控制(可选) + +远端控制不参与本地定时、代理准备、锁单和支付链路。网络中断时实例继续本地抢购,事件写入本地缓冲后可重连补传。 + +构建并启动控制中心: + +```bash +./build.sh control +./build/bin/douyu-control -addr :18080 -data ./remote-data +``` + +程序会打印一个带自动登录信息的管理链接。桌面端在“设置 -> 远端控制”中只需要填写控制中心地址,实例首次连接会自动注册并把独立令牌保存在本机。默认自动注册窗口为控制中心启动后的 10 分钟,窗口关闭后不再接受新实例。 + +说明: + +- 实例主动通过 WebSocket 外连并自动注册,不需要为每台抢购电脑开放入站端口,也不需要手工配置实例令牌。 +- 控制台按 `machineId` 动态聚合任意数量的实例,可查看机器、实例、运行结果和实时结构化日志;不假定固定实例数。 +- 当前支持远端刷新状态、停止抢购和取消定时;启动/定时任务仍以本地配置为准。 +- Cookie、CSRF、代理密码、白名单签名密钥和 Trace 正文不会上传。 +- 公网部署时请在控制中心前放置 HTTPS 反向代理,并使用强随机令牌。 diff --git a/build.sh b/build.sh index e5c1178..9bc36fd 100755 --- a/build.sh +++ b/build.sh @@ -8,6 +8,7 @@ # ./build.sh mac-arm # 构建 macOS ARM64 版本 # ./build.sh release # 构建 Windows amd64 和 macOS ARM64 # ./build.sh linux # 构建 Linux 版本 +# ./build.sh control # 构建远端控制台 # ./build.sh clean # 清理构建产物 # ./build.sh install # 安装前端依赖 @@ -173,6 +174,14 @@ build_linux() { ls -lh build/bin/ } +# 构建远端控制中心 +build_control() { + info "构建远端控制中心..." + mkdir -p build/bin + go build -o build/bin/douyu-control ./cmd/douyu-control + success "远端控制中心构建完成: build/bin/douyu-control" +} + # 清理构建产物 clean_build() { info "清理构建产物..." @@ -196,6 +205,7 @@ show_help() { echo " ./build.sh mac-arm # 构建 macOS ARM64 版本" echo " ./build.sh release # 构建 Windows amd64 和 macOS ARM64" echo " ./build.sh linux # 构建 Linux 版本" + echo " ./build.sh control # 构建远端控制台" echo " ./build.sh clean # 清理构建产物" echo " ./build.sh install # 安装前端依赖" echo " ./build.sh help # 显示此帮助" @@ -232,6 +242,9 @@ main() { linux) build_linux ;; + control) + build_control + ;; clean) clean_build ;; diff --git a/cmd/douyu-control/main.go b/cmd/douyu-control/main.go new file mode 100644 index 0000000..c649b28 --- /dev/null +++ b/cmd/douyu-control/main.go @@ -0,0 +1,90 @@ +package main + +import ( + "flag" + "fmt" + "log" + "os" + "os/signal" + "strings" + "syscall" + "time" + + "douyu_go/internal/remote" +) + +func main() { + addr := flag.String("addr", env("DOUYU_CONTROL_ADDR", ":18080"), "HTTP listen address") + dataDir := flag.String("data", env("DOUYU_CONTROL_DATA", "remote-data"), "remote data directory") + agentToken := flag.String("agent-token", os.Getenv("DOUYU_CONTROL_AGENT_TOKEN"), "token used by application instances") + operatorToken := flag.String("operator-token", os.Getenv("DOUYU_CONTROL_OPERATOR_TOKEN"), "token used by the web console") + enrollToken := flag.String("enroll-token", os.Getenv("DOUYU_CONTROL_ENROLL_TOKEN"), "optional token required for automatic instance enrollment") + enrollWindow := flag.Duration("enroll-window", durationEnv("DOUYU_CONTROL_ENROLL_WINDOW", 10*time.Minute), "automatic enrollment window when enroll-token is empty") + flag.Parse() + + var err error + if strings.TrimSpace(*operatorToken) == "" { + *operatorToken, err = remote.RandomToken() + if err != nil { + log.Fatal(err) + } + } + + server, err := remote.NewServer(remote.ServerOptions{ + Addr: *addr, + DataDir: *dataDir, + AgentToken: *agentToken, + OperatorToken: *operatorToken, + EnrollToken: *enrollToken, + EnrollWindow: *enrollWindow, + }) + if err != nil { + log.Fatal(err) + } + defer server.Close() + + fmt.Printf("远端控制台: http://%s/#admin=%s\n", displayAddr(*addr), *operatorToken) + if strings.TrimSpace(*enrollToken) != "" { + fmt.Printf("实例注册需要注册令牌: %s\n", *enrollToken) + } else { + fmt.Printf("实例自动注册窗口: %s(启动后开始计时)\n", enrollWindow.String()) + } + if strings.TrimSpace(*agentToken) != "" { + fmt.Printf("兼容实例共享令牌: %s\n", *agentToken) + } + fmt.Printf("数据目录: %s\n", *dataDir) + + signals := make(chan os.Signal, 1) + signal.Notify(signals, os.Interrupt, syscall.SIGTERM) + go func() { + <-signals + _ = server.Close() + os.Exit(0) + }() + if err := server.ListenAndServe(); err != nil { + log.Fatal(err) + } +} + +func env(key, fallback string) string { + if value := strings.TrimSpace(os.Getenv(key)); value != "" { + return value + } + return fallback +} + +func displayAddr(addr string) string { + if strings.HasPrefix(addr, ":") { + return "127.0.0.1" + addr + } + return addr +} + +func durationEnv(key string, fallback time.Duration) time.Duration { + raw := strings.TrimSpace(os.Getenv(key)) + value, err := time.ParseDuration(raw) + if err != nil || value <= 0 { + return fallback + } + return value +} diff --git a/frontend/src/components/layout/RightConsole.vue b/frontend/src/components/layout/RightConsole.vue index dd3d127..3e8fc71 100644 --- a/frontend/src/components/layout/RightConsole.vue +++ b/frontend/src/components/layout/RightConsole.vue @@ -1,5 +1,5 @@