mirror of
https://github.com/skyle1995/NetworkAuth.git
synced 2026-05-25 02:24:05 +08:00
NetworkAuth（网络授权服务）
网络授权服务 (NetworkAuth) 是一个专注于应用鉴权、接口管理和动态逻辑分发的后端系统。它基于 Go 语言开发，提供应用程序管理、API接口管理、变量管理、用户认证等核心服务。
功能特性
🚀 核心功能
- 应用管理: 支持应用的增删改查、版本管理、状态控制、密钥管理
- API接口管理: 支持多种加密算法的API接口配置（RC4、RSA、易加密等）
- 变量管理: 独立的变量系统，支持变量的增删改查和别名管理
- 函数管理: 支持自定义函数代码管理，可绑定特定应用或全局使用
- 用户管理: 完整的用户认证和权限管理系统
- 系统设置: 灵活的系统配置和参数管理
- 系统初始化: 提供引导式的数据表初始化和默认设置注入
- 日志审计: 详细的登录日志和操作日志记录，保障系统安全
🔧 技术特性
- RESTful API: 标准的 REST API 接口设计
- JWT 认证: 基于 JWT 的安全认证机制
- 多种加密算法: 支持 RC4、RSA、RSA动态、易加密等多种加密方式
- 数据库支持: 兼容 MySQL 和 SQLite 数据库 (通过 GORM)
- Redis 缓存: 集成 Redis 缓存提升性能（可选）
- 日志系统: 完整的日志记录和管理，支持日志切割 (Logrus + Lumberjack)
- 配置管理: 基于 Viper 的灵活配置系统
- 命令行工具: 基于 Cobra 的强悍 CLI 管理工具
技术栈
- 语言: Go 1.25.0
- Web 框架: Gin
- 数据库 ORM: GORM
- 缓存: Redis（可选）
- 认证: JWT + 验证码
- 日志: Logrus + Lumberjack
- 配置管理: Viper
- 命令行: Cobra
- 加密: 自定义加密工具包
项目结构
NetworkAuth/
├── cmd/ # Cobra 命令行工具定义
├── config/ # 配置文件模型与校验逻辑
├── constants/ # 全局常量定义 (版本号、状态码等)
├── controllers/ # 控制器层 (处理 HTTP 请求)
├── database/ # 数据库连接、迁移与默认数据填充
├── middleware/ # Gin 中间件 (日志、认证、维护模式等)
├── models/ # GORM 数据模型定义
├── server/ # HTTP 服务器路由注册
├── services/ # 核心业务逻辑层
├── utils/ # 通用工具函数 (加密、日志、时间等)
└── main.go # 项目入口
快速开始
环境要求
- Go 1.25.0 或更高版本
- MySQL 5.7+ 或 SQLite 3
- Redis (可选)
安装与运行
-
克隆项目
git clone https://github.com/skyle1995/NetworkAuth.git cd NetworkAuth -
安装依赖
go mod download -
运行服务器
# 直接运行 go run main.go server # 或者编译后运行 go build -o networkauth main.go ./networkauth server
命令行工具
项目基于 Cobra CLI 框架，提供了丰富的命令行工具：
# 查看帮助信息
./networkauth --help
# 启动服务器
./networkauth server
# 指定配置文件启动
./networkauth --config ./config.json server
# 指定端口启动 (覆盖配置文件)
./networkauth server -p 8080
部署
Docker 部署
# 构建镜像
docker build -t networkauth .
# 运行容器
docker run -d -p 8080:8080 networkauth
生产环境部署
-
编译生产版本
go build -o networkauth main.go -
准备配置文件（可参考默认配置）。
-
使用进程管理工具（如 systemd 或 supervisor）管理后端服务进程。
许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。