Zs Admin

Appearance

安装运行 ​

1. 环境要求 ​

提示

  • JDK 17+
  • Maven 3.8+
  • MySQL 8.0+
  • Redis 6.0+

2. 安装步骤 ​

2.1 克隆项目 ​

首先，您需要从 Git 仓库克隆项目代码：

bash
# GitHub 仓库
git clone https://github.com/zsadmin2025/zs-project-java.git
bash
# Gitee 仓库
git clone https://gitee.com/zsadmin2025/zs-admin-java.git
cd zs-admin-java

2.2 配置数据库 ​

  1. 创建数据库

    使用 MySQL 客户端连接到数据库服务器，并创建一个新的数据库：

    sql
    CREATE DATABASE zsadmin DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

  2. 配置数据库连接

    编辑项目中的配置文件，设置正确的数据库连接信息。配置文件位于 src/main/resources/application-dev.yml（开发环境）或 src/main/resources/application-prod.yml（生产环境）：

    yaml
    spring:
  datasource:
    url: jdbc:mysql://localhost:3306/zsadmin?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver

    请将 your_password 替换为您的 MySQL 密码。

  3. 运行数据库初始化脚本

    项目提供了数据库初始化脚本，用于创建表结构和基础数据。脚本位于 docs/sql/zsadmin.sql，您可以使用 MySQL 客户端运行该脚本：

    bash
    mysql -u root -p zsadmin < docs/sql/zsadmin.sql

    或者在 MySQL 客户端中执行：

    sql
    source /path/to/zsadmin.sql;

2.3 配置 Redis ​

编辑项目中的配置文件，设置正确的 Redis 连接信息：

yaml
spring:
  redis:
    host: localhost
    port: 6379
    password: 
    database: 0
    timeout: 10000ms

如果您的 Redis 服务器设置了密码，请在 password 字段中填写密码。

3. 启动应用 ​

3.1 使用 IDE 启动 ​

如果您使用的是 IntelliJ IDEA 或 Eclipse 等 IDE，可以直接在 IDE 中启动应用：

  1. 导入项目

    • 打开 IDE，选择 "Import Project" 或 "Open Project"
    • 选择项目的 pom.xml 文件，点击 "Open"
    • 按照 IDE 的提示完成项目导入

  2. 启动应用

    • 找到项目中的 ZsAdminApplication.java 文件（位于 src/main/java/com/zsadmin/ 目录下）
    • 右键点击该文件，选择 "Run ZsAdminApplication" 或 "Debug ZsAdminApplication"

3.2 使用 Maven 命令启动 ​

您也可以使用 Maven 命令来启动应用：

bash
# 开发环境启动
mvn spring-boot:run -Dspring.profiles.active=dev

# 生产环境启动
mvn spring-boot:run -Dspring.profiles.active=prod

3.3 访问应用 ​

应用启动成功后，您可以通过以下地址访问：