tiagoepr/mllp-https

MLLP/HTTP(S) 协议转换镜像

概述

该镜像实现MLLP（最小低层协议，HL7消息传统传输协议）与HTTP/HTTPS之间的双向转换，帮助传统MLLP系统与现代HTTP生态工具（如负载均衡器、API监控框架）集成，支持HL7 over HTTP规范。镜像包含四个核心服务：

• http2mllp: HTTP服务器，将请求转发至MLLP服务
• mllp2http: MLLP服务器，将请求转发至HTTP服务
• https2mllp: HTTPS服务器，将请求转发至MLLP服务
• mllp2https: MLLP服务器，将请求转发至HTTPS服务

核心功能

1. 支持MLLP Release 1、HTTP/1.1及SSL/TLS加密
2. 仅处理传输层，保留HL7消息完整性（不解析HL7内容）
3. 可配置超时、keep-alive等连接参数
4. 支持通过环境变量设置HTTP授权头

使用场景

• ***系统中HL7消息与现代HTTP工具的集成
• 传统MLLP服务与云原生HTTP服务的桥接
• 利用HTTP/HTTPS工具（如API网关、监控系统）管理MLLP流量

配置说明

Docker部署

拉取镜像

bash
docker pull docker.xuanyuan.run/tiagoepr/mllp-https

运行服务示例

1. HTTP转MLLP：

bash
docker run -it -p 2575:2575 --rm docker.xuanyuan.run/tiagoepr/mllp-https http2mllp localhost --mllp_port 2575

2. MLLP转HTTP：

bash
docker run -it -p 2575:2575 --rm docker.xuanyuan.run/tiagoepr/mllp-https mllp2http http://localhost:8000

3. HTTPS转MLLP（需挂载证书目录）：

bash
docker run -it -p 2575:2575 -v /本地证书路径:/ssl --rm docker.xuanyuan.run/tiagoepr/mllp-https https2mllp localhost --mllp_port 2575 --certfile /ssl/certfile.crt --keyfile /ssl/keyfile.key

4. MLLP转HTTPS：

bash
docker run -it -p 2575:2575 --rm docker.xuanyuan.run/tiagoepr/mllp-https mllp2https https://localhost:8000

环境变量

• HTTP_AUTHORIZATION: 设置HTTP请求的Authorization头
• X-API-KEY: 设置HTTP请求的X-API-KEY头

使用示例

以mllp2http集成httpbin调试工具为例：

1. 启动httpbin服务器：

bash
docker run -p 8000:80 --rm docker.xuanyuan.run/kennethreitz/httpbin

2. 启动MLLP转HTTP服务：

bash
docker run -it -p 2575:2575 --rm docker.xuanyuan.run/tiagoepr/mllp-https mllp2http http://localhost:8000

3. 发送MLLP消息：

bash
printf '\x0bMESSAGE\x1c\x0d' | socat - TCP:localhost:2575

4. 查看httpbin返回的响应（包含请求详情）。