Linux怎么创建自定义的systemd服务

答案:创建自定义systemd服务需编写.service文件并放置于/etc/systemd/system/,通过systemctl管理。具体步骤包括:使用绝对路径在[Service]中定义ExecStart,设置User、WorkingDirectory等参数,选择合适的Type类型(如simple、forking),配置Restart=on-failure实现故障重启;创建后运行sudo systemctl daemon-reload、enable、start启用服务,并用status和journalctl排查启动失败问题,常见原因有路径权限错误、脚本异常、Type类型不匹配等。

linux怎么创建自定义的systemd服务

在Linux中创建自定义的systemd服务,核心在于编写一个

.service

单元文件,它描述了你的程序或脚本如何启动、运行和停止。将这个文件放置到系统指定位置后,你就可以使用

systemctl

命令来管理它,实现开机自启、故障重启等功能。这让你的应用能像系统自带的服务一样,被

systemd

这个强大的初始化系统统一调度和监控。

解决方案

要让你的应用或脚本在Linux上像个“正经”的服务一样运行,被

systemd

管理起来,我们需要做的是定义一个

.service

单元文件。这就像给

systemd

写了一份操作指南,告诉它“我的这个程序叫什么,怎么启动,什么时候算启动成功,出问题了怎么办”。

首先,我们得创建一个

.service

文件。通常,我们会把它放在

/etc/systemd/system/

目录下。例如,如果你想创建一个名为

my_custom_app.service

的服务,那就这样:

sudo vim /etc/systemd/system/my_custom_app.service

文件内容大致会是这样:

[Unit]Description=我的自定义应用程序服务After=network.target # 这个服务在网络可用后启动[Service]Type=simple # 简单类型,表示ExecStart命令就是主进程,它会一直运行在前景ExecStart=/usr/local/bin/my_custom_app_script.sh # 你的应用程序或脚本的完整路径WorkingDirectory=/opt/my_custom_app/ # 设置工作目录,如果你的脚本需要User=your_username # 指定运行服务的用户,建议不要用root,除非必要Group=your_group # 指定运行服务的用户组Restart=on-failure # 当服务失败时(非正常退出),自动重启RestartSec=5s # 重启前等待5秒[Install]WantedBy=multi-user.target # 在多用户模式下启用此服务(即系统启动时)

这里面有几个关键部分:

[Unit]

: 描述服务的元数据和依赖关系。

Description

: 服务的简短描述,方便你识别。

After=network.target

: 这是一个很常见的依赖,意思是你的服务应该在网络服务启动之后再启动。你也可以指定其他服务,比如

After=mysql.service

[Service]

: 定义服务的行为。

Type

: 这非常重要,它告诉

systemd

你的

ExecStart

命令如何运行。

simple

是最常见的,表示命令就是主进程,在前台运行。如果你的程序会自己fork到后台,你可能需要

Type=forking

。我们稍后会详细聊聊

Type

ExecStart

: 这是启动你的服务所执行的命令或脚本。务必使用绝对路径,因为

systemd

的环境变量可能不像你登录shell时那么丰富。

WorkingDirectory

: 如果你的脚本或程序需要访问相对路径的文件,设置这个会很有用。

User

,

Group

: 出于安全考虑,强烈建议用一个非特权用户来运行服务,而不是

root

Restart

: 定义了服务在何种情况下自动重启。

on-failure

是一个很实用的选项,意味着如果你的程序崩溃了,

systemd

会尝试重新启动它。

RestartSec

: 配合

Restart

使用,指定重启前的等待时间。

[Install]

: 定义服务如何被“安装”到系统。

WantedBy=multi-user.target

: 这表示当系统进入多用户运行级别时(也就是我们日常使用的桌面或服务器模式),你的服务会被拉起来。

文件创建并保存后,你需要让

systemd

知道这个新文件:

sudo systemctl daemon-reload

接着,启用你的服务,让它在系统启动时自动运行:

sudo systemctl enable my_custom_app.service

然后,你可以手动启动它:

sudo systemctl start my_custom_app.service

最后,检查服务状态,看看它是否正常运行:

sudo systemctl status my_custom_app.service

如果一切顺利,你会看到服务处于

active (running)

状态。如果有什么问题,

status

命令也会显示最近的错误信息,或者你可以用

journalctl -u my_custom_app.service

查看更详细的日志。

这就是创建和管理一个基本

systemd

服务的流程。它提供了一个强大且灵活的方式来自动化你的应用程序。

Linux怎么创建自定义的systemd服务

为什么我的systemd服务启动失败了,该怎么排查?

服务启动失败,这简直是家常便饭。我遇到过太多次了,通常不是

systemd

本身的问题,而是我们配置或者脚本本身的问题。排查起来,其实就是一步步缩小范围,找到真正的“罪魁祸首”。

最常见的几个原因,我总结了一下:

ExecStart

命令路径或权限不对:这是新手最容易犯的错误。

systemd

在启动服务时,它的

PATH

环境变量通常很精简,不像你平时在终端里那么丰富。所以,你的

ExecStart=/path/to/your_script.sh

里的脚本路径,必须是绝对路径。比如,不能只写

python app.py

,而要写

/usr/bin/python /opt/my_app/app.py

。另外,脚本文件本身是不是有执行权限?

chmod +x /path/to/your_script.sh

是必须的。脚本本身有错误:你的脚本可能语法错误,或者依赖的环境变量、配置文件不存在。

systemd

只是执行它,如果脚本一启动就崩溃,服务自然就失败了。用户权限问题:你指定了

User=your_username

,但这个用户可能没有权限访问脚本需要的文件、目录,或者无法绑定到特定的端口。这时候,服务会因为权限不足而退出。工作目录不对:如果你的脚本依赖于当前工作目录下的文件(比如

./config.json

),但

WorkingDirectory

没有设置或者设置错误,脚本就找不到这些文件。依赖服务未启动:你设置了

After=network.target

或者

Requires=mysql.service

,但依赖的服务没能正常启动,或者启动时间过长,你的服务可能就会超时失败。

Type

类型选择错误:如果你的程序是传统的守护进程,会自己fork到后台,但你设置了

Type=simple

systemd

会认为主进程退出了,服务就失败了。反之,如果你的程序是前台运行的,却设置了

Type=forking

systemd

可能会因为找不到子进程而认为服务失败。

排查步骤,我一般是这么来:

查看服务状态和日志:这是第一步,也是最关键的一步。

sudo systemctl status my_custom_app.service

这个命令会给你一个快速概览,包括服务的状态、最近的错误信息,以及一些日志片段。如果需要更详细的日志,用

journalctl

sudo journalctl -u my_custom_app.service --since "10 minutes ago" -e

-u

指定单元,

--since

限制时间范围,

-e

跳到日志末尾。仔细阅读日志,通常错误信息会很明确。

手动运行

ExecStart

命令:以服务指定的用户身份,在服务指定的工作目录下,手动执行

ExecStart

中定义的命令。

# 假设你的服务用户是your_username,工作目录是/opt/my_custom_app/sudo -u your_username sh -c "cd /opt/my_custom_app/ && /usr/local/bin/my_custom_app_script.sh"

这样可以直接看到脚本的输出和错误信息,模拟

systemd

的执行环境。

检查文件和目录权限:确保脚本文件、日志文件、配置文件以及任何脚本需要访问的目录,都对服务运行的用户有正确的读写权限。简化脚本:如果脚本很复杂,可以先用一个简单的

echo "Hello World"

脚本替换

ExecStart

,确保

systemd

能成功启动一个最简单的服务,排除

systemd

配置问题,然后逐步还原你的复杂脚本。环境变量:如果你的脚本依赖特定的环境变量,可以在

[Service]

部分使用

Environment=KEY=VALUE

EnvironmentFile=/path/to/env_file

来设置。

记住,日志是你的好朋友。大部分问题,日志里都会给出线索。

Linux怎么创建自定义的systemd服务

systemd服务有哪些常见的Type类型,我该如何选择?

Type

指令是

systemd

服务配置中一个相当核心的概念,它告诉

systemd

你的服务主进程是如何启动和退出的。选错了

Type

,服务可能根本就启动不起来,或者

systemd

会误判服务状态。

我们来看看几个最常见的

Type

类型,以及我通常怎么选择:

Type=simple

(默认值)

行为

ExecStart

中指定的命令就是主进程。

systemd

认为服务在

ExecStart

命令执行后立即启动成功。如果这个进程退出,

systemd

会认为服务停止。适用场景:这是最常见、最简单的类型。适用于绝大多数在前台运行的应用程序或脚本,比如一个Web服务器(Nginx、Apache)、一个Python Flask应用、一个Node.js服务等,它们启动后会一直保持运行状态,直到被手动停止或崩溃。我的选择:如果我不确定,或者我的应用本身就是设计成在前台运行的,我通常会先尝试

simple

Type=forking

行为

ExecStart

中指定的命令会启动一个父进程,然后这个父进程会

fork

出一个或多个子进程,并立即退出。

systemd

会等待父进程退出,并期望子进程继续运行。它会尝试追踪这个子进程作为服务的主进程。为了帮助

systemd

,你通常需要指定

PIDFile=/path/to/pidfile.pid

,让

systemd

知道哪个是主进程的PID。适用场景:适用于那些遵循传统Unix守护进程模式的应用程序。这些程序启动后,会立即将自身“后台化”,父进程退出,子进程继续提供服务。例如,一些老旧的Java应用、某些数据库服务、或者一些用C/C++编写的传统守护进程。我的选择:如果我的应用程序在启动命令执行后,主进程很快就退出了,但服务还在后台运行,那多半就是

forking

类型。如果应用会生成PID文件,那

PIDFile

指令就变得很重要了。

Type=oneshot

行为

ExecStart

命令执行并退出后,

systemd

就认为服务已经成功“完成”了。它不会期望有任何进程持续运行。适用场景:非常适合那些只需要执行一次性任务的脚本或程序。比如,在系统启动时进行一些初始化配置、清理临时文件、数据库迁移、或者执行一个备份脚本。我的选择:当我需要一个服务在启动后执行某个操作,然后就“功成身退”时,

oneshot

是最佳选择。有时,配合

RemainAfterExit=yes

,可以表示即使

ExecStart

退出了,服务状态仍然是“active”,这在某些特定场景下很有用,比如一个只启动网络接口的服务。

Type=notify

行为:类似于

simple

,但服务启动后,会通过

sd_notify()

函数向

systemd

发送一个“我准备好了”的信号。

systemd

会等待这个信号,才认为服务真正启动成功。适用场景:适用于那些启动需要一定时间,并且希望

systemd

能精确知道何时服务“就绪”的复杂应用程序。比如,一个Web应用可能需要加载大量数据,或者连接数据库,这些操作完成后才算真正可以对外提供服务。我的选择:当我的服务启动时间不确定,或者有复杂的初始化逻辑,并且我希望其他依赖它的服务能准确地在我服务真正可用后才启动时,

notify

能提供更健壮的启动流程。这需要应用程序内部集成

libsystemd

库来发送通知。

如何选择?

我的经验是:

大多数现代应用(Web服务、API)

Type=simple

。它们通常设计成在前台运行。传统守护进程,或者自行后台化的程序

Type=forking

,并尽量提供

PIDFile

一次性任务或初始化脚本

Type=oneshot

需要精确启动就绪状态的复杂应用

Type=notify

如果不确定,先从

simple

开始尝试。如果服务启动后立即退出,但你期望它继续运行,那可能就是

forking

或你的脚本本身有问题。如果服务启动后一直卡住,或者依赖它的服务启动失败,可能需要考虑

notify

来更明确地通知

systemd

就绪状态。

Linux怎么创建自定义的systemd服务

如何让我的systemd服务在特定条件下自动重启或停止?

systemd

服务具备“自我修复”能力,或者在特定情况下优雅地停止,是构建健壮系统的重要一环。

systemd

在这方面提供了非常强大的控制能力。

自动重启策略 (

Restart=

指令)

这是让服务在出现问题时自动恢复的关键。我通常会根据服务的性质来选择合适的重启策略。

Restart=no

(默认值):服务停止后,无论是正常退出还是崩溃,都不会自动重启。这适用于那些一次性任务(比如

Type=oneshot

的服务),或者你希望手动介入处理的服务。

Restart=on-success

: 仅当服务进程以退出码0(表示成功)退出时,才自动重启。这听起来有点反直觉,但有时用于一些特殊场景,比如一个周期性运行但每次成功后都需要重新启动的服务。

Restart=on-failure

: 这是我最常用的一个选项。当服务进程以非0退出码退出、被信号终止(如

SIGSEGV

崩溃)、或者达到看门狗超时时,

systemd

会尝试重启它。这意味着如果你的应用崩溃了,

systemd

会尝试让它活过来。

Restart=on-abnormal

: 仅当服务进程被信号终止(如崩溃)或达到看门狗超时时重启。它不包括非0退出码的情况。

Restart=on-watchdog

: 仅当看门狗超时时重启。这需要服务本身支持

systemd

的看门狗机制。

Restart=always

: 无论服务如何停止(正常退出、崩溃、被手动停止),

systemd

都会尝试重启它。这个选项要慎用,如果服务一直崩溃,它会导致系统不断尝试重启,形成“重启风暴”,反而消耗系统资源。

通常,我会在

[Service]

部分这样配置:

Restart=on-failureRestartSec=5s # 重启前等待5秒,避免服务在极短时间内反复崩溃又重启

RestartSec

非常重要,它提供了一个缓冲时间,防止服务在快速失败循环中耗尽系统资源。

为了防止无限重启导致的问题,

systemd

还提供了重启频率限制

StartLimitIntervalSec=60s

:

以上就是Linux怎么创建自定义的systemd服务的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/200010.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年11月1日 20:38:44
下一篇 2025年11月1日 20:39:43

相关推荐

  • 如何解决本地图片在使用 mask JS 库时出现的跨域错误?

    如何跨越localhost使用本地图片? 问题: 在本地使用mask js库时,引入本地图片会报跨域错误。 解决方案: 要解决此问题,需要使用本地服务器启动文件,以http或https协议访问图片,而不是使用file://协议。例如: python -m http.server 8000 然后,可以…

    2025年12月24日
    200
  • 使用 Mask 导入本地图片时,如何解决跨域问题?

    跨域疑难:如何解决 mask 引入本地图片产生的跨域问题? 在使用 mask 导入本地图片时,你可能会遇到令人沮丧的跨域错误。为什么会出现跨域问题呢?让我们深入了解一下: mask 框架假设你以 http(s) 协议加载你的 html 文件,而当使用 file:// 协议打开本地文件时,就会产生跨域…

    2025年12月24日
    200
  • 正则表达式在文本验证中的常见问题有哪些?

    正则表达式助力文本输入验证 在文本输入框的验证中,经常遇到需要限定输入内容的情况。例如,输入框只能输入整数,第一位可以为负号。对于不会使用正则表达式的人来说,这可能是个难题。下面我们将提供三种正则表达式,分别满足不同的验证要求。 1. 可选负号,任意数量数字 如果输入框中允许第一位为负号,后面可输入…

    2025年12月24日
    000
  • 如何在 VS Code 中解决折叠代码复制问题?

    解决 VS Code 折叠代码复制问题 在 VS Code 中使用折叠功能可以帮助组织长代码,但使用复制功能时,可能会遇到只复制可见部分的问题。以下是如何解决此问题: 当代码被折叠时,可以使用以下简单操作复制整个折叠代码: 按下 Ctrl + C (Windows/Linux) 或 Cmd + C …

    2025年12月24日
    000
  • 网络进化!

    Web 应用程序从静态网站到动态网页的演变是由对更具交互性、用户友好性和功能丰富的 Web 体验的需求推动的。以下是这种范式转变的概述: 1. 静态网站(1990 年代) 定义:静态网站由用 HTML 编写的固定内容组成。每个页面都是预先构建并存储在服务器上,并且向每个用户传递相同的内容。技术:HT…

    2025年12月24日
    000
  • 为什么多年的经验让我选择全栈而不是平均栈

    在全栈和平均栈开发方面工作了 6 年多,我可以告诉您,虽然这两种方法都是流行且有效的方法,但它们满足不同的需求,并且有自己的优点和缺点。这两个堆栈都可以帮助您创建 Web 应用程序,但它们的实现方式却截然不同。如果您在两者之间难以选择,我希望我在两者之间的经验能给您一些有用的见解。 在这篇文章中,我…

    2025年12月24日
    000
  • 姜戈顺风

    本教程演示如何在新项目中从头开始配置 django 和 tailwindcss。 django 设置 创建一个名为 .venv 的新虚拟环境。 # windows$ python -m venv .venv$ .venvscriptsactivate.ps1(.venv) $# macos/linu…

    2025年12月24日
    000
  • 花 $o 学习这些编程语言或免费

    → Python → JavaScript → Java → C# → 红宝石 → 斯威夫特 → 科特林 → C++ → PHP → 出发 → R → 打字稿 []https://x.com/e_opore/status/1811567830594388315?t=_j4nncuiy2wfbm7ic…

    2025年12月24日
    000
  • 深入理解CSS框架与JS之间的关系

    深入理解CSS框架与JS之间的关系 在现代web开发中,CSS框架和JavaScript (JS) 是两个常用的工具。CSS框架通过提供一系列样式和布局选项,可以帮助我们快速构建美观的网页。而JS则提供了一套功能强大的脚本语言,可以为网页添加交互和动态效果。本文将深入探讨CSS框架和JS之间的关系,…

    2025年12月24日
    000
  • HTML+CSS+JS实现雪花飘扬(代码分享)

    使用html+css+js如何实现下雪特效?下面本篇文章给大家分享一个html+css+js实现雪花飘扬的示例,希望对大家有所帮助。 很多南方的小伙伴可能没怎么见过或者从来没见过下雪,今天我给大家带来一个小Demo,模拟了下雪场景,首先让我们看一下运行效果 可以点击看看在线运行:http://hai…

    2025年12月24日 好文分享
    500
  • 10款好看且实用的文字动画特效,让你的页面更吸引人!

    图片和文字是网页不可缺少的组成部分,图片运用得当可以让网页变得生动,但普通的文字不行。那么就可以给文字添加一些样式,实现一下好看的文字效果,让页面变得更交互,更吸引人。下面创想鸟就来给大家分享10款文字动画特效,好看且实用,快来收藏吧! 1、网页玻璃文字动画特效 模板简介:使用css3制作网页渐变底…

    2025年12月24日 好文分享
    000
  • tp5如何引入css文件

    tp5引入css文件的方法:1、将css文件放在public目录下的static文件里即可;2、在页面引入中写上“”语句即可。 本教程操作环境:windows7系统、CSS3&&HTML5版、Dell G3电脑。 其实很简单,只需要将css,js,image文件放在这个目录下即可 页…

    2025年12月24日
    000
  • 聊聊CSS 与 JS 是如何阻塞 DOM 解析和渲染的

    本篇文章给大家介绍一下css和js阻塞 dom 解析和渲染的原理。有一定的参考价值,有需要的朋友可以参考一下,希望对大家有所帮助。 hello~各位亲爱的看官老爷们大家好。估计大家都听过,尽量将CSS放头部,JS放底部,这样可以提高页面的性能。然而,为什么呢?大家有考虑过么?很长一段时间,我都是知其…

    2025年12月24日
    200
  • js如何修改css样式

    js修改css样式的方法:1、使用【obj.className】来修改样式表的类名;2、使用【obj.style.cssTest】来修改嵌入式的css;3、使用【obj.className】来修改样式表的类名;4、使用更改外联的css。 本教程操作环境:windows7系统、css3版,DELL G…

    2025年12月24日
    000
  • 如何使用纯CSS、JS实现图片轮播效果

    本篇文章给大家详细介绍一下使用纯css、js实现图片轮播效果的方法。有一定的参考价值,有需要的朋友可以参考一下,希望对大家有所帮助。 .carousel {width: 648px;height: 400px;margin: 0 auto;text-align: center;position: a…

    2025年12月24日
    000
  • js如何修改css

    js修改css的方法:1、使用【obj.style.cssTest】来修改嵌入式的css;2、使用【bj.className】来修改样式表的类名;3、使用更改外联的css文件,从而改变元素的css。 本教程操作环境:windows7系统、css3版,DELL G3电脑。 js修改css的方法: 方法…

    2025年12月24日
    000
  • js如何改变css样式

    js改变css样式的方法:1、使用cssText方法;2、使用【setProperty()】方法;3、使用css属性对应的style属性。 本教程操作环境:windows7系统、css3版,DELL G3电脑。 js改变css样式的方法: 第一种:用cssText div.style.cssText…

    2025年12月24日
    000
  • 为什么css放上面js放下面

    css放上面js放下面的原因:1、在加载html生成DOM tree的时候,可以同时对DOM tree进行渲染,这样可以防止闪跳,白屏或者布局混乱;2、javascript加载后会立即执行,同时会阻塞后面的资源加载。 本文操作环境:Windows7系统、HTML5&&CSS3版,DE…

    2025年12月24日
    000
  • 推荐六款移动端 UI 框架

    作为一个前端人员来说,总结几款相对来说不错的用于移动端开发的UI框架是非常必要的,以下几种移动端UI框架就能基本满足工作中开发需要,根据项目需求,选用合适的框架搭建项目,更能容易提高开发效率。 一、MUI         最接近原生APP体验的高性能前端框架,追求性能体验,是我们开始启动MUI项目的…

    2025年12月24日
    000
  • CSS如何实现任意角度的扇形(代码示例)

    本篇文章给大家带来的内容是关于CSS如何实现任意角度的扇形(代码示例),有一定的参考价值,有需要的朋友可以参考一下,希望对你有所帮助。 扇形制作原理,底部一个纯色原形,里面2个相同颜色的半圆,可以是白色,内部半圆按一定角度变化,就可以产生出扇形效果 扇形绘制 .shanxing{ position:…

    2025年12月24日
    000

发表回复

登录后才能评论
关注微信