小氢云聚合API系统 - 系统介绍小氢云聚合API系统
API 聚合平台 · 积分版 · 单体架构 · 版本 1.0.0
一、系统概述
小氢云聚合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