把数据库和第三方接口一键包成带鉴权的 API图形话操作数据同步异常检测通知一个 Windows 客户端的实现与踩坑目标读者需要把内部数据库 / 第三方接口开放给其他系统调用的后端、集成、实施同学。读完你能判断这套东西是否适合你的场景也能照着把第一个接口跑通。一、先说场景我们被什么卡住了这两年做集成项目反复遇到同一类需求学校/单位的业务库MySQL、SQL Server、国产信创库…要开放数据给第三方系统但不允许外部直连数据库上游第三方接口要先登录取 Token再拿 Token 去取数中间还要翻页抓全有些接口只差一个 IP要在 5 个上游之间轮询或故障转移数据还要定时同步进另一个库供报表系统用。标准做法是写后端接口 → 配鉴权 → 加监控每个项目重来一遍。工期紧的时候一个人一周只能交付很少的接口。所以我做了一个Windows 桌面客户端连上数据库 / 配好上游接口在界面上点几下就把它们包装成带 AppID Token 鉴权的下游 API而且网关就跑在本机数据不出内网。二、方案选型为什么不用现成的方案不选的原因Kong / APISIX 等网关面向的是已有微服务不是从数据库表直接生成接口部署运维成本高实施同学在客户现场装不动n8n / Node-RED 之类的编排编排能力不错但没有统一鉴权 凭证发放 调用统计这条产品线也不适合交付给非技术用户自己写 Spring Boot 接口最灵活但每个项目都要重写一遍鉴权、分页、字段映射、日志重复劳动低代码平台数据要上云客户尤其学校、政务不接受于是走了本地客户端 本机网关这条路客户端负责配置网关负责对外提供 API。三、整体架构┌──────────────────────── 本机Windows ────────────────────────┐ 浏览器 / 第三方 ──▶ │ Fastify 网关 (127.0.0.1:8787) │ Postman / 业务系统 │ ├─ POST /auth/token 用 AppID/AppSecret 换 JWT │ │ ├─ GET /gw/:id 按接口 ID 调用 │ │ ├─ GET /你配的下游路径 例如 /api/undergraduate │ │ └─ 统一响应 {code,message,data} 调用日志 │ │ │ │ Electron 客户端界面层 │ │ ├─ 数据源 / 接口调试 / 接口包装 / 接口编排 / 数据同步 │ │ ├─ 终端控制SSH/SCP/RDP/VNC/ 图情业务MARC/SIP2 │ │ └─ 数据看盘 / 应用凭证 │ │ │ │ 本地 SQLite接口定义、凭证、日志、连接敏感字段用系统密钥加密 │ └────────────────────────────────────────────────────────────────┘ │ ┌───────────────┴────────────────┐ ▼ ▼ 数据库MySQL/PG/SQL Server/国产库 第三方 HTTP 接口技术栈Electron 35 Vue 3 Element Plus ECharts网关是主进程内嵌的 Fastify本地库是 SQLitenode:sqlite。四、功能详解每个模块都配了操作录屏4.1 数据库操作像 Navicat 一样看数据、改数据图 1连上数据源 → 选表 → 分页浏览 → 进入编辑模式改数据。左侧还能切换数据库账号有权限看到的其它库。测试连接、连接信息主机/用户/库一目了然左侧选表、右侧分页看数据默认 100 条/页可选 50/100/200/500/1000表头排序、多条件筛选双击单元格就能改支持加行、删行改完点保存保存前能看实际执行的 SQL没有主键的表也能改界面让你选一个能唯一标识每行的字段如读者账号当定位字段系统用它做WHERE一个都不选时按整行字段匹配并在影响多行时明确提示数据库账号能看到哪些库就能切换着看权限完全由数据库账号决定。支持的数据库类别数据库默认端口接入方式常用MySQL / PostgreSQL / SQLite / SQL Server3306 / 5432 / 文件 / 1433原生驱动国产信创达梦 DM8、DM95236达梦官方 Node 驱动 dmdb国产信创人大金仓 KingbaseES54321PostgreSQL 协议国产信创瀚高 HighGo5866PostgreSQL 协议国产信创OceanBase2881MySQL 协议国产信创南大通用 GBase 8a5258MySQL 协议商业Oracle1521官方纯 JS 驱动不需要装 Oracle 客户端说明国产库多数兼容 PostgreSQL / MySQL 协议所以查询、分页、建表这些逻辑完全复用现有驱动Oracle 和达梦用各自官方驱动。这几家我还在收集真机环境实测反馈有环境的同学欢迎留言。4.2 接口调试类 Postman调通了才好包装图 2保存的接口按目录树管理填地址点「发送」右侧直接看格式化后的响应体和实际请求头。支持 OpenAPI 3.x 文档导入自动生成接口目录认证方式覆盖API Keyheader/query、Basic、Bearer、OAuth2 客户端凭证、自定义签名id secret timestamp nonce → HMAC-SHA256上游要先登录取 Token 的场景配好取 Token 接口之后 401 自动重取有效期内容复用分页抓全填好页码/每页条数参数名一键把 10 万条数据翻完并导出Excel / JSON调通的接口可保存成目录树两级目录、可拖拽归类后面直接用于接口包装、编排、同步。4.3 接口包装二次包装从数据表一键生成下游接口图 3选数据源 → 选表 → 勾要生成的操作分页查询 / 按主键查询 / 新增 / 更新 / 删除 / 按条件查询→ 生成。生成出来的接口自带统一响应体{ code, message, data }字段映射重命名、隐藏、类型转换都在界面上配分页Token 鉴权见下一节。4.4 鉴权AppID / AppSecret → Token在「应用凭证」里给每个调用方生成一套AppIDAppSecret密钥只明文展示一次库里只存哈希调用方两步拿到数据# 第 1 步换 token有效期 2 小时过期重新换curl-XPOST http://127.0.0.1:8787/auth/token\-HContent-Type: application/json\-d{appId:你的AppID,appSecret:你的AppSecret}# → {code:0,data:{accessToken:eyJhbGci...,expiresIn:7200,tokenType:Bearer}}# 第 2 步带上 token 调业务接口curlhttp://127.0.0.1:8787/gw/接口ID\-HAuthorization: Bearer eyJhbGci...Node.js 版// 1) 换 tokenconstresawaitfetch(http://127.0.0.1:8787/auth/token,{method:POST,headers:{Content-Type:application/json},body:JSON.stringify({appId:你的AppID,appSecret:你的AppSecret})})const{data}awaitres.json()// data.accessToken / data.expiresIn 7200 秒// 2) 带 token 调业务接口constrawaitfetch(http://127.0.0.1:8787/gw/接口ID,{headers:{Authorization:Bearer data.accessToken}})console.log(awaitr.json())// { code: 0, message: ok, data: ... }免 token 公开访问有些场景比如自己写个页面看看数据不想走 token可以把某个只读接口的「公开访问」开关打开之后浏览器直接打开地址就能拿到数据http://127.0.0.1:8787/api/undergraduate写操作POST/PUT/DELETE/PATCH不允许开公开访问——避免地址泄露后被人随意改数据打开时还会弹一次风险确认。4.5 接口编排图形化连线解决先取 Token 再取数图 4画布上拖节点、连线表示执行顺序上游节点可以「提取变量」如把data.accessToken提取成token下游节点用{{token}}引用。从「接口调试」调通的接口里添加节点节点之间连线表示先后组合策略支持轮询、故障转移、合并、依赖链保存前可以「测试整条编排」逐节点看耗时、变量和预览数据。4.6 数据同步库到库、接口到库定时自动搬图 5每个任务能看到来源→目标、定时周期、最近一次执行结果点「立即同步」可以手动跑一次。来源可以是数据库表也可以是接口含编排好的组合接口目标库支持 MySQL / SQL Server / PostgreSQL 等目标表不存在会自动建表可选按主键增量更新、自动加数据更新时间列定时执行按分钟 / 小时 / 天程序重启后调度自动恢复接口来源支持翻页抓全一直翻到某页返回条数小于每页条数为止10 万条不用人工翻页每次同步都留日志成功、失败、耗时、写入行数失败也能排查。4.7 终端控制一个客户端连服务器图 6SSH 交互终端切到别的页面再回来会话还在、历史输出自动回放右侧可切 SCP 图形化文件管理 / RDP / VNC。SSH / Telnet交互终端xterm断线可续、切页不丢会话SCP 图形化文件管理进目录、上传支持拖拽、下载、改名、删除、在线查看/编辑文本RDP调系统自带 mstscVNC内嵌在自己的窗口里noVNC 本地 WebSocket 桥不用另装 VNC 软件连接可建目录分类两级、目录可折叠密码/私钥用系统密钥加密保存在本机。4.8 图情业务图书馆编目那点事图 7选中 Excel 后确认工作表与表头再逐字段映射到 MARC020/200/210/905/906…生成前可预览。这块是图书馆项目里踩出来的通用低代码平台基本不碰Excel 单册数据 → CNMARCISO2709字段映射自定义同一种书的多复本自动合并成一条书目 多个 906 馆藏字段编码支持 UTF-8 / GBKMARC 批量批处理把某个字段的子字段复制/移动到另一个字段例如给所有 906 补索书号单次可处理 10 万条ISO 文件按体积切分第三方系统有导入大小限制时按 50MB 等阈值切分SIP2 自助借还调试连 SIP2 服务逐条测试登录、借书、还书、改密码、查读者、查图书并保留原始报文日志每次导出都本地留档Excel 被删了也能重新导出。4.9 数据看盘 其他仪表盘总调用量、成功率、平均/P95 耗时、近 7 天趋势、接口调用排行、错误分布、最近调用明细多主题浅色/深色共 8 套、侧边栏可折叠配置迁移整客户端配置加密导出换机器导入导入导出要邮箱验证码开机自启、自动更新、升级后自动自检并发邮件、内置反馈可截图/录屏/留言直达作者。五、几个实现上的坑这部分可能对你最有用内嵌 VNCElectron 里没有现成 VNC 客户端。做法是主进程连目标 5900在本机127.0.0.1起一个只服务单连接的 WebSocket 服务相当于内置 websockify渲染层用 noVNC 连本地 ws。踩坑点noVNC 用了顶层 await打包和开发环境的构建目标都要设成esnext否则 esbuild 直接报Top-level await is not available。Fastify 的重复路由fastify/cors自己注册了OPTIONS /*这时候再写app.all(/*)会抛FST_ERR_DUPLICATED_ROUTE整个网关起不来。改成按方法逐个注册另外 GET 会自动附带 HEAD别重复注册 HEAD。新字段没存库SQLite 表是按固定字段列表写的加了新功能字段必须同时改「建表 ALTER 升级 写入 读取」四处否则界面开关点了不生效我就在这栽过一次。敏感信息数据库密码、AppSecret、上游 token 全部用 Electron 的safeStorage加密落库AppSecret 只存哈希只在创建/重置那一次明文展示。MySQL 空闲断连客户现场常遇到wait_timeout断开做法是每次操作独立连接 命中可重试错误时自动重连一次用户侧无感。六、适用与不适用适合内网数据对外提供只读/小批量写入接口把上游接口取数再加工图书馆编目与自助借还调试实施人员在没有运维支持的环境里快速交付接口。不适合需要横向扩展的高并发网关它是单机网关多租户 SaaS 化对外服务K8s 环境下的服务治理。七、下载与试用官网含六大功能的动图演示https://www.yuner.fun直接下载 Windows 客户端https://www.yuner.fun/download.html系统要求Windows 10 / 11 64 位安装包约 90 MB。可以先用试用版跑通整个流程正式版按台授权、终身有效。八、写在最后这个工具的出发点很朴素把集成项目里重复了无数遍的那几件事做成点几下就能交付的东西。如果你也在做类似的事欢迎在评论区说说你的场景——尤其是国产数据库达梦、金仓、OceanBase、GBase的环境我这边还在收集实测反馈。有具体问题我会尽量回复。标签建议API网关数据库低代码ElectronFastify数据集成图书馆MARC国产数据库
把数据库和第三方接口一键包成带鉴权的 API图形话操作数据同步异常检测通知一个 Windows 客户端的实现与踩坑目标读者需要把内部数据库 / 第三方接口开放给其他系统调用的后端、集成、实施同学。读完你能判断这套东西是否适合你的场景也能照着把第一个接口跑通。一、先说场景我们被什么卡住了这两年做集成项目反复遇到同一类需求学校/单位的业务库MySQL、SQL Server、国产信创库…要开放数据给第三方系统但不允许外部直连数据库上游第三方接口要先登录取 Token再拿 Token 去取数中间还要翻页抓全有些接口只差一个 IP要在 5 个上游之间轮询或故障转移数据还要定时同步进另一个库供报表系统用。标准做法是写后端接口 → 配鉴权 → 加监控每个项目重来一遍。工期紧的时候一个人一周只能交付很少的接口。所以我做了一个Windows 桌面客户端连上数据库 / 配好上游接口在界面上点几下就把它们包装成带 AppID Token 鉴权的下游 API而且网关就跑在本机数据不出内网。二、方案选型为什么不用现成的方案不选的原因Kong / APISIX 等网关面向的是已有微服务不是从数据库表直接生成接口部署运维成本高实施同学在客户现场装不动n8n / Node-RED 之类的编排编排能力不错但没有统一鉴权 凭证发放 调用统计这条产品线也不适合交付给非技术用户自己写 Spring Boot 接口最灵活但每个项目都要重写一遍鉴权、分页、字段映射、日志重复劳动低代码平台数据要上云客户尤其学校、政务不接受于是走了本地客户端 本机网关这条路客户端负责配置网关负责对外提供 API。三、整体架构┌──────────────────────── 本机Windows ────────────────────────┐ 浏览器 / 第三方 ──▶ │ Fastify 网关 (127.0.0.1:8787) │ Postman / 业务系统 │ ├─ POST /auth/token 用 AppID/AppSecret 换 JWT │ │ ├─ GET /gw/:id 按接口 ID 调用 │ │ ├─ GET /你配的下游路径 例如 /api/undergraduate │ │ └─ 统一响应 {code,message,data} 调用日志 │ │ │ │ Electron 客户端界面层 │ │ ├─ 数据源 / 接口调试 / 接口包装 / 接口编排 / 数据同步 │ │ ├─ 终端控制SSH/SCP/RDP/VNC/ 图情业务MARC/SIP2 │ │ └─ 数据看盘 / 应用凭证 │ │ │ │ 本地 SQLite接口定义、凭证、日志、连接敏感字段用系统密钥加密 │ └────────────────────────────────────────────────────────────────┘ │ ┌───────────────┴────────────────┐ ▼ ▼ 数据库MySQL/PG/SQL Server/国产库 第三方 HTTP 接口技术栈Electron 35 Vue 3 Element Plus ECharts网关是主进程内嵌的 Fastify本地库是 SQLitenode:sqlite。四、功能详解每个模块都配了操作录屏4.1 数据库操作像 Navicat 一样看数据、改数据图 1连上数据源 → 选表 → 分页浏览 → 进入编辑模式改数据。左侧还能切换数据库账号有权限看到的其它库。测试连接、连接信息主机/用户/库一目了然左侧选表、右侧分页看数据默认 100 条/页可选 50/100/200/500/1000表头排序、多条件筛选双击单元格就能改支持加行、删行改完点保存保存前能看实际执行的 SQL没有主键的表也能改界面让你选一个能唯一标识每行的字段如读者账号当定位字段系统用它做WHERE一个都不选时按整行字段匹配并在影响多行时明确提示数据库账号能看到哪些库就能切换着看权限完全由数据库账号决定。支持的数据库类别数据库默认端口接入方式常用MySQL / PostgreSQL / SQLite / SQL Server3306 / 5432 / 文件 / 1433原生驱动国产信创达梦 DM8、DM95236达梦官方 Node 驱动 dmdb国产信创人大金仓 KingbaseES54321PostgreSQL 协议国产信创瀚高 HighGo5866PostgreSQL 协议国产信创OceanBase2881MySQL 协议国产信创南大通用 GBase 8a5258MySQL 协议商业Oracle1521官方纯 JS 驱动不需要装 Oracle 客户端说明国产库多数兼容 PostgreSQL / MySQL 协议所以查询、分页、建表这些逻辑完全复用现有驱动Oracle 和达梦用各自官方驱动。这几家我还在收集真机环境实测反馈有环境的同学欢迎留言。4.2 接口调试类 Postman调通了才好包装图 2保存的接口按目录树管理填地址点「发送」右侧直接看格式化后的响应体和实际请求头。支持 OpenAPI 3.x 文档导入自动生成接口目录认证方式覆盖API Keyheader/query、Basic、Bearer、OAuth2 客户端凭证、自定义签名id secret timestamp nonce → HMAC-SHA256上游要先登录取 Token 的场景配好取 Token 接口之后 401 自动重取有效期内容复用分页抓全填好页码/每页条数参数名一键把 10 万条数据翻完并导出Excel / JSON调通的接口可保存成目录树两级目录、可拖拽归类后面直接用于接口包装、编排、同步。4.3 接口包装二次包装从数据表一键生成下游接口图 3选数据源 → 选表 → 勾要生成的操作分页查询 / 按主键查询 / 新增 / 更新 / 删除 / 按条件查询→ 生成。生成出来的接口自带统一响应体{ code, message, data }字段映射重命名、隐藏、类型转换都在界面上配分页Token 鉴权见下一节。4.4 鉴权AppID / AppSecret → Token在「应用凭证」里给每个调用方生成一套AppIDAppSecret密钥只明文展示一次库里只存哈希调用方两步拿到数据# 第 1 步换 token有效期 2 小时过期重新换curl-XPOST http://127.0.0.1:8787/auth/token\-HContent-Type: application/json\-d{appId:你的AppID,appSecret:你的AppSecret}# → {code:0,data:{accessToken:eyJhbGci...,expiresIn:7200,tokenType:Bearer}}# 第 2 步带上 token 调业务接口curlhttp://127.0.0.1:8787/gw/接口ID\-HAuthorization: Bearer eyJhbGci...Node.js 版// 1) 换 tokenconstresawaitfetch(http://127.0.0.1:8787/auth/token,{method:POST,headers:{Content-Type:application/json},body:JSON.stringify({appId:你的AppID,appSecret:你的AppSecret})})const{data}awaitres.json()// data.accessToken / data.expiresIn 7200 秒// 2) 带 token 调业务接口constrawaitfetch(http://127.0.0.1:8787/gw/接口ID,{headers:{Authorization:Bearer data.accessToken}})console.log(awaitr.json())// { code: 0, message: ok, data: ... }免 token 公开访问有些场景比如自己写个页面看看数据不想走 token可以把某个只读接口的「公开访问」开关打开之后浏览器直接打开地址就能拿到数据http://127.0.0.1:8787/api/undergraduate写操作POST/PUT/DELETE/PATCH不允许开公开访问——避免地址泄露后被人随意改数据打开时还会弹一次风险确认。4.5 接口编排图形化连线解决先取 Token 再取数图 4画布上拖节点、连线表示执行顺序上游节点可以「提取变量」如把data.accessToken提取成token下游节点用{{token}}引用。从「接口调试」调通的接口里添加节点节点之间连线表示先后组合策略支持轮询、故障转移、合并、依赖链保存前可以「测试整条编排」逐节点看耗时、变量和预览数据。4.6 数据同步库到库、接口到库定时自动搬图 5每个任务能看到来源→目标、定时周期、最近一次执行结果点「立即同步」可以手动跑一次。来源可以是数据库表也可以是接口含编排好的组合接口目标库支持 MySQL / SQL Server / PostgreSQL 等目标表不存在会自动建表可选按主键增量更新、自动加数据更新时间列定时执行按分钟 / 小时 / 天程序重启后调度自动恢复接口来源支持翻页抓全一直翻到某页返回条数小于每页条数为止10 万条不用人工翻页每次同步都留日志成功、失败、耗时、写入行数失败也能排查。4.7 终端控制一个客户端连服务器图 6SSH 交互终端切到别的页面再回来会话还在、历史输出自动回放右侧可切 SCP 图形化文件管理 / RDP / VNC。SSH / Telnet交互终端xterm断线可续、切页不丢会话SCP 图形化文件管理进目录、上传支持拖拽、下载、改名、删除、在线查看/编辑文本RDP调系统自带 mstscVNC内嵌在自己的窗口里noVNC 本地 WebSocket 桥不用另装 VNC 软件连接可建目录分类两级、目录可折叠密码/私钥用系统密钥加密保存在本机。4.8 图情业务图书馆编目那点事图 7选中 Excel 后确认工作表与表头再逐字段映射到 MARC020/200/210/905/906…生成前可预览。这块是图书馆项目里踩出来的通用低代码平台基本不碰Excel 单册数据 → CNMARCISO2709字段映射自定义同一种书的多复本自动合并成一条书目 多个 906 馆藏字段编码支持 UTF-8 / GBKMARC 批量批处理把某个字段的子字段复制/移动到另一个字段例如给所有 906 补索书号单次可处理 10 万条ISO 文件按体积切分第三方系统有导入大小限制时按 50MB 等阈值切分SIP2 自助借还调试连 SIP2 服务逐条测试登录、借书、还书、改密码、查读者、查图书并保留原始报文日志每次导出都本地留档Excel 被删了也能重新导出。4.9 数据看盘 其他仪表盘总调用量、成功率、平均/P95 耗时、近 7 天趋势、接口调用排行、错误分布、最近调用明细多主题浅色/深色共 8 套、侧边栏可折叠配置迁移整客户端配置加密导出换机器导入导入导出要邮箱验证码开机自启、自动更新、升级后自动自检并发邮件、内置反馈可截图/录屏/留言直达作者。五、几个实现上的坑这部分可能对你最有用内嵌 VNCElectron 里没有现成 VNC 客户端。做法是主进程连目标 5900在本机127.0.0.1起一个只服务单连接的 WebSocket 服务相当于内置 websockify渲染层用 noVNC 连本地 ws。踩坑点noVNC 用了顶层 await打包和开发环境的构建目标都要设成esnext否则 esbuild 直接报Top-level await is not available。Fastify 的重复路由fastify/cors自己注册了OPTIONS /*这时候再写app.all(/*)会抛FST_ERR_DUPLICATED_ROUTE整个网关起不来。改成按方法逐个注册另外 GET 会自动附带 HEAD别重复注册 HEAD。新字段没存库SQLite 表是按固定字段列表写的加了新功能字段必须同时改「建表 ALTER 升级 写入 读取」四处否则界面开关点了不生效我就在这栽过一次。敏感信息数据库密码、AppSecret、上游 token 全部用 Electron 的safeStorage加密落库AppSecret 只存哈希只在创建/重置那一次明文展示。MySQL 空闲断连客户现场常遇到wait_timeout断开做法是每次操作独立连接 命中可重试错误时自动重连一次用户侧无感。六、适用与不适用适合内网数据对外提供只读/小批量写入接口把上游接口取数再加工图书馆编目与自助借还调试实施人员在没有运维支持的环境里快速交付接口。不适合需要横向扩展的高并发网关它是单机网关多租户 SaaS 化对外服务K8s 环境下的服务治理。七、下载与试用官网含六大功能的动图演示https://www.yuner.fun直接下载 Windows 客户端https://www.yuner.fun/download.html系统要求Windows 10 / 11 64 位安装包约 90 MB。可以先用试用版跑通整个流程正式版按台授权、终身有效。八、写在最后这个工具的出发点很朴素把集成项目里重复了无数遍的那几件事做成点几下就能交付的东西。如果你也在做类似的事欢迎在评论区说说你的场景——尤其是国产数据库达梦、金仓、OceanBase、GBase的环境我这边还在收集实测反馈。有具体问题我会尽量回复。标签建议API网关数据库低代码ElectronFastify数据集成图书馆MARC国产数据库
