ContiNew Admin

切换日光/暗黑模式

快速开始 ​

后端 ​

环境说明 ​

README

下方为本项目后端所需运行环境，请注意检查您的环境是否与本项目所需一致，以减少环境引起的问题。

运行环境演示环境版本最低版本安装教程
JDKOpenJDK 17.0.217《Java 开发环境搭建》
Maven3.6.33.6.x+-
MySQL8.0.335.7.x+-
Redis7.2.3-

克隆项目 ​

使用下方 Git 命令，将项目克隆到本地开发机器。也可以先在 Github 或 Gitee 上将项目 fork 到自己的仓库，然后将 fork 过来的项目克隆到本地。

git clone https://gitee.com/continew/continew-admin.git
git clone https://gitcode.com/continew/continew-admin.git
git clone https://github.com/continew-org/continew-admin.git

当然了，你可以通过任何一种你喜欢的方式将项目下载到本地（正式开发时，请下载最新稳定版，详情见《项目开发》篇），包括且不限于下载压缩包、在 IDE 中直接导入等，全看个人习惯。

1

在 IDE 中打开 ​

在 IDE 中打开项目，本指南均以 IntelliJ IDEA 为例，其他 IDE 可根据需要自行查找类似使用方式。

2

3

创建数据库 ​

提前创建好项目数据库，例如：continew_admin。

注意

必须是一个空的数据库！不要有任何表！本项目集成了 Liquibase 组件，在项目启动时会自动在数据库中初始化数据表和数据，不需要人工去执行 SQL 脚本。
如果你第一次使用本项目，以前也没接触过 Liquibase，请务必按要求进行，不要对着干。（后端指南有 Liquibase 介绍，如有疑问后续可前往阅读）

4

修改配置 ​

将 application-dev.yml 配置文件中的数据源配置信息、Redis 配置信息修改为自己实际的环境信息。

5

6

不过，相比于在配置文件中修改值，还有一种更为方便的方式调整配置。在配置文件中，你会看到很多类似于 ${DB_HOST:127.0.0.1} 的配置值，它表示如果存在 DB_HOST 环境变量，则使用环境变量 DB_HOST 的值，如果没有则使用默认值 127.0.0.1。

在 IntelliJ IDEA 等 IDE 中，可以直接配置启动程序的环境变量。

7

进入下图配置界面后，直接按下 Alt + E，可以直接弹出【环境变量】配置输入框，当然也可以如下图所示依次点选。

8

9

点击【环境变量】输入框右侧的【编辑】按钮，可以一条条的去添加环境变量。本项目需要配置的环境变量有：DB_HOST、DB_PORT、DB_USER、DB_PWD、DB_NAME；REDIS_HOST、REDIS_PORT、REDIS_PWD、REDIS_DB。

10

11

温馨提示

一条条添加环境变量实在过于麻烦，不知道你有没有注意到环境变量配置下方有个提示：用分号分隔变量：VAR=value;VAR1=value1。所以，你可以复制下方的这串环境变量，将配置更改后直接粘贴过去即可。

DB_HOST=你的配置;DB_NAME=你的配置;DB_PORT=你的配置;DB_PWD=你的配置;DB_USER=你的配置;REDIS_DB=你的配置;REDIS_HOST=你的配置;REDIS_PORT=你的配置;REDIS_PWD=你的配置

12

启动程序 ​

配置修改完毕后，直接启动程序即可。是的，没看错，无需单独执行表结构和初始数据脚本（务必提前创建好对应数据库），直接以调试方式或正常启动程序即可，项目启动后，Liquibase 组件会自动执行 continew-webapi/src/main/resources/db/changelog 目录下的初始化 SQL 脚本。

注意： 是 ContiNewAdminApplication，别启动错了。

13

等到控制台输出下方这段内容，表示后端项目启动成功。

14

也可以点击打开 API 地址的链接，浏览器将会输出如下内容。

json
{
    "code": "0",
    "msg": "ContiNew Admin service started successfully.",
    "success": true,
    "timestamp": 1736860212450,
    "data": null
}

友情提示

后端服务成功启动！你果然很棒！如果这个过程中遇到了未知错误，你也确认自己操作无误的话，可以在常见问题中先找找看。

项目每增长一颗 star，可以给维护者们注入莫大的激情，诚恳的希望您能动动发财的小手，为 ContiNew Admin 点亮一颗小星星。

Gitee Stars  GitHub Stars  GitCode Stars

前端 ​

环境说明 ​

README

下方为本项目前端所需运行环境，请注意检查您的环境是否与本项目所需一致，以减少环境引起的问题。

运行环境演示环境版本最低版本安装教程
Node18.16.018+-
PNPM8.15.58+-

本项目前端使用 pnpm（Performant NPM）作为包管理工具。

bash
# 安装 pnpm
npm install -g pnpm
# 查看版本
pnpm -v

克隆项目 ​

温馨提示

如果是 ContiNew Admin v2.3.0 之前的版本，前端项目 continew-admin-ui 和后端项目均处于同一个仓库，所以当下载了后端项目之后，对应的前端项目也已经包含在内了。

使用下方 Git 命令，将项目克隆到本地开发机器。也可以先在 Github 或 Gitee 上将项目 fork 到自己的仓库，然后将 fork 过来的项目克隆到本地。

git clone https://gitee.com/continew/continew-admin-ui.git
git clone https://gitcode.com/continew/continew-admin-ui.git
git clone https://github.com/continew-org/continew-admin-ui.git

当然了，你可以通过任何一种你喜欢的方式将项目下载到本地（正式开发时，请下载最新稳定版，详情见《项目开发》篇），包括且不限于下载压缩包、在 IDE 中直接导入等，全看个人习惯。

15

在 IDE 中打开 ​

在 Visual Studio Code 或 WebStorm 等 IDE 中打开前端项目 continew-admin-ui，本指南均以 WebStorm 为例，其他 IDE 可根据需要自行查找类似使用方式。

16

17

打开终端，输入如下命令，安装依赖。

bash
pnpm install

18

启动程序 ​

等待依赖安装完毕后，打开 package.json，运行 dev 脚本，或者直接在终端运行如下命令。

bash
pnpm dev

19

20

前端项目启动成功，默认浏览器会弹出标签页打开登录页面，如果后端项目也已经正常启动，登录页面会出现图形验证码。输入账密及验证码，点击登录，开始体验。（如在使用中遇到问题欢迎在交流群内或 issues 中进行反馈）

默认账号

系统管理员：
用户名：admin
密码：admin123

测试员：
用户名：test
密码：test123

恭喜你！项目启动成功了！

21

友情提示

如果你只想在本地启动前端，又苦于没有后端服务。别急，大佬 莫愁 免费提供了 ContiNew Admin 后端 API 服务，可进群 @莫愁 大佬白嫖，白嫖成功后把 .env.development 文件内的接口前缀配置删除，接口地址配置更改成对应 API 服务地址即可。

js
# 环境变量 (命名必须以 VITE_ 开头)

# 接口前缀 
VITE_API_PREFIX = '/api'

# 接口地址
VITE_API_BASE_URL = 'http://localhost:8000'

# 地址前缀
VITE_BASE = '/'

# 是否开启开发者工具
VITE_OPEN_DEVTOOLS = true

项目每增长一颗 star，可以给维护者们注入莫大的激情，诚恳的希望您能动动发财的小手，为 ContiNew Admin 点亮一颗小星星。

Gitee Stars  GitHub Stars  GitCode Stars