一、系统概述

小氢云聚合API系统是一个统一的 API 调用入口平台，支持请求路由、鉴权、限流、缓存、数据清洗、外部 API 聚合。平台引入用户积分系统：每个接口可单独设置调用所需积分，用户调用时扣除相应积分；管理员可设置积分充值价格。支持多套前台模板、会员等级、多支付渠道、License 授权等。

二、技术栈

层次技术选型说明后端go 1.20 Fiber v2、GORM、Viper、Zap高性能 HTTP、ORM、配置、日志前端Vue 3 Vite、Ant Design Vue、Pinia、ECharts管理后台 + 用户中心 SPA存储MySQL 5.7+ Redis 6+持久化、缓存、限流认证JWT、bcrypt用户鉴权、密码加密其他WebSocket、gomail、base64Captcha、gopsutil实时推送、邮件、验证码、系统监控

三、后端模块

3.1 核心数据模型

模型表名说明Userusers用户（积分、会员等级）APIapis聚合接口配置Orderorders订单（充值/会员）APICallapi_calls调用记录UniversalAPIuniversal_apis万能接口MembershipLevelmembership_levels会员等级PaymentInterfacepayment_interfaces支付接口Configconfigs系统配置

3.2 API 类型（api_type）

• 0 — 普通转发（target_url）
• 1 — 万能接口（universal_api_id）
• 2 — 随机文本（lines_content）

3.3 API 分组

分组路径说明公开/api登录、注册、验证码、统计、API 列表用户/api/user需登录：个人信息、积分、会员、API Key调用/api/calls调用记录订单/api/order充值、会员订单、支付管理/api/admin需授权+管理员：用户、接口、订单、配置等动态/api/*聚合 API 动态路由（按数据库配置）

四、前端模块

4.1 管理端（/admin）

Dashboard、ApiList、ApiEdit、ApiCallList、ApiCallbackList、UserList、OrderList、PaymentList、MembershipLevelList、Settings、TemplateManagement、NodeManagement、OnlineUpdate、UpdateLog、FeedbackList、EmailList、UniversalApiList、UniversalApiEdit、UserActionLogList

4.2 用户端（/user）

Profile、Recharge、Membership、ApiTest、CallList、ActionLogList

4.3 前台模板

• default — PC 端首页模板
• jijian — 极简风格前台模板
• 按 UA 选择 pc/pe，再根据配置选择 default/jijian

五、核心业务

• API 聚合 — 动态路由、积分扣减、普通转发 / 万能接口 / 随机文本
• 积分系统 — 充值、会员等级、等级价格、限流
• 支付 — 多支付渠道、异步/同步回调、模拟支付
• 授权 — License 验证、公钥配置、节点切换
• 模板 — 多套前台模板、元数据配置、按 UA 切换
• 敏感词 — 云端拉取、响应过滤

六、配置与部署

6.1 配置文件

路径：config/config.yaml 或 build/linux/config/config.yaml

内容：app（name、version、port、base_url）、database、redis、log、security、middleware

6.2 构建与部署

• 后端：编译为二进制，直接运行
• 前端：cd 前端 && npm run build → 输出到 后端/public/admin/
• 前台/极简：分别 build → 输出到 后端/public/template/common/
• build/linux：包含二进制、config、public 的完整部署包

七、环境要求

组件版本Go1.20+Node.js18+MySQL5.7+Redis6+

小氢云聚合API系统 · 文档生成于 2025-02-23 · 模块名 api-gateway