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

xk-hy-forward-go 概览

xk-hy-forward-go 是 XK 系统的互联网医院监管数据转发服务，基于 Go 构建，负责将内部网络的监管数据透明转发至浙江省政务云。

基本信息

项	值
语言	Go 1.22
模块	xk-hy-forward-go
依赖	github.com/joho/godotenv (环境变量加载)
部署	内网服务器 Windows

架构角色

graph LR
    subgraph 外部网络
        TRANSIT[xk-hy-transit-go<br/>外部网络]
    end

    subgraph 内部网络
        API[xk-api<br/>监管数据打包]
        FORWARD[xk-hy-forward-go<br/>透明转发]
    end

    subgraph 政务云
        GOV[浙江省政务云<br/>59.202.52.129]
    end

    API -->|加密数据| TRANSIT
    TRANSIT -->|转发| FORWARD
    FORWARD -->|透传| GOV
    GOV -->|结果| FORWARD
    FORWARD -->|回调| API

::: warning 双通道设计

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

端点

监听路径	转发目标	说明
POST /province/supervise/data	SUPERVISE_TARGET_URL (端口 28212)	加密监管业务 JSON
POST /mng/file/auth/upload	FILE_TARGET_URL (端口 28211)	处方 PDF 多部分上传
GET /health	本地	健康检查
GET /t	本地	政务云测试页面

配置 (.env)

变量	默认值	说明
LISTEN_ADDR	:16001	监听地址
SUPERVISE_TARGET_URL	—	监管数据转发目标
FILE_TARGET_URL	—	文件上传转发目标
ALLOW_IPS	—	允许的 IP 白名单
FORWARD_SHARED_SECRET	—	转发共享密钥
ENABLE_FORWARD	true	启用转发（false 为 echo 模式）
LOG_DIR	—	日志目录

启动方式

# Windows
run.bat

# 或直接运行
go run main.go