85 lines
3.3 KiB
Markdown
85 lines
3.3 KiB
Markdown
# 斗鱼抢购系统
|
||
|
||
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` |
|
||
|
||
## 远端控制(可选)
|
||
|
||
远端控制不参与本地定时、代理准备、锁单和支付链路。网络中断时实例继续本地抢购,事件写入本地缓冲后可重连补传。
|
||
|
||
构建并启动控制中心:
|
||
|
||
```bash
|
||
./build.sh control
|
||
./build/bin/douyu-control -addr :18080 -data ./remote-data
|
||
```
|
||
|
||
程序会打印一个带自动登录信息的管理链接。桌面端在“设置 -> 远端控制”中只需要填写控制中心地址,实例首次连接会自动注册并把独立令牌保存在本机。默认自动注册窗口为控制中心启动后的 10 分钟,窗口关闭后不再接受新实例。
|
||
|
||
说明:
|
||
|
||
- 实例主动通过 WebSocket 外连并自动注册,不需要为每台抢购电脑开放入站端口,也不需要手工配置实例令牌。
|
||
- 控制台按 `machineId` 动态聚合任意数量的实例,可查看机器、实例、运行结果和实时结构化日志;不假定固定实例数。
|
||
- 当前支持远端刷新状态、停止抢购和取消定时;启动/定时任务仍以本地配置为准。
|
||
- Cookie、CSRF、代理密码、白名单签名密钥和 Trace 正文不会上传。
|
||
- 公网部署时请在控制中心前放置 HTTPS 反向代理,并使用强随机令牌。
|