mirror of
https://github.com/Sagit-chu/flvx.git
synced 2026-09-30 16:26:36 +08:00
sagitchu
42 lines
1.2 KiB
Markdown
42 lines
1.2 KiB
Markdown
# GOST SOCKET KNOWLEDGE BASE
|
|
|
|
**Generated:** Fri Mar 20 2026
|
|
**Commit:** f45f960
|
|
**Branch:** main
|
|
**Tag:** 2.1.9-beta6
|
|
|
|
## OVERVIEW
|
|
WebSocket reporter and socket utilities for panel integration.
|
|
**Stack:** Go, GOST core, gorilla/websocket.
|
|
|
|
## STRUCTURE
|
|
```
|
|
socket/
|
|
├── websocket_reporter.go # Agent-to-panel telemetry (1504 LOC)
|
|
├── service.go # Socket service orchestration (534 LOC)
|
|
├── socket.go # Core socket interface
|
|
├── udp.go # UDP socket handling
|
|
├── packet.go # Packet framing
|
|
└── packetconn.go # Packet connection wrapper
|
|
```
|
|
|
|
## WHERE TO LOOK
|
|
| Task | Location | Notes |
|
|
|------|----------|-------|
|
|
| **Panel Reporting** | `websocket_reporter.go` | Real-time system info (CPU, mem, uptime) every 2s |
|
|
| **Command Handling** | `websocket_reporter.go` | Processes `AddService`, `UpgradeAgent`, etc. |
|
|
|
|
## CONVENTIONS
|
|
- Inherits from parent `go-gost/x/` conventions.
|
|
- Low-level network primitives.
|
|
- All panel communication is AES-encrypted using node `secret`.
|
|
|
|
## ANTI-PATTERNS
|
|
- DO NOT EDIT generated protobuf.
|
|
|
|
## COMMANDS
|
|
```bash
|
|
cd go-gost
|
|
go test ./x/socket/...
|
|
```
|