Linux怎么把SpringBoot打包的Jar注册为系统服务

秋瑶吖_4264

秋瑶吖_4264

2026-09-30

779人浏览

原创

应使用 systemd 注册 spring boot 应用,需在 pom.xml 中配置 true 使 jar 可执行,配合 /etc/systemd/system/your-app.service 文件(含 user、execstart、successexitstatus=143 等关键项),并执行 daemon-reload、enable、start;日志统一用 journalctl 查看。

linux怎么把springboot打包的jar注册为系统服务

直接用 systemd 注册,别碰 init.d 或手动写 shell 脚本启动——CentOS 7+ / Ubuntu 16.04+ 都默认用 systemd,它原生支持进程守护、日志聚合、依赖管理、优雅重启,而其他方式要么过时,要么要自己补一堆逻辑。

打包时必须加 <executable>true</executable>

不加这个,.jar 文件只是普通可运行包,不是 Linux 可执行文件,systemd 无法直接调用(会报 Failed at step EXEC spawning)。在 pom.xml 的 spring-boot-maven-plugin 配置里确认有:

<configuration><executable>true</executable></configuration>
  • 打包后用 file your-app.jar 检查:输出应含 ELF 64-bit LSB executable,不是 Java archive data
  • 如果没生效,清掉 target/ 重跑 mvn clean package
  • 不加 executable 也能硬配 ExecStart=/usr/bin/java -jar ...,但会丢失 systemd 对 Java 进程的原生信号转发(比如 SIGTERM 无法触发 Spring Boot 的优雅停机)

your-app.service 文件里最关键的三行

放在 /etc/systemd/system/your-app.service,内容精简到只留核心项:

Computer Use Linux
Computer Use Linux

顶级 Linux 计算机使用技能,配套独立自举运行时,无需本地 Claude 安装、私有原生模块等。

下载
[Unit]
Description=My Spring Boot App
After=network.target

[Service]
Type=simple
User=appuser
WorkingDirectory=/opt/myapp
ExecStart=/opt/myapp/myapp.jar
SuccessExitStatus=143
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
  • User=appuser:绝不能用 root。提前建用户:sudo useradd --shell /bin/false --home-dir /opt/myapp appuser,再 sudo chown -R appuser:appuser /opt/myapp
  • ExecStart=/opt/myapp/myapp.jar:路径必须是绝对路径,且该文件要有 +x 权限(chmod +x myapp.jar)
  • SuccessExitStatus=143:Spring Boot 收到 SIGTERM 后正常退出码是 143,加这行能让 systemd 不把它当崩溃处理;否则每次 stop 都触发 Restart

启动前必须 reload,且日志别乱 redirect

改完 .service 文件不 daemon-reload,systemctl 就读不到新配置;自己加 > /var/log/app.log 2>&1 会绕过 journald,丢掉时间戳、优先级、unit 标识等关键上下文。

  • 执行顺序固定:sudo systemctl daemon-reload && sudo systemctl enable your-app && sudo systemctl start your-app
  • 查日志统一用:journalctl -u your-app -f(实时)、journalctl -u your-app --since "2 hours ago"(按时间查)
  • 如果非要落盘日志,用 systemd 原生方式:StandardOutput=append:/var/log/your-app.log,但会失去结构化查询能力
  • 首次启动失败?先 sudo systemctl status your-app 看最后一屏错误,再 journalctl -u your-app -n 50 翻前 50 行

真正容易被忽略的是权限和信号链路:jar 文件属主不对,User 字段就形同虚设;没配 SuccessExitStatus,systemctl stop 会立刻触发重启,你以为服务“停不掉”,其实是它被当成异常崩溃了。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2251

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

437

25

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

2023.06.21

3730

4

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

2023.06.29

3233

10

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2023.06.30

2313

5

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

2023.07.05

5590

7

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

2023.07.06

5242

7

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.20

3113

8

linux查看ip命令
linux查看ip命令

本专题为大家提供linux查看ip命令相关文章内容,感兴趣的朋友可以免费下载体验试试。

2023.07.20

2625

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习