2 changed files with 52 additions and 1 deletions
			
			
		@ -0,0 +1,51 @@ | 
				
			|||
# Memobus Relay Server | 
				
			|||
 | 
				
			|||
## 概述 | 
				
			|||
 | 
				
			|||
使用 Go 语言编写编写高性能的 TCP 隧道中转服务器。作为中转服务端方案,它负责在 P2P 或局域网直连失败时,安全、高效地代理 App 与设备之间的所有流量,包括 HTTP 请求、WebSocket 长连接和文件流。 | 
				
			|||
 | 
				
			|||
## 架构 | 
				
			|||
 | 
				
			|||
本服务采用**应用层连接调度**架构,作为可水平扩展的无状态节点运行。 | 
				
			|||
 | 
				
			|||
1.  **服务发现**: 启动时向 Redis 注册自身信息(公网地址、负载),并定时发送心跳。 | 
				
			|||
2.  **被动调度**: 等待后端**调度服务器**的指令。调度服务器负责选择最合适的 `relay-server` 节点,并通知设备前来连接。 | 
				
			|||
3.  **本地转发**: 一旦 App 和设备被调度到同一个节点,所有流量都在该节点内存中通过 `yamux` 多路复用隧道进行流量转发。 | 
				
			|||
 | 
				
			|||
## 特性 | 
				
			|||
 | 
				
			|||
*   **高性能 & 低开销**: 基于 Go 和 `yamux`,为高吞吐量设计。 | 
				
			|||
*   **水平扩展**: 无状态节点,可通过增加实例来扩展容量。 | 
				
			|||
*   **协议支持**: 完全支持 HTTP/1.1,并对大文件流和 WebSocket 提供了优化。 | 
				
			|||
*   **安全**: 连接通过 JWT 进行认证。 | 
				
			|||
*   **高可用**: 支持优雅停机,并与调度服务器的健康检查机制配合。 | 
				
			|||
 | 
				
			|||
## 部署与运行 | 
				
			|||
 | 
				
			|||
### 依赖 | 
				
			|||
 | 
				
			|||
*   Go 1.21+ | 
				
			|||
*   Redis | 
				
			|||
 | 
				
			|||
### 配置 (`config.yml`) | 
				
			|||
 | 
				
			|||
通过 `config.yml` 文件配置服务。关键配置项如下: | 
				
			|||
 | 
				
			|||
```yaml | 
				
			|||
server: | 
				
			|||
  app_listen_addr: ":8089" | 
				
			|||
  device_listen_addr: ":7002" | 
				
			|||
  public_app_addr: "YOUR_PUBLIC_IP:8089"    # App 访问的公网地址 | 
				
			|||
  public_device_addr: "YOUR_PUBLIC_IP:7002" # 设备访问的公网地址 | 
				
			|||
  instance_id: ""                           # 实例ID (留空自动生成) | 
				
			|||
 | 
				
			|||
auth: | 
				
			|||
  app_access_secret: "your-app-secret" | 
				
			|||
  device_relay_secret: "your-device-secret" | 
				
			|||
 | 
				
			|||
redis: | 
				
			|||
  enabled: true | 
				
			|||
  addr: "redis.internal:6379" | 
				
			|||
  instance_registry_key: "relay_instances"      # 服务注册用的 Redis Key | 
				
			|||
  device_relay_mapping_key: "device_relay_mapping" # 设备-实例映射用的 Redis Key | 
				
			|||
  heartbeat_interval_seconds: 15 | 
				
			|||
					Loading…
					
					
				
		Reference in new issue