64. 安装 Spring Boot 应用程序

除了使用java -jar运行 Spring Boot 应用程序外，还可以为 Unix 系统制作完全可执行的应用程序。完全可执行的 jar 可以像其他任何可执行二进制文件一样执行，也可以是在 init.d 或 systemd 中注册。这使得在普通生产环境中安装和 Management Spring Boot 应用程序变得非常容易。

要使用 Maven 创建一个“完全可执行”的 jar，请使用以下插件配置：

<plugin>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-maven-plugin</artifactId>
	<configuration>
		<executable>true</executable>
	</configuration>
</plugin>

以下示例显示了等效的 Gradle 配置：

bootJar {
	launchScript()
}

然后，您可以通过键入./my-application.jar(其中my-application是工件的名称)来运行您的应用程序。包含 jar 的目录用作应用程序的工作目录。

64.1 支持的 os

默认脚本支持大多数 Linux 发行版，并已在 CentOS 和 Ubuntu 上进行了测试。其他平台，例如 OS X 和 FreeBSD，则需要使用自定义的embeddedLaunchScript。

64.2 Unix/Linux 服务

使用init.d或systemd可以轻松地将 Spring Boot 应用程序作为 Unix/Linux 服务启动。

64.2.1 作为 init.d 服务安装(系统 V)

如果您将 Spring Boot 的 Maven 或 Gradle 插件配置为生成完全可执行的 jar，而不使用自定义embeddedLaunchScript，则您的应用程序可以用作init.d服务。为此，请将 jar 链接到init.d以支持标准start，stop，restart和status命令。

该脚本支持以下功能：

• 以拥有 jar 文件的用户身份启动服务

• 使用/var/run/<appname>/<appname>.pid跟踪应用程序的 PID

• 将控制台日志写入/var/log/<appname>.log

假设您已在/var/myapp中安装了 Spring Boot 应用程序，要将 Spring Boot 应用程序安装为init.d服务，请创建一个符号链接，如下所示：

$ sudo ln -s /var/myapp/myapp.jar /etc/init.d/myapp

安装后，您可以按照通常的方式启动和停止服务。例如，在基于 Debian 的系统上，可以使用以下命令启动它：

$ service myapp start

您还可以使用标准 os 工具将应用程序标记为自动启动。例如，在 Debian 上，您可以使用以下命令：

$ update-rc.d myapp defaults <priority>

保护 init.d 服务

当以 root 身份执行时(例如使用 root 来启动 init.d 服务时)，默认的可执行脚本以拥有 jar 文件的用户身份运行应用程序。您永远不要以root的身份运行 Spring Boot 应用程序，因此您的应用程序的 jar 文件绝对不应由 root 拥有。而是创建一个特定用户来运行您的应用程序，并使用chown使其成为 jar 文件的所有者，如以下示例所示：

$ chown bootapp:bootapp your-app.jar

在这种情况下，默认的可执行脚本以bootapp用户身份运行该应用程序。

您还应该采取步骤来防止修改应用程序的 jar 文件。首先，配置其权限，使其不能被写入，只能由其所有者读取或执行，如以下示例所示：

$ chmod 500 your-app.jar

其次，如果您的应用程序或运行该应用程序的帐户受到威胁，您还应采取措施限制损害。如果攻击者确实获得了访问权限，则他们可以使 jar 文件可写并更改其内容。防止这种情况发生的一种方法是使用chattr使其不变，如以下示例所示：

$ sudo chattr +i your-app.jar

这将阻止任何用户(包括 root 用户)修改 jar。

如果使用 root 来控制应用程序的服务，并且您使用.conf 文件自定义其启动，则 root 用户将读取并评估.conf文件。应该相应地对其进行保护。使用chmod，以便只有所有者可以读取文件，并使用chown将 root 成为所有者，如以下示例所示：

$ chmod 400 your-app.conf
$ sudo chown root:root your-app.conf

64.2.2 作为系统服务安装

systemd是 System V init 系统的后继产品，现已被许多现代 Linux 发行版使用。尽管您可以 continue 将_脚本与systemd一起使用，但是也可以通过使用systemd'service'脚本来启动 Spring Boot 应用程序。

假设您已在/var/myapp中安装了 Spring Boot 应用程序，要将 Spring Boot 应用程序安装为systemd服务，请创建名为myapp.service的脚本并将其放置在/etc/systemd/system目录中。以下脚本提供了一个示例：

[Unit]
Description=myapp
After=syslog.target

[Service]
User=myapp
ExecStart=/var/myapp/myapp.jar
SuccessExitStatus=143

[Install]
WantedBy=multi-user.target

请注意，与作为init.d服务运行时不同，运行应用程序，PID 文件和控制台日志文件的用户由systemd本身 Management，因此必须通过在“服务”脚本中使用适当的字段进行配置。有关更多详细信息，请咨询服务单元配置手册页。

要将应用程序标记为在系统启动时自动启动，请使用以下命令：

$ systemctl enable myapp.service

有关更多详细信息，请参考man systemctl。

64.2.3 自定义启动脚本

由 Maven 或 Gradle 插件编写的默认嵌入式启动脚本可以通过多种方式进行自定义。对于大多数人来说，使用默认脚本和一些自定义设置通常就足够了。如果发现无法自定义所需的内容，请使用embeddedLaunchScript选项完全编写自己的文件。

编写后自定义启动脚本

在将启动脚本写入 jar 文件时，自定义启动脚本的元素通常很有意义。例如，init.d 脚本可以提供“描述”。由于您已经预先了解了描述(并且无需更改)，因此在生成 jar 时也可以提供它。

要自定义书面元素，请使用 Spring Boot Maven 插件的embeddedLaunchScriptProperties选项或Spring Boot Gradle 插件的 launchScript 的 properties 属性。

默认脚本支持以下属性替换：

运行时自定义脚本

对于在编写 jar 之后需要自定义脚本的项目，可以使用环境变量或config file。

默认脚本支持以下环境属性：

除JARFILE和APP_NAME以外，可以使用.conf文件配置上一节中列出的设置。该文件应位于 jar 文件的旁边，并且具有相同的名称，但后缀为.conf而不是.jar。例如，名为/var/myapp/myapp.jar的 jar 使用名为/var/myapp/myapp.conf的配置文件，如以下示例所示：

myapp.conf.

JAVA_OPTS=-Xmx1024M
LOG_FOLDER=/custom/log/folder

要了解有关适当保护此文件的信息，请参阅确保 init.d 服务的准则。

64.3 Microsoft Windows 服务

可以使用winsw将 Spring Boot 应用程序作为 Windows 服务启动。

(单独维护的 samples)分步说明了如何为 Spring Boot 应用程序创建 Windows 服务。