【博客系统】博客系统第十一弹：部署博客系统项目到 Linux 系统-海口c网

在这里插入图片描述

搭建 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

检查安装的是哪个 OpenJDK
```
dpkg --list | grep -i jdk
```
移除 OpenJDK 包
```
apt-get purge openjdk*
```
卸载 OpenJDK 相关包
```
apt-get purge icedtea-* openjdk-*
```
检查所有 OpenJDK 包是否都已卸载完毕
```
dpkg --list | grep -i jdk
```

MySQL

使用 apt 安装 MySQL

查找安装包
```
apt list | grep "mysql-server"
```
安装 MySQL
```
sudo apt install mysql-server
```

查看 MySQL 状态

sudo systemctl status mysql

MySQL 安装安全设置

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

运行以下命令：

sudo mysql_secure_installation #安装安全设置

执行过程：

是否设置验证密码组件：

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

密码强度设置：

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

删除匿名用户：

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

禁止 root 用户远程登录：

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

删除 test 数据库：

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

重新加载权限表：

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

完成：
```
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

停止 MySQL

sudo systemctl stop mysql

卸载 MySQL

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

删除 MySQL 配置文件和数据

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

sudo apt-get autoremove
sudo apt-get autoclean

验证卸载结果

mysql --version

部署 Web 项目到 Linux

环境配置

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

数据库准备
- 执行提供的建表脚本，确保表结构与服务器一致
多环境配置
- 按环境创建配置文件（如开发/测试/生产环境）
- 命名格式：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中进行相应的配置。具体步骤如下：

删除主配置文件中的数据库相关配置：在application.yml中删除与数据库相关的配置项，以避免冲突。
指定生效的配置文件：在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 进行打包：

如果 Test 代码中有与环境配置相关的操作（比如数据库相关的操作），打包会失败，可以跳过测试。
点击 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，尽可能避免开放，而是采用其他方式来连接，比如配置隧道的方式。

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

验证程序

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

常见问题

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

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

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