tunnel

Tunnel Gateway Example

这是一个独立运行的 Tunnel Gateway 服务示例。

架构说明

                     外部请求
                        │
                        ▼
┌───────────────────────────────────────────────────┐
│              Tunnel Gateway (本示例)               │
│                                                   │
│  ┌─────────────┐  ┌─────────────┐  ┌───────────┐ │
│  │ HTTP :8888  │  │ gRPC :9999  │  │Debug :6066│ │
│  └──────┬──────┘  └──────┬──────┘  └─────┬─────┘ │
│         └────────────────┼───────────────┘       │
│                          │                       │
│            Tunnel Listener :7007                 │
│            Admin UI :6067                        │
└──────────────────────────┬───────────────────────┘
                           │
            ┌──────────────┼──────────────┐
            │              │              │
     ┌──────┴──────┐ ┌─────┴─────┐ ┌──────┴──────┐
     │ Scheduler   │ │ Service B │ │ Service C   │
     │ (Agent)     │ │ (Agent)   │ │ (Agent)     │
     └─────────────┘ └───────────┘ └─────────────┘
            内网服务节点（主动连接 Gateway）

运行

1. 启动 Gateway

# 使用 task
task tunnel:run

# 或手动运行
go build -o ./bin/tunnel-gateway ./internal/examples/tunnel/main.go
./bin/tunnel-gateway tunnel -c ./internal/configs/tunnel.yaml

Gateway 将监听以下端口：

• :7007 - 接受 Agent 连接
• :8888 - HTTP 代理（对外暴露服务）
• :9999 - gRPC 代理
• :6066 - Debug 代理（代理到各服务的 debug 接口）
• :6067 - 管理界面（Gateway 自身的管理 UI）

2. 访问管理界面

打开浏览器访问 http://localhost:6067/debug/tunnel 查看：

• 已注册的服务列表
• 各服务的端点信息
• 服务状态和元数据

3. 启动带 Agent 的 Scheduler 服务

# 在另一个终端
TUNNEL_GATEWAY_ADDR=localhost:7007 ./bin/scheduler scheduler -c ./internal/configs/scheduler.yaml

Scheduler 服务会通过 Agent 连接到 Gateway，注册自己。

4. 通过 Gateway 访问服务

# 访问 scheduler 服务的接口
curl http://localhost:8888/scheduler/api/v1/jobs

# 访问 scheduler 服务的 debug 接口
curl http://localhost:6066/scheduler/debug/pprof/

# 获取服务列表 API
curl http://localhost:6067/debug/tunnel/api/services

配置

配置文件位于 internal/configs/ 目录下，复用项目统一的配置结构：

internal/configs/
├── tunnel.yaml              # Tunnel 主配置
├── scheduler.yaml           # Scheduler 主配置
├── components/
│   ├── tunnel.yaml          # Tunnel Gateway 组件配置
│   ├── http_server.yaml     # HTTP 服务配置
│   ├── logger.yaml          # 日志配置
│   └── metric.yaml          # 指标配置
└── envs/
    └── .env                 # 环境变量

Gateway 配置 (components/tunnel.yaml)

tunnel:
  listen_addr: ":7007"    # Agent 连接地址
  http_port: 8888         # HTTP 代理端口
  grpc_port: 9999         # gRPC 代理端口
  debug_port: 6066        # Debug 代理端口

Agent 配置（环境变量）

使用场景

1. 内网服务暴露：服务在内网/防火墙后，通过 Agent 主动连接 Gateway 暴露到公网
2. 服务聚合：多个微服务通过同一个 Gateway 统一入口
3. 远程调试：通过 Gateway 访问内网服务的 pprof/debug 接口
4. 零配置部署：服务只需知道 Gateway 地址，无需开放端口