VX-API-Gateway开源网关技术的使用记录

VX-API-Gateway开源网关技术的使用记录

官网地址 https://mirren.gitee.io/vx-api-gateway-doc/

复制代码
VX-API-Gateway(以下称为VX-API)是基于Vert.x (java)开发的
API网关,
是一个分布式、全异步、高性能、可扩展、轻量级的可视化配置的API网关服务

官网下载程序zip包

访问 https://gitee.com/mirren/VX-API-Gateway/releases

下载最新的程序zip包

安装和使用

找个目录解压程序包

启动程序bin目录里的start.bat或start.sh


浏览器访问5256端口

点击进入首页后,会进入

http://localhost:5256/static/Application.html

提示要登录,默认账号是VXAdmin,密码是hivx

登录密码在安装目录的conf下的user.json中配置

登录后可以新建应用

复制代码
新建应用是指 你的vx-api-gateway网关要对接的服务名或应用名以及相关信息配置

创建应用



vx网关代理的http参数设置,都可以不填,会自动使用默认参数设置,(如需修改可以按需填写)

应用创建好后,可以在应用列表中看到

创建应用下的API代理

点击API管理,可以在刚刚建的应用上创建API

创建一个get请求代理

复制代码
目标:访问/sgate/t1 后自动代理到真实后端的/demo/t1




代理API的的返回结果配置不用特别修改,默认会自动返回后端真实API的数据

创建完成后,可以在api列表里看到

最后,要启用刚刚建的应用和应用下的API代理

在应用详情页面点击启动应用

在API详情页面点击启动某个API代理

启动完成后,点击运行状态页面,可以观察到当前vx-api-gateway的运行状态

最后可以使用postman测试是否代理成功

访问

http://127.0.0.1:8330/sgate/t1

自动代理到真实后端的

http://127.0.0.1:8085/demo/t1

返回后端真实服务接口的数据

实测发现可以代理成功,请求耗时188ms

在API详情页也可以看到相关的网关日志如下

VX-API-Gateway技术架构

应用Application

复制代码
应用可以理解为分组,是VX-AP中的一个运行单元,一个应用相当于一个服务器(Server)不同的是他的端口号允许被重复使用,也就是说在VX-API中一个端口号可以给任意应用绑定(前提是这个端口号没有被别的程序绑定),应用用于管理API
访问http://localhost:端口号(默认5256)/static/Application.html或者通过http://localhost:端口号(默认5256)进入后便可以查看与管理应用

API接口

复制代码
API是VX-API的服务核心,创建应用后便可以在应用的API管理中创建API;
当前版本中API支持三种服务类型,
HTTP/HTTPS服务(既VX-API需要去请到后台服务器的类型):参数检查与透传,支持带权重的负载均衡访问策略,轮询与IP哈希化,自动断路与重试不可用的后台服务地址
页面跳转服务:当用户访问时redirect到指定页面
自定义服务:可以自定义任意服务,当前版本中实现了,基于session-token的认证授权,获取服务器时间戳,与获取常量
同时API支持全局黑名单,流量限制,权限认证,自定义前置/后置处理器等

API的执行流程

绿线代表一定会执行,黑线代表当存在时执行,当用户请求的时候,完整的流程按组件顺序由1开始执行到7,如果不满足任意一个组件时请求结束并响应(fail-end-response),当任意组件出现异常时统一进入异常组件(Exception Handler)请求结束并响应错误信息

更多API的执行流程介绍参考下方API组件介绍

总结

复制代码
VX-API-Gateway 是一个轻量的,支持可视化配置的网关代理服务。
可以代理多个后端应用,同时可以对每个后端应用的API做精细化的API代理配置。
由于VX-API-Gateway 底层使用的是vert.x技术,所以不必担心性能问题
相关推荐
HelloGitHub39 分钟前
开源新旗舰 GLM-4.5:不想刷榜,只想干活儿
人工智能·开源·github
陈敬雷-充电了么-CEO兼CTO44 分钟前
字节跳动开源Coze,开启AI Agent开发新时代?
人工智能·gpt·chatgpt·开源·大模型·agi·coze
说私域1 小时前
基于开源AI智能名片链动2+1模式与S2B2C商城小程序的微商品牌规范化运营研究
人工智能·小程序·开源
程思扬1 小时前
无界设计新生态:Penpot开源平台与cpolar的云端协同创新实践
大数据·linux·服务器·前端·经验分享·ubuntu·开源
强德亨上校1 小时前
2025年7月21–28日AI开发周报:新模型、新战略与开源亮点
人工智能·科技·gpt·chatgpt·开源·aigc
算家计算1 小时前
FLUX.1 Kontext LoRA专用炼丹炉使用教程:加快训练进程,减少实例费用消耗!
人工智能·开源·aigc
bin91531 小时前
「源力觉醒 创作者计划」_文心大模型4.5系列开源模型,意味着什么?对开发者、对行业生态有何影响?
开源·文心大模型·4.5系列开源模型
百度Geek说1 小时前
世界人工智能大会,我们带来两个好消息!
后端·开源
DogDaoDao2 小时前
GitHub开源项目Zerox:AI驱动的OCR革命
人工智能·深度学习·开源·github·ocr·图像识别·zerox
OpenTiny社区2 小时前
前端可智能识别的搜索组件 SearchBox 使用详解!
前端·vue.js·ui·开源·opentiny