TARZAN-NAV 导航网站
一个基于 Spring Boot、MyBatis-Plus、h2database、ehcache、Docker、websocket等技术栈实现的导航网站系统，采用主流的互联网技术架构、全新的UI设计、支持一键源码部署，拥有完整的仪表板、导航管理，用户管理、评论管理、友情链接、公告管理、运维管理等，代码完全开源，没有任何二次封装，是一个非常适合二次开发/实战的现代化导航项目👍 。
一、目标使命
- 打造一个性能最好，在同等资源下，实现最大的用户并发数。
- 部署简单，让技术小白也能部署使用
- 增强用户体验，更好的UI交互，操作体验
二、项目介绍
项目演示
项目源码地址
- 项目仓库（GitHub）：github.com/taishan666/...
- 项目仓库（码云）：gitee.com/taisan/tarz...
前台社区系统
- 项目演示地址：http://82.157.61.108/
后台社区系统
- 项目演示地址：http://82.157.61.108/admin
代码展示
架构图
系统架构图
环境配置说明
安装 jdk1.8+
在application-dev.yml 或者application-prod.yml文件中修改 自己的邮箱配置，其他保持保持默认接口
配置文件说明
- resources
- application.yml: 主配置文件入口
- application-dev.yml: 开发环境配置
- application-prod.yml: 生成环境配置
- ehcache.xml 本地缓存配置
- logback-spring.xml: 日志打印相关配置文件
技术选型
后端技术栈
| 技术 | 说明 | 官网 | |
|---|---|---|---|
| Spring & SpringMVC | Java全栈应用程序框架和WEB容器实现 | spring.io/ | |
| SpringBoot | Spring应用简化集成开发框架 | 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/ | |
| jwt | jwt登录 | jwt.io | |
| lombok | Java语言增强库 | projectlombok.org | |
| guava | google开源的java工具集 | github.com/google/guav... | |
| thymeleaf | html5模板引擎 | www.thymeleaf.org | |
| swagger | API文档生成工具 | swagger.io | |
| hibernate-validator | 验证框架 | hibernate.org/validator/ | |
| quick-media | 多媒体处理 | github.com/liuyueyi/qu... | |
| liquibase | 数据库版本管理 | www.liquibase.com | |
| jackson | json/xml处理 | www.jackson.com | |
| ip2region | ip地址 | github.com/zoujingli/i... | |
| websocket | 长连接 | docs.spring.io/spring/refe... | |
| sensitive-word | 敏感词 | github.com/houbb/sensi... |
三、环境搭建
开发工具
| 工具 | 说明 | 官网 |
|---|---|---|
| IDEA | java开发工具 | www.jetbrains.com |
| Chrome | 浏览器 | www.google.com/intl/zh-CN/... |
| Postman | API接口调试 | 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/ |
开发环境
| 工具 | 版本 | 下载 |
|---|---|---|
| jdk | 1.8+ | www.oracle.com/java/techno... |
| maven | 3.4+ | maven.apache.org/ |
| ali-oss | 3.15.1 | help.aliyun.com/document_de... |
| git | 2.34.1 | github.com/ |
| docker | 4.10.0+ | docs.docker.com/desktop/ |
| let's encrypt | https证书 | letsencrypt.org/ |
搭建步骤
1. 环境准备
首先准备好基础的开发环境，如
- jdk/jre: 请安装jdk8+以上版本
- maven: 本项目基于maven作为项目管理工具，因此在启动之前请配置好maven相关环境
- git版本管理
- 开发工具：建议idea，当然eclipse/vs也没有问题
2. 项目启动
当环境准备完毕之后，接下来就是下载项目，导入开发工具进行启动演示
2.1 项目获取
本项目所有源码开源，因此您可以在github/gitee上免费获取
通过git方式拉取项目
bash
# 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 是否配置成功。
2.3 配置修改
在正式启动项目之前，还有几个前置步骤需要执行一下
2.3.1 数据库准备
本项目会使用数据库，因此在本机启动时，请先指定数据库；项目中默认的数据库名为 paicoding，可以通过修改配置文件中的database.name参数来替换为您喜欢的数据库名
数据库名配置: tarzan-navigation/src/main/resources/application.yml
yaml
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
启动完毕之后，将会在控制台看到如下输出
点击控制台中的链接进入首页, 默认首页为: http://127.0.0.1:80
许可证
Copyright (c) 2022-2032 洛阳泰山