Zeus 运维管理中心

Zeus 是一个企业级运维管理中心，提供统一的导航服务、SSO 单点认证服务和工单管理系统。基于 Go (Gin) + React (Vite) + Tailwind CSS 构建，采用 Monorepo 结构，实现 RBAC 权限管理和 JWT/OIDC 认证。

核心功能

运维管理中心：统一管理企业内各类运维工具导航和单点登录系统
导航服务：提供统一的应用导航入口，集中管理应用
SSO 单点认证服务：作为身份提供者（Identity Provider），为其他应用提供统一的认证服务
工单管理系统：灵活的工单流程管理，支持自定义表单和审批流程

界面预览

登录页面

导航页面

技术栈

后端

Go 1.24+ - 后端开发语言
Gin - HTTP Web 框架
GORM - ORM 框架（支持自定义日志和慢查询检测）
MySQL - 关系型数据库
JWT - 身份认证
OIDC - OpenID Connect 认证
Casbin - RBAC 权限控制
Zap - 结构化日志
Statik - 静态文件嵌入（前端打包到后端）
Prometheus - 性能监控指标

前端

React 19+ - UI 框架
Vite - 构建工具
TypeScript - 类型系统
Radix UI - 无障碍 UI 组件库
Tailwind CSS - 实用优先的 CSS 框架
React Router - 路由管理
Axios - HTTP 客户端
Zustand - 状态管理
Sonner - Toast 通知
i18next - 国际化支持（中英文切换）

功能特性

🎯 导航服务

统一应用导航入口
应用分类管理
应用图标和描述
快速访问常用应用
应用搜索功能

🔐 SSO 单点认证服务

作为身份提供者（Identity Provider）支持：

OIDC Provider

完整的 OpenID Connect 实现
支持 Authorization Code Flow
支持 Client Credentials Flow
支持 Refresh Token
标准 OIDC 端点（Discovery、JWKS、Token、UserInfo 等）

LDAP Server

内置 LDAP 服务器
支持 Bind 认证和 Search 查询
兼容主流 LDAP 客户端（GitLab、Jenkins、Nexus 等）

CAS Server

CAS 3.0 协议支持
标准 CAS 端点（/login、/logout、/validate、/serviceValidate、/p3/serviceValidate）
Service Ticket 和 Proxy Ticket 支持
单点登出（Single Logout）
兼容主流 CAS 客户端

多租户管理

租户隔离
SSO 用户/用户组管理
OIDC 应用管理

📋 工单管理系统 `开发中`

⚠️ 工单功能目前处于开发阶段，基本功能已完成，部分高级功能持续完善中。

完整的工单生命周期管理：

工单类型管理

自定义工单类型
类型启用/禁用控制
关联表单模板和审批流程

表单模板

可视化表单设计器
支持多种字段类型（文本、数字、日期、下拉选择等）
字段校验规则配置
模板复用

审批流程

可视化流程设计器
多级审批节点配置
支持多种审批人类型：
- 指定角色审批
- 指定用户审批
- 表单字段动态指定
条件分支（基于表单字段值）
流程版本管理

工单操作

创建工单（支持快捷模板）
工单提交与审批
审批通过/拒绝
工单完成/取消
评论功能
附件上传/下载
审批记录追溯

工单视图

我的工单
待我审批
我处理的工单
抄送我的工单

统计报表

工单状态分布
工单优先级分布
按类型统计

👥 用户与权限管理

用户管理

用户列表（分页、搜索）
用户创建/编辑/删除
用户角色分配
用户状态管理
密码修改

角色管理

角色列表（分页、搜索）
角色创建/编辑/删除
角色策略分配（基于 Casbin RBAC）
角色菜单分配
多角色支持

菜单管理

菜单树形结构
动态菜单生成（根据用户权限）
菜单图标选择器
菜单排序

⚙️ 系统配置

OIDC 配置管理
邮件服务配置
邮件测试功能

📊 性能监控

Prometheus 格式指标
请求耗时统计
请求大小统计
错误计数统计

🌐 国际化

中英文切换
语言持久化存储
界面文本完整国际化

🎨 用户体验

响应式设计
现代化 UI 设计
明暗主题切换
多标签页管理
角色切换（支持多角色用户）

项目结构

zeus/
├── backend/                    # Go 后端服务
│   ├── cmd/
│   │   └── server/            # 应用入口
│   ├── internal/
│   │   ├── casbin/            # RBAC 权限控制
│   │   ├── config/            # 配置管理
│   │   ├── core/              # 核心功能（数据库初始化、种子数据）
│   │   ├── global/            # 全局变量
│   │   ├── handler/           # HTTP 处理器
│   │   │   └── sso/          # SSO 相关处理器（OIDC/LDAP/CAS）
│   │   ├── ldap/              # LDAP 服务器
│   │   ├── middleware/        # 中间件（JWT、CORS、日志等）
│   │   ├── model/             # 数据模型
│   │   │   ├── request/      # 请求模型
│   │   │   ├── response/     # 响应模型
│   │   │   └── sso/          # SSO 模型（用户、租户、客户端等）
│   │   ├── router/            # 路由配置
│   │   └── service/           # 业务逻辑层
│   │       └── sso/          # SSO 服务（OIDC/LDAP/CAS Provider）
│   ├── pkg/                   # 公共包
│   │   ├── crypto/           # 加密工具
│   │   ├── email/            # 邮件服务
│   │   ├── jwt/              # JWT 工具
│   │   ├── logger/           # 日志工具
│   │   ├── notify/           # 通知服务（钉钉/企业微信）
│   │   ├── scheduler/        # 定时任务
│   │   ├── storage/          # 文件存储（本地/OSS/S3）
│   │   └── utils/            # 通用工具函数
│   ├── statik/                # 静态文件嵌入（自动生成）
│   ├── config.yaml            # 配置文件
│   └── config.yaml.example    # 配置示例
├── frontend/                   # React 前端应用
│   ├── public/                # 静态资源
│   └── src/
│       ├── api/               # API 请求封装
│       ├── assets/            # 静态资源（图片、字体等）
│       ├── components/        # 公共组件
│       │   ├── ticket/       # 工单相关组件
│       │   └── ui-tw/        # Tailwind UI 组件
│       ├── hooks/             # 自定义 Hooks
│       ├── i18n/              # 国际化配置
│       │   └── locales/      # 语言包（zh/en）
│       ├── layouts/           # 布局组件
│       ├── lib/               # 第三方库封装
│       ├── pages/             # 页面组件
│       │   ├── api/          # API 管理
│       │   ├── dashboard/    # 仪表盘
│       │   ├── login/        # 登录页
│       │   ├── menu/         # 菜单管理
│       │   ├── navigation/   # 导航管理
│       │   ├── oidc-callback/# OIDC 回调
│       │   ├── role/         # 角色管理
│       │   ├── sso/          # SSO 管理（租户/用户/应用）
│       │   ├── system/       # 系统配置
│       │   ├── ticket/       # 工单管理
│       │   └── user/         # 用户管理
│       ├── router/            # 路由配置
│       ├── store/             # 状态管理（Zustand）
│       └── utils/             # 工具函数
├── docs/                       # 文档目录
│   └── plans/                 # 设计文档
├── image/                      # 界面截图
└── README.md

快速开始

环境要求

Go 1.24+
Node.js 18+
MySQL 5.7+

后端启动

配置数据库

cd backend
cp config.yaml.example config.yaml
# 编辑 config.yaml，配置数据库连接信息

初始化数据库

CREATE DATABASE zeus CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

启动服务
```
cd backend
go run cmd/server/main.go
# 首次运行会自动创建表结构和初始化数据
```
默认管理员账号：
- 用户名: admin
- 密码: admin123
服务将在 http://localhost:8080 启动

前端启动

安装依赖
```
cd frontend
yarn install
```
启动开发服务器
```
yarn dev
```
前端将在 http://localhost:3000 启动

构建部署

# 完整构建（前端 + 嵌入到后端）
make build

# 或分步构建
make build-frontend  # 构建前端
make build-backend   # 构建后端

# 运行
./backend/bin/server

配置说明

数据库配置

database:
  host: localhost
  port: 3306
  user: root
  password: password
  dbname: zeus
  charset: utf8mb4
  max_open_conns: 100
  max_idle_conns: 10
  log_level: warn      # GORM 日志级别
  slow_threshold: 200  # 慢查询阈值（毫秒）

SSO 配置

OIDC Provider

sso:
  enabled: true
  issuer: "https://sso.example.com"
  oidc:
    access_token_ttl: 3600
    refresh_token_ttl: 604800
    code_ttl: 600

LDAP Server

sso:
  ldap:
    enabled: true
    port: 389
    base_dn: "dc=zeus,dc=local"
    admin_dn: "cn=admin,dc=zeus,dc=local"
    admin_password: "your-admin-password"

CAS Server

sso:
  cas:
    enabled: true
    ticket_ttl: 300  # Service Ticket 有效期（秒）
    tgt_ttl: 28800   # TGT 有效期（秒），默认 8 小时
    single_logout: true  # 是否启用单点登出

CAS 端点：

注意：所有 CAS 端点都需要在路径中指定 clientId（应用的 client_id）

端点	路径	说明
Login	`/cas/:clientId/login`	登录端点
Logout	`/cas/:clientId/logout`	登出端点
Validate	`/cas/:clientId/validate`	CAS 1.0 票据验证
ServiceValidate	`/cas/:clientId/serviceValidate`	CAS 2.0 票据验证
P3 ServiceValidate	`/cas/:clientId/p3/serviceValidate`	CAS 3.0 票据验证（支持属性）
ProxyValidate	`/cas/:clientId/proxyValidate`	代理票据验证
Proxy	`/cas/:clientId/proxy`	获取代理票据
SAMLValidate	`/cas/:clientId/samlValidate`	SAML 1.1 验证

CAS 接入步骤：

在 Zeus 管理后台创建 OIDC 应用，获取 client_id
配置应用的 root_url（如 https://app.example.com）
在客户端应用中配置 CAS 服务端地址

示例： 假设 Zeus 部署在 https://sso.example.com，应用的 client_id 为 my-app

登录地址: https://sso.example.com/cas/my-app/login?service=https://app.example.com/callback
登出地址: https://sso.example.com/cas/my-app/logout?service=https://app.example.com
验证地址: https://sso.example.com/cas/my-app/serviceValidate?ticket=ST-xxx&service=https://app.example.com/callback

文件存储配置

storage:
  type: local  # local, oss, s3
  local:
    path: ./uploads
  oss:
    endpoint: oss-cn-hangzhou.aliyuncs.com
    access_key_id: your-access-key
    access_key_secret: your-secret
    bucket: your-bucket
  s3:
    endpoint: s3.amazonaws.com
    region: us-east-1
    access_key_id: your-access-key
    secret_access_key: your-secret
    bucket: your-bucket

SSO 客户端配置示例

GitLab (OIDC)

gitlab_rails['omniauth_providers'] = [
  {
    name: "openid_connect",
    label: "Zeus SSO",
    args: {
      scope: ["openid", "profile", "email", "groups"],
      issuer: "https://sso.example.com",
      discovery: true,
      client_options: {
        identifier: "your-client-id",
        secret: "your-client-secret",
        redirect_uri: "https://gitlab.example.com/users/auth/openid_connect/callback"
      }
    }
  }
]

Grafana (OIDC)

[auth.generic_oauth]
enabled = true
name = Zeus SSO
client_id = your-client-id
client_secret = your-client-secret
scopes = openid profile email groups
auth_url = https://sso.example.com/oauth/authorize
token_url = https://sso.example.com/oauth/token
api_url = https://sso.example.com/oauth/userinfo

GitLab (LDAP)

gitlab_rails['ldap_servers'] = {
  'main' => {
    'label' => 'Zeus LDAP',
    'host' => 'sso.example.com',
    'port' => 389,
    'uid' => 'uid',
    'bind_dn' => 'cn=admin,dc=zeus,dc=local',
    'password' => 'admin-password',
    'base' => 'ou=users,o=tenant_name,dc=zeus,dc=local'
  }
}

Spring Boot (CAS)

# application.yml
cas:
  server:
    prefix: https://sso.example.com/cas/my-app
    login-url: ${cas.server.prefix}/login
    logout-url: ${cas.server.prefix}/logout
  client:
    service-url: https://app.example.com
    validation-type: CAS3  # CAS1, CAS2, CAS3

<!-- pom.xml -->
<dependency>
    <groupId>org.jasig.cas.client</groupId>
    <artifactId>cas-client-core</artifactId>
    <version>3.6.4</version>
</dependency>

PHP (CAS)

// 使用 phpCAS 库
phpCAS::client(CAS_VERSION_3_0, 'sso.example.com', 443, '/cas/my-app');
phpCAS::setNoCasServerValidation();
phpCAS::forceAuthentication();

$user = phpCAS::getUser();
$attributes = phpCAS::getAttributes();

Node.js (CAS)

// 使用 cas-authentication 库
const CASAuthentication = require('cas-authentication');

const cas = new CASAuthentication({
  cas_url: 'https://sso.example.com/cas/my-app',
  service_url: 'https://app.example.com',
  cas_version: '3.0'
});

// Express 中间件
app.get('/login', cas.bounce, (req, res) => {
  res.send(`Hello ${req.session.cas_user}`);
});

Python Flask (CAS)

# 使用 flask-cas 库
from flask import Flask
from flask_cas import CAS

app = Flask(__name__)
cas = CAS(app)

app.config['CAS_SERVER'] = 'https://sso.example.com/cas/my-app'
app.config['CAS_AFTER_LOGIN'] = 'index'

@app.route('/')
def index():
    if cas.username:
        return f'Hello {cas.username}'
    return 'Not logged in'

注意事项

生产环境

修改 JWT Secret
设置 server.mode 为 release
配置数据库日志级别为 warn 或 error
配置日志输出到文件

安全

密码使用 bcrypt 加密存储
敏感配置使用环境变量
定期备份数据库

性能

根据实际情况调整数据库连接池大小
设置合适的慢查询阈值
生产环境建议关闭 GORM 的 info 级别日志

许可证

本项目采用 MIT License 开源协议。

Name		Name	Last commit message	Last commit date
Latest commit History 41 Commits
backend		backend
frontend		frontend
image		image
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md

License

hiflycat/zeus

Folders and files

Latest commit

History

Repository files navigation