Debian 13 教程 / 管理systemd服务并安全应用drop-in配置
在 Debian 13 中,active 表示 systemd 服务的当前激活状态,而 enabled 显示它是否设置为开机启动。如果您修改了配置文件或 drop-in 文件,请使用 daemon-reload 使 systemd 管理器重新读取单元定义,如果更改了执行命令,还须重启服务,并验证实际响应以确认新配置生效。
区分运行时状态和启动时配置
systemd 管理诸如服务、定时器和挂载点等任务,这些都作为单元处理。本教程在 Debian 13 systemd 257 环境中创建一个仅环回的 Python HTTP 服务,显示其状态并比较进程、端口和响应。这是操作常规系统服务的练习,并不意味着以相同方式重启所有现有服务。
| 命令 | 要更改的目标 | 本练习的结果 |
|---|---|---|
| start / stop | 当前运行的服务 | 在不更改其启动链接的情况下启动或停止服务 |
| enable / disable | 单元启动链接 | 在不停止正在运行的进程的情况下添加或删除启动链接 |
| enable --now | 启动配置和运行时状态 | 启用启动链接并立即启动服务 |
| daemon-reload | 由 systemd 读取的单元设置 | 重新读取单元定义而不替换 HTTP 进程 |
| restart | 服务进程 | 通过停止并启动来应用新的执行命令 |
即使 enabled ,服务也可能失败,即使 disabled ,也可以手动启动或在其他单元的请求下执行。本例通过 [Install] 段中的 WantedBy=multi-user.target 指定创建启动链接的目标。有些服务是没有安装连接的静态单元,或者通过套接字启动,因此不要仅根据它们是否启用来确定所有服务的启动行为。详细的命令含义可以在 Debian 13 systemctl 手册 中找到。
检查专用实验室的初始状态
使用具有 sudo 权限的 lfstudent 账号、Python 3 和 curl。如果是不同的账号,请调整下面服务的 User 及文档路径以匹配实际账号。Python HTTP 服务器仅用于练习,因此无需对主机或局域网开放,所以它只监听 127.0.0.1。无需进行 NAT 转发或防火墙更改。
id lfstudent
python3 --version
curl --version
systemctl --version
systemctl show lf-http17.service -p LoadState
sudo ss -lntp 'sport = :8080'
sudo ss -lntp 'sport = :8082'
ls -ld /home/lfstudent/lf-http17 /etc/systemd/system/lf-http17.service.d
服务是 LoadState=not-found,两个端口都没有监听行,文件夹在起始条件下不存在。最后一条 ls 命令预期报告路径不存在,这用于确认这些练习路径尚未被占用。如果任何实验资源已存在,请在此停止并确认其所有者。不要覆盖它或停止其他服务。如果未安装 Python 或 curl,请查看 sudo apt install --no-install-recommends python3 curl 中的更改列表以进行安装。
在以 lfstudent 登录的终端上创建一个专用文件。
mkdir /home/lfstudent/lf-http17 &&
printf 'systemd-service-lab\n' > /home/lfstudent/lf-http17/probe.txt
如果目录创建失败,则链式 printf 命令会被跳过。在此时停止实验,而不是继续处理服务文件。练习文档根目录是单独受限的,并且不会提供整个主目录。系统服务通常由系统管理员处理,但 HTTP 进程本身以普通用户权限执行,如下 User=lfstudent 所示。
编写并验证完整的服务单元
使用 sudo nano /etc/systemd/system/lf-http17.service 打开一个新文件并保存以下全部内容。您可以使用其他编辑器,但保持文件名、路径和行结构。不要用新的示例覆盖现有文件。
[Unit]
Description=Local HTTP service for lesson 17
[Service]
Type=exec
User=lfstudent
ExecStart=/usr/bin/python3 -m http.server 8080 --bind 127.0.0.1 --directory /home/lfstudent/lf-http17
Restart=on-failure
RestartSec=2s
[Install]
WantedBy=multi-user.target
Type=exec 有助于在启动可执行文件的阶段检查错误。然而,可执行文件的成功启动并不保证 HTTP 监听器已就绪。Restart=on-failure 是在异常终止时重新启动的设置,它不是恢复管理员正常停止的服务的选项。
在 ExecStart 中进行后台执行时,不要附加 &。systemd 通过在前台运行直接管理该进程。与普通的 shell 命令行不同,管道和重定向不会自动作为 shell 语法处理。请参阅 systemd.service 文档 中相关选项的执行方法。
sudo systemd-analyze verify /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
systemctl cat lf-http17.service
检查是否存在任何检查错误或警告。即使在无错误读取之后,它仍未启动,因此禁用和非活动是预期的。这两个查询会根据状态返回非零退出代码,因此在自动化中不要简单地将所有异常退出视为安装失败。
分别观察活动和已启用状态
首先,手动启动服务并检查实际文件响应。
sudo systemctl start lf-http17.service
systemctl is-active lf-http17.service
systemctl is-enabled lf-http17.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
sudo ss -lntp 'sport = :8080'
预期状态查询依次返回 active 和 disabled,并且 HTTP 请求返回 systemd-service-lab。curl 中有限的重试次数考虑到了进程启动后端口立即就绪的短暂差异。如果仍然失败,不要单靠状态,使用 sudo journalctl -u lf-http17.service -b --no-pager -n 30 检查原因。
启用启动链接,然后停止当前进程。
sudo systemctl enable lf-http17.service
sudo systemctl stop lf-http17.service
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
预期依次得到 enabled 和 inactive。停止操作不会移除启动时的启动链接。再次启动服务,然后禁用其启动链接。
sudo systemctl start lf-http17.service
sudo systemctl disable lf-http17.service
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
预期依次得到 disabled、active,HTTP 请求仍返回相同文件。在此示例中,禁用操作并未停止正在运行的 HTTP 进程。如果希望立即停止,请使用 disable --now 。在此对比中,将其保持在活动且禁用状态以便随后更改端口。
使用 Drop-in 更改端口
Drop-in 是一个额外配置,添加到 unit-name.d/ 文件夹中,位于原始单元文件旁。管理员通常不会直接修改软件包提供的 /usr/lib/systemd/system/ 文件,而是将更改作为 /etc/systemd/system/ 的 drop-in 来管理。此示例将相同的方法应用于手动创建的单元,以区分原始文件和附加文件。
systemctl show lf-http17.service -p MainPID -p ExecStart -p FragmentPath -p DropInPaths
sudo install -d /etc/systemd/system/lf-http17.service.d
MainPID 是服务主进程的进程标识符(PID)。记录当前值,以便稍后比较。使用 sudo nano /etc/systemd/system/lf-http17.service.d/20-port.conf 创建 drop-in。
[Service]
ExecStart=
ExecStart=/usr/bin/python3 -m http.server 8082 --bind 127.0.0.1 --directory /home/lfstudent/lf-http17
一个空的 ExecStart= 用于重置先前设置的执行命令,并在下一行替换它。如果在未重置的情况下添加第二个执行命令,则此服务类型中预期的替换将不会发生。Drop-ins 的合并或覆盖根据选项的不同而不同,因此并不是所有设置都以相同方式处理。systemd.unit 的配置搜索路径和 drop-in 描述 是参考。
sudo systemd-analyze verify /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
systemctl cat lf-http17.service
systemctl show lf-http17.service -p MainPID -p ExecStart -p DropInPaths
curl --noproxy '*' --max-time 5 -fsS http://127.0.0.1:8080/probe.txt
curl --noproxy '*' --max-time 3 -fsS http://127.0.0.1:8082/probe.txt
虽然管理器现在在 ExecStart 中显示 8082,但正在运行进程的 MainPID 仍为之前的值,并且 8080 的响应继续。对 8082 的请求预计会失败,因为那里还没有任何服务监听。这种情况表明 daemon-reload 重新读取了单元定义,并且与重启进程不同。
sudo systemctl restart lf-http17.service
systemctl show lf-http17.service -p MainPID -p ActiveState -p SubState -p UnitFileState
sudo ss -lntp 'sport = :8082'
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8082/probe.txt
curl --noproxy '*' --max-time 3 -fsS http://127.0.0.1:8080/probe.txt
检查重启进程的 PID,并验证 8082 端口上的监听器和文件响应,同时比较之前在 8080 端口上的监听器是否已消失。PID 号会根据环境而变化,更重要的是同时检查状态、监听器和响应,而不仅仅是数字本身。reload 命令也是一个独立操作。本单元未指定 ExecReload 等,所以不使用不支持的重载来应用设置。
仅移除本次 drop-in 并恢复 8080 端口
保留原始服务文件,仅删除此次创建的 20-port.conf。此处不要运行会整体撤销单元覆盖配置的操作,因为可能会清除其他补充设置。
sudo rm -- /etc/systemd/system/lf-http17.service.d/20-port.conf
sudo rmdir -- /etc/systemd/system/lf-http17.service.d
sudo systemctl daemon-reload
sudo systemctl restart lf-http17.service
systemctl show lf-http17.service -p ExecStart -p DropInPaths
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
sudo journalctl -u lf-http17.service -b --no-pager -n 20
当 DropInPaths 为空、ExecStart 再次指定端口 8080,且 HTTP 请求返回原始文件时,恢复即被确认。如果 rmdir 失败,因为它不为空,应首先检查是否有其他文件,并且不要删除整个文件夹。日志会保留启动、停止和请求的痕迹,从而允许您验证状态转换。
诊断错误并移除专用服务
文件路径拼写错误或访问权限问题可能表现为 HTTP 请求失败或服务启动失败。端口冲突可以用 ss 检查,看是否有其他服务器在监听。阅读 systemctl status lf-http17.service --no-pager 的结果以及日志中的具体错误并进行修正。仅运行 reset-failed 来清除失败记录并不能解决根本原因。
完成练习后,只停止专用服务,禁用自动启动,然后删除已创建的文件。
sudo systemctl disable --now lf-http17.service
sudo rm -- /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
rm -- /home/lfstudent/lf-http17/probe.txt
rmdir -- /home/lfstudent/lf-http17
systemctl show lf-http17.service -p LoadState
sudo ss -lntp 'sport = :8080'
sudo ss -lntp 'sport = :8082'
检查该单元是否未找到,并且实验端口都没有监听行。如果服务仍处于失败状态,首先确认文件已删除且进程已终止,然后仅使用 sudo systemctl reset-failed lf-http17.service 清理该单元的故障记录。保留其他服务和系统日志。




