Files
dygou_go/README.MD
T
yml d37fd50233 feat(remote): 支持单行连接与同机实例继承
- 远端地址和注册令牌合并为单行填写\n- 同机实例通过机器级配置继承远端连接\n- 实例令牌仍按实例独立保存
2026-11-21 22:01:33 +08:00

95 lines
4.0 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` |
## 远端控制(可选)
远端控制不参与本地定时、代理准备、锁单和支付链路。网络中断时实例继续本地抢购,事件写入本地缓冲后可重连补传。
完整设计与维护说明见 [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 反向代理,并使用强随机令牌。