Files
dygou_go/README.MD
T

85 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 斗鱼抢购系统
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 反向代理,并使用强随机令牌。