xk-docs/docs/projects/xk-hy-forward-go/design.md

xk-hy-forward-go 设计思路

架构决策

内网转发

采用内网双通道转发架构：

• 外部网络 xk-hy-transit-go 只能访问本服务
• 本服务负责转发至浙江省政务云
• 内外网隔离，确保政务云安全

Go 实现

选择 Go 语言：

• 高性能、低资源消耗
• 原生支持并发
• 适合做透明代理
• 部署简单（单二进制文件）

透明转发

服务本身不做业务逻辑处理：

• 只做请求转发和响应返回
• 请求头白名单过滤
• IP 白名单控制
• 日志记录

Echo 模式

支持 Echo 模式用于调试：

• 不实际转发请求
• 返回请求详情
• 方便开发和测试

安全考虑

措施	说明
IP 白名单	ALLOW_IPS 配置允许访问的 IP
共享密钥	FORWARD_SHARED_SECRET 验证调用方
请求头过滤	只转发白名单中的请求头
内网部署	部署在内网服务器，外部无法直接访问