jeesns 的安装和配置教程

jeesns 是一款基于 JAVA 企业级平台研发的社交管理系统，它利用了企业级 JAVA 的高效、安全、稳定等优势，是国内首个基于 JAVA 版的开源 SNS。jeesns 可以用来搭建门户、论坛、社区、微博、问答、知识付费平台等多种类型的社交网站。

该项目的主要编程语言是 Java，同时使用了前端技术如 JavaScript、CSS、HTML，以及模板引擎 Freemarker。

项目使用的关键技术和框架

• 后端开发框架：SpringBoot2 + Mybatis
• 前端开发框架：ZUI + JQuery + Bootstrap
• 数据库：MySQL
• 模板引擎：Freemarker

项目安装和配置的准备工作

在开始安装和配置 jeesns 项目之前，您需要确保以下软件已正确安装在您的计算机上：

• JDK：版本 8 或更高
• MySQL：版本 5.1 或更高
• Maven：用于项目构建和管理
• IDE：如 Eclipse 或 IntelliJ IDEA，用于项目开发和调试

确保以上软件安装完成后，您可以开始以下详细的安装步骤。

安装步骤

1. 克隆项目

   使用 Git 命令克隆项目到本地：

   git clone https://github.com/zchuanzhao/jeesns.git
   

2. 创建数据库

   在 MySQL 中创建一个新的数据库，字符集选择为 utf8 或 utf8mb4。

3. 执行数据库脚本

   在克隆的项目目录中，找到 /jeesns-web/database 目录，并执行其中的 SQL 脚本来初始化数据库。

4. 导入 Maven 项目

   使用您的 IDE（如 Eclipse 或 IntelliJ IDEA）导入 Maven 项目。选择 File -> Import -> Maven -> Existing Maven Projects，然后选择克隆的项目目录。

5. 设置项目编码和 JDK 版本

   在 IDE 中设置项目编码为 UTF-8，并选择 JDK 1.8 或更高版本。

6. 修改数据库连接

   打开 src/main/resources/application.yml 文件，根据实际情况修改数据库连接的 URL、用户名和密码。

7. 修改后台路径

   在同一配置文件中，找到并修改 jeesns: managePath 的值，例如设置为 manage。

8. 安装本地依赖

   如果项目中包含本地依赖（如 jeesns-core-1.4.jar），将其放置到硬盘的某个位置，并使用以下命令将其安装到本地 Maven 仓库：

   mvn install:install-file -Dfile=[路径]\jeesns-core.jar -DgroupId=cn.jeesns -DartifactId=jeesns-core -Dversion=2.0.0 -Dpackaging=jar
   

9. 编译项目

   在 IDE 中，右键点击项目名，选择 Run as -> Maven build...，在 Goals 中填入 clean package 并运行。

10. 部署项目

    在 jeesns-web 模块下，根据项目类型选择合适的方式部署（如 Tomcat 部署）。

11. 访问系统

    项目部署成功后，通过浏览器访问 http://localhost:8870/，使用默认的用户名 admin 和密码 jeesns 登录系统，然后在右上角点击 管理 进入后台管理界面。

完成以上步骤后，您应该能够成功安装和配置 jeesns 项目，并开始开发您自己的社交管理系统。