星辉云(XHuiCloud) 开源项目安装与使用指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00444/article/details/142839929

星辉云(XHuiCloud) 开源项目安装与使用指南

XHuiCloud 🎉(星辉云)，基于SpringBoot、SpringCloudAlibaba、SpringAuthorizationServer的微服务开发框架， RBAC权限管理系统、支持OAuth2.0协议、支持多种社交登录，拥有众多常用的第三方自动装配包，即下即用、简单便捷、如果觉得可以帮助到您，麻烦右上角点个star、关注后续更新~:sparkles::sparkles::sparkles: 项目地址: https://gitcode.com/gh_mirrors/xh/XHuiCloud

项目简介

星辉云是一个基于SpringBoot、SpringCloudAlibaba、SpringAuthorizationServer的现代微服务开发框架。该框架旨在简化企业级应用的开发过程，提供了一套完整的RBAC权限管理系统，并支持OAuth2.0授权协议以及多种社交账户登录。通过整合一系列先进的技术如Seata分布式事务、Nacos注册中心、Sentinel流量防护等，它帮助开发者专注于业务逻辑，减少了技术实现的复杂度。

1. 项目目录结构及介绍

星辉云的项目结构精心设计，便于维护和扩展：

XHuiCloud
├── XHuiCloud-auth            -- 认证服务器模块 [端口：16000]
│   ...
├── XHuiCloud-commons          -- 共享的基础模块
│   ├── XHuiCloud-common-...   -- 各种功能细分模块，比如认证授权、动态数据源、ElasticJob配置等
│   ...
├── XHuiCloud-business         -- 系统业务模块
├── XHuiCloud-gateway          -- API网关模块 [端口：15000]
├── XHuiCloud-generator        -- 代码生成工具
├── ... 更多业务和服务相关模块 ...
├── XHuiCloud-register         -- 注册中心 [端口：13000]
├── XHuiCloud-monitor          -- 监控中心 [端口：9090]
└── ...

每个模块都有其特定的功能，例如auth用于处理认证和授权，gateway作为API的统一接入点，而commons则封装了各种跨模块使用的公共服务。

2. 项目启动文件介绍

星辉云的启动通常由各个模块中的主类负责，以XHuiCloud-auth为例，它的启动类可能命名为AuthApplication.java，位于模块的主包下。启动任何模块之前，确保正确配置了外部依赖与数据库连接等信息。启动命令通常是利用Maven或Gradle执行如下操作：

mvn spring-boot:run

或者如果是Gradle项目：

./gradlew bootRun

确保你已设置正确的 profiles（如果项目使用了profile区分不同运行环境）。

3. 项目配置文件介绍

星辉云的配置主要集中在application.yml或application.properties中，这些文件位于各模块的src/main/resources目录下。配置涵盖了数据源、服务端口号、第三方服务集成等关键信息。例如，在application.yml里，你会看到以下类型的配置片段：

server:
  port: 8080 # 服务端口

spring:
  application:
    name: XHuiCloud-Example
  datasource:
    url: jdbc:mysql://localhost:3306/xhuicloud?useSSL=false&serverTimezone=UTC
    username: root
    password: root
    driver-class-name: com.mysql.cj.jdbc.Driver
  
mybatis-plus:
  configuration:
    map-underscore-to-camel-case: true

# Spring Cloud Alibaba Nacos 配置示例
nacos:
  server-addr: localhost:8848

此外，认证服务器、网关、以及其他需要特殊配置的模块会有各自的配置覆盖或扩展基础配置。