【博客系统】博客系统第十一弹：部署博客系统项目到 Linux 系统

---

搭建 Java 部署环境

---

apt

---

apt（Advanced Packaging Tool）是 Linux 软件包管理工具，用于在 Ubuntu、Debian 和相关 Linux 发行版上安装、更新、删除和管理 deb 软件包。

大多数 apt 命令必须以具有 sudo 权限的用户身份运行。

---

apt 常用命令

---

列出所有软件包

apt list

这个命令输出所有包的列表，内容比较多，可以使用 grep 命令过滤输出。

apt list | grep "java"

---

更新软件包数据库

sudo apt-get update

apt 实际上在可用软件包的数据库上工作。如果数据库没有更新，系统将不知道是否有更新的软件包可用。这就是为什么在安装任何 Linux 系统之后，第一件事应该是更新 apt 数据库。运行此命令时，将看到从各种服务器检索到的软件包信息。

如果切换到 root 用户，命令前就不需要加 sudo 了。

---

切换 root 用户

sudo su

---

安装软件包

sudo apt install package_name

---

移除软件包

sudo apt remove package_name

remove 命令将卸载给定的软件包，但可能会留下一些配置文件。如果要删除包含所有配置文件的软件包，请使用 purge 而不是 remove。

---

apt remove 和 apt purge 的区别

---

• apt remove 删除包的二进制文件，它留下了残留的配置文件。
• apt purge 删除与包相关的所有内容，包括配置文件。
• 如果弄乱了程序的配置，希望从系统中完全清除它的痕迹再重新开始，可以使用 apt purge。
• 通常使用 apt remove 就足够了。

---

JDK

---

1. 更新软件包

sudo apt-get update

---

2. 安装 OpenJDK

查找 JDK 包

apt list | grep "jdk"

安装 JDK

sudo apt install openjdk-17-jdk

注意：

• 此处安装的是 OpenJDK，OpenJDK 是一个开源版本的 JDK，和 Oracle 官方的 JDK 略有差别。此处我们就使用 OpenJDK 即可。安装 Oracle JDK 比较麻烦。
• 使用 java -version 验证是否安装成功。
• 如果提示 “java 命令找不到” 则说明安装失败。

---

3. 卸载 OpenJDK

---

1. 检查安装的是哪个 OpenJDK

   dpkg --list | grep -i jdk
   

2. 移除 OpenJDK 包

   apt-get purge openjdk*
   

3. 卸载 OpenJDK 相关包

   apt-get purge icedtea-* openjdk-*
   

4. 检查所有 OpenJDK 包是否都已卸载完毕

   dpkg --list | grep -i jdk
   

---

MySQL

---

使用 apt 安装 MySQL

---

1. 查找安装包

   apt list | grep "mysql-server"
   

2. 安装 MySQL

   sudo apt install mysql-server
   

---

查看 MySQL 状态

---

sudo systemctl status mysql

---

MySQL 安装安全设置

---

默认的 MySQL 设置是不安全的，MySQL 安装提供了一个安全脚本，用于解决不太安全的默认选项。

---

运行以下命令：

sudo mysql_secure_installation #安装安全设置

---

执行过程：

1. 是否设置验证密码组件：

   Press y|Y for Yes, any other key for No: Y #是否设置验证密码组件
   

2. 密码强度设置：

   Please enter 0 = LOW, 1 = MEDIUM and 2 = STRONG: 2 #设置密码强度
   

3. 删除匿名用户：

   Remove anonymous users? (Press y|Y for Yes, any other key for No) : Y #默认情况下，MySQL安装有一个匿名用户, 允许任何人登录MySQL. 是否删除匿名用户？
   

4. 禁止 root 用户远程登录：

   Disallow root login remotely? (Press y|Y for Yes, any other key for No) : Y #仅应允许root从'localhost'连接
   

5. 删除 test 数据库：

   Remove test database and access to it? (Press y|Y for Yes, any other key for No) : Y #默认情况下, MySQL带有⼀个test数据库, 是否删除?
   

6. 重新加载权限表：

   Reload privilege tables now? (Press y|Y for Yes, any other key for No) : Y #是否现在加载配置, 使刚才的修改生效?
   

7. 完成：

   All done!
   

---

通过以上步骤，MySQL 的安全设置已经完成，确保了数据库的安全性。设置密码

---

连接 MySQL 服务器

---

sudo mysql

---

使用 ALTER USER 命令修改密码

---

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'BITE@yyds.666';

---

退出 MySQL

---

exit

---

再次登录输入：

mysql -uroot -p   #  密码: BITE@yyds.666

---

卸载 MySQL

---

1. 停止 MySQL

sudo systemctl stop mysql

---

2. 卸载 MySQL

sudo apt-get remove --purge mysql-server mysql-client mysql-common

---

3. 删除 MySQL 配置文件和数据

sudo rm -rf /etc/mysql /var/lib/mysql

---

4. 清理残留文件和目录

sudo apt-get autoremove
sudo apt-get autoclean

---

5. 验证卸载结果

mysql --version

---

部署 Web 项目到 Linux

---

环境配置

---

确保程序正常运行需完成以下配置：

1. 数据库准备

   • 执行提供的建表脚本，确保表结构与服务器一致

2. 多环境配置

   • 按环境创建配置文件（如开发/测试/生产环境）
   • 命名格式：application-XXX.yml 或 application-XXX.properties
   • 差异化配置项示例：MySQL账号密码、服务端口等

关键点：通过文件命名区分环境，避免硬编码敏感信息。

---

以下以application-XXX.yml为例：

application-dev.yml: 开发环境配置

server:port: 8080spring:datasource:url: jdbc:mysql://127.0.0.1:3306/java_blog_spring?characterEncoding=utf8&useSSL=falseusername: rootpassword: 123456  # windows 数据库密码driver-class-name: com.mysql.cj.jdbc.Drivermybatis-plus:configuration:map-underscore-to-camel-case: true
#      log-impl: org.apache.ibatis.logging.stdout.StdOutImpl   # linux 服务器没必要打日志, 打日志也会影响性能logging:file:name: spring-blog.log

---

application-prod.yml: 生产环境配置：

server:port: 8080spring:datasource:url: jdbc:mysql://127.0.0.1:3306/java_blog_spring?characterEncoding=utf8&useSSL=falseusername: rootpassword: BITE@yyds.666 # linux 数据库密码driver-class-name: com.mysql.cj.jdbc.Drivermybatis-plus:configuration:map-underscore-to-camel-case: true
#      log-impl: org.apache.ibatis.logging.stdout.StdOutImpl   logging:file:name: spring-blog.log

---

如果同时有三个yml文件，通常只有主配置文件application.yml会自动生效。为了使其他配置文件（如application-prod.yml或application-dev.yml）生效，需要在主配置文件application.yml中进行相应的配置。具体步骤如下：

1. 删除主配置文件中的数据库相关配置： 在application.yml中删除与数据库相关的配置项，以避免冲突。
2. 指定生效的配置文件： 在application.yml中添加配置，指定使用application-prod.yml或application-dev.yml作为生效的配置文件。

spring:profiles:active: prodspring:profiles:active: dev

在Spring框架中，spring.profiles.active属性用于指定激活的配置文件。

这里的active属性值填的是配置文件名的一部分（如dev、prod等），而不是完整的文件名（如application-prod.yml或application-dev.yml）。

---

启动程序：

---

测试接口：

---

当前配置文件中的数据库密码是按照 Linux 系统的设置来配置的，与 Windows 系统的数据库密码不一致，从而导致接口访问失败：

---

在不同环境之间来回切换时，需要频繁修改配置文件中的active值。在多人协作的场景下，很容易出现忘记修改active值的情况，从而导致配置错误。

为了避免这种情况，我们可以通过从 Maven 中读取环境配置变量来为active赋值：

<profiles><profile><id>dev</id><properties><profile.name>dev</profile.name></properties></profile><profile><id>prod</id><activation><activeByDefault>true</activeByDefault></activation><properties><profile.name>prod</profile.name></properties></profile>
</profiles>

注意，每次勾选新的 profile 都需要刷新 maven

---

修改 application.yml

spring:profiles:active: @profile.name@

---

勾选好 profile 后，刷新 maven，重新运行程序：

---

测试接口，此时接口访问成功：

---

构建项目并打包

---

在本地使用 Maven 进行打包：

1. 如果 Test 代码中有与环境配置相关的操作（比如数据库相关的操作），打包会失败，可以跳过测试。
2. 点击 clean -> package。

---

上传 Jar 包到服务器并运行

---

1. 上传 Jar 包

---

将 dev 切换成 prod，刷新 maven 并打包：

---

因为这个项目使用的是 mybatis-plus ，所以不需要写 mybatis 的测试用例，所以打包成功：

• 如果使用的是 MyBatis 而非 MyBatis-Plus，就需要在单元测试中编写 MyBatis 的接口测试代码。

• 在 Maven 的配置文件中，如果选择了prod环境配置并刷新了 Maven，然后按照生命周期的package命令进行打包，那么 Maven 会依次执行clean、validate、compile、test、package阶段：

• 在 Maven 的 test 阶段运行单元测试时，由于配置的数据库密码与 Windows 系统的数据库密码不一致，导致 MyBatis 无法连接到数据库，从而使得单元测试失败。

• 单元测试失败会中断 Maven 的打包过程，导致打包失败。

• 解决方案：在打包前，设置去掉 test 阶段，避免打包过程因为 test 的问题导致打包过程被打断：

接下来，找到打好的 Jar 包：

---

在 linux 系统中，创建和 windows 对应数据库及数据表

-- 建表 SQL
create database if not exists java_blog_spring charset utf8mb4;use java_blog_spring;-- 用户表
DROP TABLE IF EXISTS java_blog_spring.user_info;
CREATE TABLE java_blog_spring.user_info(
`id` INT NOT NULL AUTO_INCREMENT,
`user_name` VARCHAR (128) NOT NULL,
`password` VARCHAR (128) NOT NULL,
`github_url` VARCHAR (128) NULL,
`delete_flag` TINYINT (4) NULL DEFAULT 0,
`create_time` DATETIME DEFAULT now(),
`update_time` DATETIME DEFAULT now() ON UPDATE now(),
PRIMARY KEY (id),
UNIQUE INDEX user_name_UNIQUE (user_name ASC)) ENGINE = INNODB DEFAULT CHARACTER SET = utf8mb4 COMMENT = '用户表';-- 博客表
drop table if exists java_blog_spring.blog_info;
CREATE TABLE java_blog_spring.blog_info (
`id` INT NOT NULL AUTO_INCREMENT,
`title` VARCHAR(200) NULL,
`content` TEXT NULL,
`user_id` INT(11) NULL,
`delete_flag` TINYINT(4) NULL DEFAULT 0,
`create_time` DATETIME DEFAULT now(),
`update_time` DATETIME DEFAULT now() ON UPDATE now(),
PRIMARY KEY (id))
ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = '博客表';-- 新增用户信息
insert into java_blog_spring.user_info (user_name, password, github_url) values("zhangsan", "123456", "https://gitee.com/bubblefish666/class-java45");
insert into java_blog_spring.user_info (user_name, password, github_url) values("lisi", "123456", "https://gitee.com/bubblefish666/class-java45");insert into java_blog_spring.blog_info (title, content, user_id) values("第一篇博客", "111我是博客正文我是博客正文我是博客正文", 1);
insert into java_blog_spring.blog_info (title, content, user_id) values("第二篇博客", "222我是博客正文我是博客正文我是博客正文", 2);

---

为了能通过加密、加盐功能的密码校验，更新 linux 数据库表中，用户的密码：

update user_info set password= 'e5bf3de57e3243ab9d94b59b379a0a640f967f2e3ae738c2f5474ab0fe46389b' where id in(1,2);

---

直接拖动打好的 Jar 包到 Xshell 窗口即可完成文件的上传。

Xshell 可以直接拖动文件到窗口，达到上传文件的目的。如果使用其他客户端，不支持文件的上传，需要借助 lrzsz 命令；

---

借助 mv 改一下 jar 包名：

---

2. 运行程序

---

接下来，在 linux 上运行该 jar 包：

java -jar blog.jar

这种部署方式，如果按 ctrl+c ，那么部署好的服务就无法被服务了；正确的启动命令：

nohup java -jar blog.jar &

• nohup：后台运行程序。用于在系统后台不挂断地运行命令，退出终端不会影响程序的运行。

• 语法格式：

  nohup Command [Arg …] [&]
  

• 参数说明：

  • Command：要执行的命令。
  • Arg：一些参数，可以指定输出文件。
  • &：让命令在后台执行，终端退出后命令仍旧执行。

• 示例：

  nohup java -jar blog-0.0.1-SNAPSHOT.jar >/logs &
  

• Linux 可以通过 > 把需要输出的内容写到指定文件中。这样的操作称为“重定向”。

---

开放端口号

---

如果外网需要访问该服务，需要先服务器防火墙开放对应的端口号。

本着服务器安全的原则，云服务器上的端口非必要不开启。比如常见端口号：数据库 3306、Redis 6379，尽可能避免开放，而是采用其他方式来连接，比如配置隧道的方式。

---

---

确保列表中有添加的规则：

---

验证程序

---

1. 访问项目：http://IP:Port/blog_login.html
   • 将 IP 改为云服务器的 IP，Port 改为项目的端口号。
2. 按照项目功能进行验证：
   • 验证账号注册登录。
   • 验证展示博客列表。
   • 验证博客编辑功能
   • 验证新增博客。
   • 验证展示博客内容。
   • …

---

常见问题

---

一个程序的正常运行，需要程序的正确和环境的正确。同样的代码在 Windows 上可以运行成功，不一定在 Linux 上运行成功。不同的系统对代码的理解和支持是不同的。比如 Windows 系统对 MySQL 不区分大小写，Linux 区分大小写。

服务不能正常访问的原因有很多，主要分以下几个方面：

1. 服务未启动

   • 使用 ps -ef | grep java 查看程序是否在运行。
   • 使用 curl http://127.0.0.1:8080/blog_login.html 看下是否有返回 HTML 页面。如果有返回，说明程序启动成功了，考虑端口未开放。
   • 如果未启动成功，需要查看对应的日志，根据原因来分析：
     • 数据库不存在。
     • 表不存在（区分大小写）。
     • 数据库密码不正确。
     • JDK 安装版本不对，或者未安装。
     • MySQL 未设置密码。
     • …

2. HTTP 端口未开放

   • 检查云服务器防火墙/安全组是否开放相应端口（如 8080）。

杀掉进程

如果我们需要重启服务，或者重新部署等，都需要先停止之前的服务。

1. 查看当前服务的进程

   ps -ef | grep java
   

   上图中的 35443 就是该服务的进程。

2. 杀掉进程

   kill -9 PID
   

---