freego

FreeGo 高性能框架

🚀 专注于极致性能优化与强安全取向的 Go 语言企业级框架（常见金融场景可参考 README_SECURITY.md）

FreeGo 面向高并发与强安全场景，核心能力聚焦在服务接入层、数据访问层及下文工程化配套组件：

• API 框架：提供 HTTP / WebSocket / RPCX 接入与过滤器链能力，并提供认证、授权、完整性校验和防重放能力；安全流程与威胁模型见 README_SECURITY.md。
• ORM 框架：面向 MySQL / Mongo 的极低反射热点路径与预分配友好数据访问能力，兼顾吞吐与内存效率（以 ormx 为准）。

同时提供缓存（含本地与 Redis）、分布式锁与限流、AMQP 消息、结构化日志、YAML 配置装载等工程化配套能力，便于在生产环境拼装服务。对外 HTTPS/TLS 一般由反向代理或网关终止；框架侧重应用层路由、过滤器与密码学能力（细则见安全文档）。

📚 目录

• 🚀 框架特性
  • 核心组件架构
• 🔧 快速开始
• 🔐 安全特性
• 📈 性能对比
• 🗄️ ORM 特性
• 🎯 选择指南
• 📞 联系与支持

🚀 框架特性

🌐 Server & API 框架

🗄️ ORM 数据库框架

核心组件架构

┌─────────────────────────────────────────────────────────────────┐
│                      FreeGo Framework                           │
├─────────────────────────────────────────────────────────────────┤
│              三大服务端（HTTP · WebSocket · RPCX）                │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │  HTTP · WebSocket · RPCX                                  │   │
│  │  • 单机 QPS: 50,000+（HTTP 典型场景，视硬件）              │   │
│  │  • 响应延迟: 亚毫秒级（典型 HTTP 路由）                   │   │
│  └──────────────────────────────────────────────────────────┘   │
├─────────────────────────────────────────────────────────────────┤
│                  Filter Chain (过滤器链)                         │
│  ┌────────────┬────────────┬────────────┬────────────┬──────┐   │
│  │ 限流过滤器  │ 参数过滤器  │ 会话过滤器  │ 权限过滤器  │ 自定义│   │
│  └────────────┴────────────┴────────────┴────────────┴──────┘   │
├─────────────────────────────────────────────────────────────────┤
│                 Security & Crypto (安全层)                       │
│  ┌────────────┬────────────┬────────────┬────────────┬──────┐   │
│  │ JWT/RBAC   │ Ed25519    │ X25519     │ AES-GCM    │ HMAC/重放 │
│  └────────────┴────────────┴────────────┴────────────┴──────┘   │
├─────────────────────────────────────────────────────────────────┤
│                Business Logic Layer (业务层)                     │
│  ┌────────────┬────────────┬────────────┬────────────┬──────┐   │
│  │ 请求上下文  │ 路由管理    │ 中间件管理  │ 错误处理    │ 监控 │   │
│  └────────────┴────────────┴────────────┴────────────┴──────┘   │
├─────────────────────────────────────────────────────────────────┤
│                  ORM Layer (数据访问层)                          │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │  FreeGo ORM                                              │   │
│  │  • 零内存浪费 • 极低反射热点 • 精确容量预估                │   │
│  │  • 高并发优化，性能显著提升                                │   │
│  └──────────────────────────────────────────────────────────┘   │
├─────────────────────────────────────────────────────────────────┤
│                 Database Layer (数据库层)                        │
│  ┌────────────┬────────────┬────────────┬────────────┬──────┐   │
│  │   MySQL    │  MongoDB   │ Redis 缓存 │ 锁 / 限流  │ 扩展  │   │
│  └────────────┴────────────┴────────────┴────────────┴──────┘   │
└─────────────────────────────────────────────────────────────────┘

【性能指标摘录】（来自仓库内 HTTP/安全相关 benchmark；请以本机 `go test -bench` 为准）
• ECC 登录认证: 3,324 TPS       • AES 数据查询: 65,928 TPS
• 单条查询: 130,901 ns/op       • 批量查询: 8,931,733 ns/op
• ORM 批量约 6.82MB/op（与下表一致） • GC: 93,139 allocs/op（仓库 benchmark 摘录）
• 并发连接: 10,000+           • CPU 使用: < 30%（视负载）

🔧 快速开始

📦 安装

go get github.com/godaddy-x/freego

🚀 基础示例

package main

import (
    "github.com/godaddy-x/freego/node"
    "github.com/godaddy-x/freego/utils/jwt"
)

func main() {
    httpNode := &node.HttpNode{}

    // 配置 JWT 认证
    httpNode.AddJwtConfig(jwt.JwtConfig{
        TokenKey: "your-256-bit-secret-key",
        TokenExp: jwt.ONE_HOUR,
    })

    // 添加路由
    httpNode.GET("/health", func(ctx *node.Context) error {
        return ctx.Json(map[string]interface{}{"status": "ok"})
    })

    // 启动服务
    httpNode.StartServer(":8080")
}

🔐 安全特性

多重认证体系

• JWT Token: 无状态认证，支持短过期时间
• HMAC-SHA256: 防止重放攻击和数据篡改
• Ed25519 / X25519: 签名与密钥协商（按 Plan / 路由启用，详见 README_SECURITY.md）
• AES-GCM: 认证加密，兼顾机密性与完整性（按 Plan / 路由启用）

安全机制

• 时间戳验证: 请求在典型 ±5 分钟窗口内有效（以路由/配置为准）
• 随机数防重放: 每个请求使用唯一 nonce
• 业务完整性: HMAC / 外层签名等与 Token、Secret 按配置组合校验

📈 性能对比

HTTP API 性能

上表与架构图内摘录同源；复现见 http_test.go、http_security_test.go 等。

ORM 批量查询性能 (3000 行数据)

顺序模式测试: 17 个字段完全公平对比，更真实反映实际业务场景。完整环境与复现步骤见 orm_performance_report.md；Mongo 见 mongodb_performance_report.md。

🗄️ ORM 特性

核心优化技术

• 零内存浪费: 精确容量预分配，避免扩容
• 极低反射开销: 热点路径侧重直接装配与预分配，减少反射依赖；元数据解析（以 ormx 为准）
• 智能预估: 递归 OR 条件精确容量计算
• 高并发支持: 原子操作和智能连接池

适用场景

• 高频数据库操作
• 大数据量处理
• 内存敏感应用
• 强一致、高性能或数据密集型业务系统

🎯 选择指南

选择 FreeGo 的理由

快速部署

# 示例：Go 版本与 go.mod 一致；适用于你的应用仓库（本仓库为库时需自带 main 包再构建）
FROM golang:1.26-alpine
WORKDIR /app
COPY . .
RUN go build -o main .
CMD ["./main"]

📞 联系与支持

• 📧 GitHub: https://github.com/godaddy-x/freego
• 🐛 Issues: 报告问题
• 📖 安全文档: README_SECURITY.md
• 📊 ORM 报告: orm_performance_report.md · mongodb_performance_report.md

欢迎通过 Issues 反馈问题与建议。