|
对于最新的稳定版本，请使用 Spring Boot 3.5.5！ |
安装 Spring Boot 应用程序
除了使用java -jar直接，也可以将它们运行为systemd,init.d或 Windows 服务。
安装为 systemd 服务
systemd是 System V init 系统的后继者，现在被许多现代 Linux 发行版使用。
Spring Boot 应用程序可以通过使用systemd'service' 脚本。
假设您有一个 Spring Boot 应用程序打包为 uber jar/var/myapp，将其安装为systemd服务，创建一个名为myapp.service并将其放入/etc/systemd/system目录。
以下脚本提供了一个示例：
[Unit]
Description=myapp
After=syslog.target network.target
[Service]
User=myapp
Group=myapp
Type=exec
ExecStart=/path/to/java/home/bin/java -jar /var/myapp/myapp.jar
WorkingDirectory=/var/myapp
SuccessExitStatus=143
[Install]
WantedBy=multi-user.target记得将Description,User,Group,ExecStart和WorkingDirectory字段。 |
这ExecStart字段未声明脚本作命令，这意味着run默认使用命令。 |
运行应用程序的用户、PID 文件和控制台日志文件由systemd本身，因此必须使用“服务”脚本中的相应字段进行配置。
有关更多详细信息，请参阅服务单元配置手册页。
要将应用程序标记为在系统启动时自动启动，请使用以下命令：
$ systemctl enable myapp.service执行man systemctl了解更多详情。
作为 init.d 服务安装 （System V）
将应用程序用作init.d服务，配置其构建以生成完全可执行的 jar。
完全可执行的 jar 通过在文件前面嵌入一个额外的脚本来工作。
目前，某些工具不接受此格式，因此您可能并不总是能够使用此技术。
例如jar -xf可能无法静默地提取已完全可执行的 jar 或 war。
建议您仅在打算直接执行 jar 或 war 时才使它完全可执行，而不是使用java -jar或将其部署到 servlet 容器。 |
zip64 格式的 jar 文件不能完全可执行。
尝试这样做将导致一个 jar 文件在直接执行或使用java -jar.
包含一个或多个 zip64 格式嵌套 jar 的标准格式 jar 文件可以完全可执行。 |
要使用 Maven 创建“完全可执行”的 jar，请使用以下插件配置：
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<executable>true</executable>
</configuration>
</plugin>以下示例显示了等效的 Gradle 配置：
tasks.named('bootJar') {
launchScript()
}然后可以将其符号链接到init.d支持标准start,stop,restart和status命令。
添加到完全可执行的 jar 中的默认启动脚本支持大多数 Linux 发行版，并在 CentOS 和 Ubuntu 上进行了测试。 其他平台，例如 OS X 和 FreeBSD，需要使用自定义脚本。 默认脚本支持以下功能：
-
以拥有 jar 文件的用户身份启动服务
-
使用
/var/run/<appname>/<appname>.pid -
将控制台日志写入
/var/log/<appname>.log
假设您在/var/myapp，将 Spring Boot 应用程序安装为init.d服务中，创建一个符号链接，如下所示：
$ sudo ln -s /var/myapp/myapp.jar /etc/init.d/myapp安装后，您可以以通常的方式启动和停止服务。 例如，在基于 Debian 的系统上，您可以使用以下命令启动它：
$ service myapp start如果应用程序无法启动，请检查写入/var/log/<appname>.log对于错误。 |
还可以使用标准作系统工具将应用程序标记为自动启动。 例如，在 Debian 上，您可以使用以下命令：
$ update-rc.d myapp defaults <priority>保护 init.d 服务
| 以下是有关如何保护作为 init.d 服务运行的 Spring Boot 应用程序的一组指南。 它并不是为强化应用程序及其运行环境而应执行的所有作的详尽列表。 |
当以 root 身份执行时，就像使用 root 启动 init.d 服务时一样，默认可执行脚本以RUN_AS_USER环境变量。
如果未设置环境变量，则改用拥有 jar 文件的用户。
您永远不应该将 Spring Boot 应用程序作为root所以RUN_AS_USER永远不应该是 root，并且应用程序的 jar 文件永远不应该由 root 拥有。
相反，请创建一个特定用户来运行您的应用程序，并将RUN_AS_USER环境变量或使用chown使其成为 jar 文件的所有者，如以下示例所示：
$ chown bootapp:bootapp your-app.jar在这种情况下，默认可执行脚本将应用程序作为bootapp用户。
为了减少应用程序用户帐户被泄露的机会，您应该考虑阻止它使用登录 shell。
例如，您可以将帐户的 shell 设置为/usr/sbin/nologin. |
您还应该采取措施防止修改应用程序的 jar 文件。 首先，配置其权限，使其无法写入，只能由其所有者读取或执行，如以下示例所示：
$ chmod 500 your-app.jar其次，如果您的应用程序或运行它的帐户受到损害，您还应该采取措施限制损害。
如果攻击者确实获得了访问权限，他们可以使 jar 文件可写并更改其内容。
防止这种情况的一种方法是使用chattr，如以下示例所示：
$ sudo chattr +i your-app.jar这将防止任何用户（包括 root）修改 jar。
如果 root 用于控制应用程序的服务，并且您使用.conf文件要自定义其启动，请使用.conf文件由 root 用户读取和评估。
应相应地保护它。
用chmod这样文件只能由所有者读取并使用chown将 root 设为所有者，如以下示例所示：
$ chmod 400 your-app.conf
$ sudo chown root:root your-app.conf自定义启动脚本
Maven 或 Gradle 插件编写的默认嵌入式启动脚本可以通过多种方式进行自定义。
对于大多数人来说，使用默认脚本和一些自定义通常就足够了。
如果您发现无法自定义所需的内容，请使用embeddedLaunchScript完全编写您自己的文件的选项。
在编写启动脚本时自定义它
在将启动脚本写入 jar 文件时自定义其元素通常是有意义的。 例如，init.d 脚本可以提供“描述”。 由于您预先知道描述（并且不需要更改），因此您不妨在生成 jar 时提供它。
要自定义书面元素，请使用embeddedLaunchScriptPropertiesSpring Boot Maven 插件的选项或propertiesSpring Boot Gradle 插件的属性launchScript.
默认脚本支持以下属性替换：
| 名称 | 描述 | Gradle 默认值 | Maven 默认值 |
|---|---|---|---|
|
脚本模式。 |
|
|
|
这 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
单行版本 |
|
|
|
|
|
|
|
|
|
|
的默认值 |
包含 jar 的文件夹 |
包含 jar 的文件夹 |
|
引用应在默认启动脚本中内联的文件脚本。
这可用于设置环境变量，例如 |
||
|
默认值 |
||
|
默认值 |
||
|
默认值 |
||
|
PID 文件名称的默认值 |
||
|
无论 |
|
|
|
默认值 |
60 |
60 |
在脚本运行时自定义脚本
对于编写 jar 后需要自定义的脚本项，可以使用环境变量或配置文件。
默认脚本支持以下环境属性：
| 变量 | 描述 |
|---|---|
|
作的“模式”。
默认值取决于 jar 的构建方式，但通常是 |
|
将用于运行应用程序的用户。 如果未设置，则将使用拥有 jar 文件的用户。 |
|
无论 |
|
pid 文件夹的根名称 （ |
|
用于放置日志文件的文件夹的名称 （ |
|
从中读取 .conf 文件的文件夹的名称（默认情况下与 jar-file 相同的文件夹）。 |
|
日志文件的名称 |
|
应用的名称。 如果 jar 是从符号链接运行的，则脚本会猜测应用程序名称。 如果它不是符号链接，或者您想要显式设置应用程序名称，这可能会很有用。 |
|
要传递给程序（Spring Boot 应用程序）的参数。 |
|
的位置 |
|
启动 JVM 时传递给 JVM 的选项。 |
|
jar 文件的显式位置，如果脚本用于启动实际未嵌入的 jar。 |
|
如果不为空，则将 |
|
在强制关闭之前停止应用程序时等待的时间（以秒为单位）（ |
这PID_FOLDER,LOG_FOLDER和LOG_FILENAME变量仅对init.d服务。 为systemd，则使用“service”脚本进行等效的自定义。有关更多详细信息，请参阅服务单元配置手册页。 |
使用 conf 文件
但JARFILE和APP_NAME，则可以使用.conf文件。
该文件应位于 jar 文件旁边，并且名称相同，但后缀为.conf而不是.jar.
例如，名为/var/myapp/myapp.jar使用名为/var/myapp/myapp.conf，如以下示例所示：
JAVA_OPTS=-Xmx1024M
LOG_FOLDER=/custom/log/folder如果您不喜欢将配置文件放在 jar 文件旁边，您可以将CONF_FOLDERenvironment 变量来自定义配置文件的位置。 |
要了解如何适当地保护此文件，请参阅保护 init.d 服务的指南。