# 斗鱼抢购系统 Wails v2 桌面应用。 ## 开发运行 ```bash wails dev ``` ## 构建 ```bash # 构建当前平台 wails build # 交叉编译 GOOS=windows GOARCH=amd64 wails build GOOS=darwin GOARCH=amd64 wails build GOOS=darwin GOARCH=arm64 wails build GOOS=linux GOARCH=amd64 wails build ``` 构建产物在 `build/bin/` 目录。 ## 项目结构 ``` ├── main.go # Wails 入口 ├── app.go # App 结构体 + 前端可调用方法 ├── frontend/ │ └── index.html # 前端页面 ├── internal/ │ ├── client/ # 斗鱼接口客户端 │ ├── seckill/ # 抢购调度器 │ ├── logger/ # 日志系统 │ ├── trace/ # HTTP 请求追踪 │ ├── image/ # 成功图片生成 │ ├── config/ # 配置管理 │ ├── types/ # 类型定义 │ ├── constants/ # 常量 │ └── utils/ # 工具函数 ├── data/ │ └── user.txt # 账号文件 └── build/ # 构建输出(gitignore) ``` ## 环境变量 | 变量 | 说明 | 默认值 | |------|------|--------| | `DOUYU_CONFIG` | 配置文件路径 | `config.json` | | `DOUYU_USERS` | 账号文件路径 | `data/user.txt` | | `DOUYU_LOG_DIR` | 日志目录 | `logs` | | `DOUYU_SUCCESS_DIR` | 成功图片目录 | `success_images` | | `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` | ## 远端控制(可选) 远端控制不参与本地定时、代理准备、锁单和支付链路。网络中断时实例继续本地抢购,事件写入本地缓冲后可重连补传。 完整设计与维护说明见 [docs/远程控制.md](docs/远程控制.md)。 代理池、白名单、备用代理和故障回退的当前实现与待讨论方案见 [docs/代理池与白名单.md](docs/代理池与白名单.md)。 代理默认启用严格模式:定时任务提前 2 分钟准备,代理未就绪时不启动且不回退直连;品赞提取强制 JSON,同机多实例共享白名单协调锁,主界面直接显示 `G1`、`G2` 或“直连”。 构建并启动控制中心: ```bash ./build.sh control ./build/bin/douyu-control -addr :18080 -data ./remote-data ``` 程序会打印一个带自动登录信息的管理链接。桌面端在“设置 -> 远端控制”中用一行填写控制中心地址和注册令牌,实例首次连接会换取独立令牌;同机其他实例会自动继承远程地址和注册令牌。 连接示例:`https://control.example.com enroll-token`。不要带 `/#admin=...` 或子路径。 公网部署使用 [deploy/control-center](deploy/control-center/README.md) 中的 Docker Compose 和 Caddy 示例。容器只监听回环地址,HTTPS 由宿主机现有 Caddy 终止。 说明: - 实例主动通过 WebSocket 外连并自动注册,不需要为每台抢购电脑开放入站端口,也不需要手工配置实例令牌;只需填写控制中心地址和统一注册令牌。 - 控制台按 `machineId` 动态聚合任意数量的实例,可查看机器、实例、运行结果和实时结构化日志;不假定固定实例数。 - 当前支持远端刷新状态、停止抢购和取消定时;启动/定时任务仍以本地配置为准。 - Cookie、CSRF、代理密码、白名单签名密钥和 Trace 正文不会上传。 - 公网部署时请在控制中心前放置 HTTPS 反向代理,并使用强随机令牌。