SpringBoot項目Jar包使用systemctl運行過程

更新時間：2025年03月24日 09:59:02 作者：太自由

這篇文章主要介紹了SpringBoot項目Jar包使用systemctl運行過程,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教

1. 前言

SpringBoot項目打成jar包后，可以直接使用 java -jar xxx.jar 啟動。但是為了方便啟動和停止服務，通常我們會寫兩個腳本，分別是啟動腳本 start.sh 和停止腳本 shutdown.sh（這兩個腳本內容我們下文會實現(xiàn)）；

再進一步的做法是可以把我們的服務添加成系統(tǒng)服務，使用systemctl 進行管理，就像使用 systemctl status firewalld.service 一樣。

2. 創(chuàng)建SpringBoot項目并生成jar包

為了演示，先創(chuàng)建一個最普通的SpringBoot項目，在項目中使用 SLFJ + Logback記錄日志。

項目目錄結構如下。

3. 使用 java -jar 命令在服務器上運行

3.1 前臺運行

前臺運行，直接在jar包所在目錄執(zhí)行 java -jar xxx.jar 就可以了，如下所示：

3.2 后臺運行（帶nohup.out日志）

通常我們是讓服務在后臺運行，可以使用 nohup java -jar xxx.jar & 運行jar包，如下：

這種直接使用 nohup java -jar xxx.jar & 運行jar包會產生一個 nohup.out日志文件，在項目運行過程中的日志都會追加到這個文件中，時間長了這個文件就會非常大，容易打滿磁盤，浪費硬盤存儲空間。

3.3 后臺運行（不帶nohup.out日志）

因為我們的項目通常集成了 SLFJ + Logback 進行日志記錄，所以不需要生成這個文件，可以使用如下命令運行jar包。

nohup java -jar xxx.jar >/dev/null 2>&1 &

4. 使用腳本實現(xiàn)啟動和停止jar包

每次使用 nohup java -jar xxx.jar >/dev/null 2>&1 & 運行項目太麻煩，并且在關閉服務時，還要先找到這個服務的進程號，然后才能關閉。

所以可以把啟動項目和關閉項目寫成腳本，每次只要執(zhí)行腳本就可以了。

4.1 啟動服務腳本

啟動服務腳本如下：

#!/bin/bash
pid=$(pgrep -f 你的jar包名稱.jar)
if [ -z $pid ];then
    nohup java -jar 你的jar包名稱.jar >/dev/null 2>&1 &
else
    echo "你的jar包名稱.jar is already running [pid is $pid]" 
fi

比如我的啟動腳本如下：

啟動項目的過程如下：

4.2 停止服務腳本

停止服務腳本如下：

#!/bin/bash
pid=$(pgrep -f 你的jar名字.jar)
echo $pid
if [ -z $pid ];then
    echo "你的jar名字.jar is not running"
else
    kill -15 $pid
fi

比如我的停止服務腳本如下：

執(zhí)行停止服務腳本過程如下：

5. 使用systemctl 命令管理jar包的啟動和停止

5.1 添加到系統(tǒng)服務

（1）寫一個服務腳本，名稱以 .service結尾【我寫的是 demo-service.service，其內容如下，你可以參照下面的寫法，修改成你自己的】

[Unit]
Description=demo-service
After=syslog.target network.target remote-fs.target nss-lookup.target

[Service]
Type=simple
User=root
Group=root
WorkingDirectory=/opt/myJar/run_jar
ExecStart=/opt/software/jdk/jdk8/jdk1.8.0_221/bin/java -jar /opt/myJar/run_jar/demo-project-1-1.0-SNAPSHOT.jar
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s QUIT $MAINPID
PrivateTmp=true

[Install]
WantedBy=multi-user.target

（2）把此文件，即demo-service.service 放到 /usr/lib/systemd/system/ 目錄下

（3）執(zhí)行 systemctl daemon-reload 命令