likes
comments
collection
share

开源项目TARZAN-NAV | 基于springboot的现代化导航网站系统

作者站长头像
站长
· 阅读数 3

TARZAN-NAV 导航网站

一个基于 Spring Boot、MyBatis-Plus、h2database、ehcache、Docker、websocket等技术栈实现的导航网站系统，采用主流的互联网技术架构、全新的UI设计、支持一键源码部署，拥有完整的仪表板、导航管理，用户管理、评论管理、友情链接、公告管理、运维管理等，代码完全开源，没有任何二次封装，是一个非常适合二次开发/实战的现代化导航项目👍 。

一、目标使命

  • 打造一个性能最好，在同等资源下，实现最大的用户并发数。
  • 部署简单，让技术小白也能部署使用
  • 增强用户体验，更好的UI交互，操作体验

二、项目介绍

项目演示

项目源码地址

前台社区系统

开源项目TARZAN-NAV | 基于springboot的现代化导航网站系统

后台社区系统

开源项目TARZAN-NAV | 基于springboot的现代化导航网站系统

代码展示

开源项目TARZAN-NAV | 基于springboot的现代化导航网站系统

架构图

系统架构图

开源项目TARZAN-NAV | 基于springboot的现代化导航网站系统

环境配置说明

安装 jdk1.8+

在application-dev.yml 或者application-prod.yml文件中修改 自己的邮箱配置，其他保持保持默认接口

配置文件说明

  • resources
    • application.yml: 主配置文件入口
    • application-dev.yml: 开发环境配置
    • application-prod.yml: 生成环境配置
    • ehcache.xml 本地缓存配置
    • logback-spring.xml: 日志打印相关配置文件

技术选型

后端技术栈

技术说明官网
Spring & SpringMVCJava全栈应用程序框架和WEB容器实现spring.io/
SpringBootSpring应用简化集成开发框架spring.io/projects/sp…
mybatis数据库orm框架mybatis.org
mybatis-plus数据库orm框架baomidou.com/
ehcache内存数据存储www.ehcache.org/
docker应用容器引擎www.docker.com
hikariCP数据库连接github.com/brettwooldr…
oss对象存储help.aliyun.com/document_de…
https证书letsencrypt.org/
jwtjwt登录jwt.io
lombokJava语言增强库projectlombok.org
guavagoogle开源的java工具集github.com/google/guav…
thymeleafhtml5模板引擎www.thymeleaf.org
swaggerAPI文档生成工具swagger.io
hibernate-validator验证框架hibernate.org/validator/
quick-media多媒体处理github.com/liuyueyi/qu…
liquibase数据库版本管理www.liquibase.com
jacksonjson/xml处理www.jackson.com
ip2regionip地址github.com/zoujingli/i…
websocket长连接docs.spring.io/spring/refe…
sensitive-word敏感词github.com/houbb/sensi…

三、环境搭建

开发工具

工具说明官网
IDEAjava开发工具www.jetbrains.com
Chrome浏览器www.google.com/intl/zh-CN/…
PostmanAPI接口调试www.postman.com
draw.io流程图、架构图绘制www.diagrams.net/
Axure原型图设计工具www.axure.com
navicat数据库连接工具www.navicat.com
DBeaver免费开源的数据库连接工具dbeaver.io
xshell终端模拟软件www.xshell.com/zh/xshell/

开发环境

工具版本下载
jdk1.8+www.oracle.com/java/techno…
maven3.4+maven.apache.org/
ali-oss3.15.1help.aliyun.com/document_de…
git2.34.1github.com/
docker4.10.0+docs.docker.com/desktop/
let's encrypthttps证书letsencrypt.org/

搭建步骤

1. 环境准备

首先准备好基础的开发环境，如

  • jdk/jre: 请安装jdk8+以上版本
  • maven: 本项目基于maven作为项目管理工具，因此在启动之前请配置好maven相关环境
  • git版本管理
  • 开发工具：建议idea，当然eclipse/vs也没有问题

2. 项目启动

当环境准备完毕之后，接下来就是下载项目，导入开发工具进行启动演示

2.1 项目获取

本项目所有源码开源，因此您可以在github/gitee上免费获取

通过git方式拉取项目

# Git clone
git clone git@gitee.com:taisan/tarzan-navigation.git

下载release包

若希望从一个稳定的版本进行尝试，推荐在release页下载zip包，然后本机解压

2.2 项目导入

以IDEA开发工具为例

  • File -> Open
  • 选择第一步clone的项目工程

项目导入成功之后，会自动下载依赖、构建索引，此过程用时取决于您的机器性能+网速，通常会持续一段时间，请耐心等待。

如果发现项目 build 未成功或者无法运行 Java 程序，要立马检查一下自己 Intellij IDEA 中的 Maven 是否配置成功。

开源项目TARZAN-NAV | 基于springboot的现代化导航网站系统

2.3 配置修改

在正式启动项目之前，还有几个前置步骤需要执行一下

2.3.1 数据库准备

本项目会使用数据库，因此在本机启动时，请先指定数据库；项目中默认的数据库名为 paicoding，可以通过修改配置文件中的database.name参数来替换为您喜欢的数据库名

数据库名配置: tarzan-navigation/src/main/resources/application.yml

spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    driverClassName: org.h2.Driver
    url:  jdbc:h2:file:${user.home}/.tarzan-nav/db/tarzan-nav;MODE=MYSQL
    username: root
    password: 123456
  mail:
    host: smtp.163.com
    username: vxhqqh@163.com
    password: TRXZYKQFHNZHOYMB
    default-encoding: UTF-8
    protocol: smtp
    properties:
      mail:
        smtp:
          auth: true # 启用SMTP认证
          starttls:
            enabled: true # 启用SMTP认证
            required: true # 必须采用加密链接

本项目提供了自动创建库表的功能，在项目启动之后，当库不存在时，会创建库；当表不存在时，会自动创建表，且会初始化一些测试数据

2.3.2 数据库配置

接下来我们需要做的就是设置数据库的相关连接配置

首先在进入之前，先简单了解一下配置，我们做了环境区分,在resources文件夹下，

  • dev: 本地开发环境
  • prod: 生产环境

默认的环境选择是dev，可以通过下面两种方式进行环境切换

2.4 启动

接下来就可以直接启动项目了

进入启动类: NavApplication

开源项目TARZAN-NAV | 基于springboot的现代化导航网站系统 启动完毕之后，将会在控制台看到如下输出

开源项目TARZAN-NAV | 基于springboot的现代化导航网站系统

点击控制台中的链接进入首页, 默认首页为: http://127.0.0.1:80

许可证

Apache License 2.0

Copyright (c) 2022-2032 洛阳泰山