feat: add control center, multiple relay nodes and P2P-first transport

This commit is contained in:
tongtong committed 2026-11-12 16:56:06 +08:00
1 parent 0988e9c363
commit 2abfb63da9
44 files changed
+3477 -67

No files matched your search

+10 -9
View File
@@ -1,12 +1,13 @@
# ads-server(Go 公网服务器)
# ADS 控制中心与中继(Go)
入口:`main.go`。独立构建:`go build -o ads-server .`。
`main.go` / `cluster.go` 是 ads-server 控制中心。`go build -o ads-server .`。
配置 ADS_AGENT_TOKEN、ADS_CLIENT_TOKEN(不同且至少 32 字符);默认回环监听,可用 --listen 修改。
- 配置:环境变量 `ADS_AGENT_TOKEN`、`ADS_CLIENT_TOKEN`,要求不同且各至少 32 字符。
- 默认监听:`127.0.0.1:8080`,用 `--listen` 修改。
- TLS:反向代理或 `--tls-cert` 与 `--tls-key`;公网必须使用有效证书。
- 路由:`/healthz`、`/v1/agent`、`/v1/devices`、`/v1/lease`、`/v1/connect`、`/v1/data`。
- 状态存内存;一个 ID 对应一个在线 agent,一个设备对应一个独占租约。
- Ctrl+C / SIGTERM 关闭控制与数据连接;两端支持重连。
加上 `--cluster-config /etc/ads/cluster.json` 和至少 32 字符的 ADS_RELAY_SECRET 启用 v2:控制中心负责注册、独占租约、SDP 信令与节点健康,不转发 v2 ADB 数据。未配置集群则保留 v1 数据转发。公网使用有效证书或 HTTPS 反向代理。
部署、令牌配置和三端完整命令见项目根目录 `README.md`。
| 内部目录 | 用途 | 语言 |
| --- | --- | --- |
| `cmd/ads-relay/` | 独立节点入口,`go build -o ads-relay ./cmd/ads-relay` | Go |
| `internal/relay/` | HMAC 票据、WSS 配对、撤销、可选 STUN 和测试 | Go |
集群配置、角色、协议及部署见 [集群说明](../docs/cluster.md)。执行 `go test -race ./...` 检查并发行为。