Debian 13 教程 / 为服务配置独立账户与最小写入权限

在 Debian 13 中以独立账户运行服务,并将持久数据的写入范围缩小到实际需要的状态目录,可以使管理更加容易。NoNewPrivileges · ProtectSystem · StateDirectory 有不同的角色,因此应逐步应用,并且您需要区分进程是否处于活动状态和实际功能是否成功执行。

将账户所有权与服务限制分开

本教程在 Debian 13 上使用 systemd 257 和 Python 3.13 创建一个仅回环的写入检查服务。专用账户将文件所有权与其他用户分开,systemd 限制进一步限制了该服务的文件系统可见性和权限获取范围。这些限制可以补充 AppArmor 配置实验 中的基于路径的策略,但机制不同。

设置 在本练习中需验证的角色
User / Group 使用专用 UID(用户标识符)和 GID(组标识符) 运行进程
NoNewPrivileges 防止通过后续程序执行获得新的权限;本身不阻止文件写入
ProtectSystem=strict 对服务的文件系统视图应用广泛的只读限制
ProtectHome=true 限制对与主目录相关路径的访问
PrivateTmp=true 为服务提供单独的临时目录;不同于完全的文件系统隔离
StateDirectory 准备服务拥有的持久状态路径并提供环境变量

不要将每个限制复制到每个服务中。存储在主目录中的可执行文件、与其他程序共享的临时文件以及其他可写路径可能会受到影响。请结合服务的实际行为,查看 Debian 13 systemd.exec 手册 。

检查冲突并创建服务账户

新账户是 lf-svc20 ,服务是 lf-service20.service 。不应存在具有相同名称的现有账户、组、单元或文件夹。不要使用此示例覆盖或删除在以下查询中找到的现有项目。

getent passwd lf-svc20
getent group lf-svc20
systemctl show lf-service20.service -p LoadState
ls -ld /var/lib/lf-service20 /opt/lf-service20-scratch
ls -l /usr/local/libexec/lf-service20.py
sudo ss -lntp 'sport = :8080'
python3 --version
curl --version

初始条件:账户/组查询未返回匹配项,服务单元返回 not-found,文件不存在,端口8080没有监听。若缺少 Python 或 curl,请检查软件包变更列表,并使用 sudo apt install --no-install-recommends python3 curl 准备。服务文件与补充设置的使用方法,可参考systemd 单元与 drop-in 实训。

sudo adduser --system --group --no-create-home --home /nonexistent --shell /usr/sbin/nologin lf-svc20
getent passwd lf-svc20
id lf-svc20
sudo passwd -S lf-svc20
sudo install -d -m 750 -o lf-svc20 -g lf-svc20 /opt/lf-service20-scratch
sudo install -d /usr/local/libexec

创建具有相同名称的系统帐户和组,不使用普通登录 shell,也不创建主目录。不要给新帐户分配 sudo 组或登录密码。UID 和 GID 会自动分配,因此不要固定示例数字。nologin shell 是一个设置,用于区分它与交互式登录,并不会阻止 systemd 使用该 UID 运行程序。有关帐户创建行为,请参阅 Debian adduser 文档。

/opt/lf-service20-scratch 是一个用于比较的文件夹。给予专用帐户对该目录的普通写入权限,并稍后验证服务的只读限制是否阻止写入。不要使用实际应用程序文件。

编写完整的 HTTP 写入探测程序

将以下全部内容保存到 sudo nano /usr/local/libexec/lf-service20.py 中。您可以使用除了 nano 以外的编辑器。保持可执行文件由管理员拥有,并允许服务账户只读访问。

import json
import os
from http.server import BaseHTTPRequestHandler, HTTPServer
from pathlib import Path

def write_probe(path):
    try:
        path.write_text("write-probe-ok\n", encoding="utf-8")
        return {"ok": True, "errno": None}
    except OSError as error:
        return {"ok": False, "errno": error.errno}

class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        if self.path != "/health":
            self.send_error(404)
            return
        required_dir = Path(os.environ.get("LF_WRITE_DIR", os.environ["STATE_DIRECTORY"]))
        required = write_probe(required_dir / "required.txt")
        outside = write_probe(Path("/opt/lf-service20-scratch/outside.txt"))
        payload = json.dumps({"uid": os.getuid(), "required": required, "outside": outside}).encode()
        self.send_response(200 if required["ok"] else 503)
        self.send_header("Content-Type", "application/json")
        self.send_header("Content-Length", str(len(payload)))
        self.end_headers()
        self.wfile.write(payload)

HTTPServer(("127.0.0.1", 8080), Handler).serve_forever()

该程序为每个 /health 请求执行两次测试写入。响应采用 JSON(JavaScript Object Notation,结构化数据交换格式)。required 是必需状态目录的写入结果,outside 是对照目录的写入结果。如果必需的写入失败,它的设计是返回 HTTP 503,而不是终止进程。这种行为用于练习以观察错误,并不建议在操作状态检查期间每次都写入文件。

由于它使用 systemd 提供的 STATE_DIRECTORY,因此通过以下单元运行。本例不采用未设置必要环境变量而直接从终端运行程序的方式。仅使用标准库,因此不需要安装 pip。它仅监听回环地址,并不是生产环境的 Web 服务器。

sudo chmod 644 /usr/local/libexec/lf-service20.py
ls -l /usr/local/libexec/lf-service20.py

创建基础服务及其状态目录

将其保存到 sudo nano /etc/systemd/system/lf-service20.service。

[Unit]
Description=Lesson 20 service write probe

[Service]
Type=exec
User=lf-svc20
Group=lf-svc20
ExecStart=/usr/bin/python3 /usr/local/libexec/lf-service20.py
StateDirectory=lf-service20
StateDirectoryMode=0750
UMask=0027

[Install]
WantedBy=multi-user.target

系统服务的 StateDirectory=lf-service20 准备 /var/lib/lf-service20,在此示例中,使用指定的用户和组以及 0750 模式。该路径作为 STATE_DIRECTORY 环境变量传递给程序。代码和配置归管理员所有,而可更改的状态文件由专用帐户所有,以区分所有权。

sudo systemd-analyze verify /etc/systemd/system/lf-service20.service
sudo systemctl daemon-reload
sudo systemctl start lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health
sudo stat -c '%U:%G %a %n' /var/lib/lf-service20
systemctl show lf-service20.service -p User -p Group -p MainPID

正常启动后,预期 HTTP 200,且 required 与 outside 均为 ok: true。状态文件夹显示为 lf-svc20:lf-svc20,模式为 750。由于尚无文件系统限制,也可以写入比较文件夹。启动后端口准备就绪前的短暂延迟通过有限的 curl 重试处理,如果仍然失败,请检查日志中的错误。

分阶段应用权限和文件系统限制

先用 ls -ld /etc/systemd/system/lf-service20.service.d 确认补充配置目录也不存在;若存在,请停止并检查其所有者与内容。然后使用 sudo install -d /etc/systemd/system/lf-service20.service.d 创建文件夹,并将其保存到 sudo nano /etc/systemd/system/lf-service20.service.d/20-privileges.conf 中。

[Service]
NoNewPrivileges=true
sudo systemctl daemon-reload
sudo systemctl restart lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health
service_pid=$(systemctl show lf-service20.service -p MainPID --value)
sudo grep '^NoNewPrivs:' /proc/"$service_pid"/status

验证两个写入操作仍能成功,并且 NoNewPrivs 设置为 1。此选项可防止进程及其子进程在执行其他程序时获取新的权限。例如,它用于防止通过 setuid 设置获取权限,以允许以文件所有者的权限执行。不要因为启用了此选项就认为所有文件访问都受到限制。接下来,写入 sudo nano /etc/systemd/system/lf-service20.service.d/30-filesystem.conf。

[Service]
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
sudo systemd-analyze verify /etc/systemd/system/lf-service20.service
sudo systemctl daemon-reload
sudo systemctl restart lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health
systemctl show lf-service20.service -p NoNewPrivileges -p ProtectSystem -p ProtectHome -p PrivateTmp -p StateDirectory

预期 HTTP 200、required 的 ok: true 和 outside 的 ok: false。原始实测中,outside 的 errno(操作系统错误编号)为 30,表示在只读文件系统上写入错误。作为例外,准备好的 STATE_DIRECTORY 路径仍然可以写入,而用于比较的 /opt 路径从服务的角度来看变为只读。

在这种设置下,服务写入的并非所有路径都限制在单个状态文件夹。/tmp 和 /var/tmp,通过 PrivateTmp 分隔开,也可以写入。同时还必须考虑 提供内核等接口的 API 文件系统(如 /dev、/proc、/sys)和任何其他明确的例外情况。本练习比较了在保持所需持久状态路径的同时,限制写入不必要的一般路径。

这并不会使整个主机文件系统变为只读。要比较在服务之外使用相同 UID 的写操作,可以按如下方式创建并随后删除单独的文件。

sudo -u lf-svc20 touch /opt/lf-service20-scratch/from-normal-context
sudo rm -- /opt/lf-service20-scratch/from-normal-context

即使在一般权限下可以写入,服务隔离执行环境中的结果也会不同。可以按实际需求通过 ReadWritePaths 配置额外的可写路径例外,但该选项并不授予文件本身的所有权或模式。检查实际需要的路径,如果默认状态路径足够,则无需扩大例外范围。

观察返回 HTTP 503 的活动服务

为了创建功能和限制冲突的示例,只需错误地指定一个必需的写入路径。将其保存在 sudo nano /etc/systemd/system/lf-service20.service.d/90-wrong-path.conf 中。

[Service]
Environment=LF_WRITE_DIR=/opt/lf-service20-scratch
sudo systemctl daemon-reload
sudo systemctl restart lf-service20.service
systemctl is-active lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -sS -i http://127.0.0.1:8080/health
sudo journalctl -u lf-service20.service -b --no-pager -n 20

服务处于活动状态,但返回 HTTP 503,required 的 ok 为 false。在此操作中,已确认所需路径的 errno 30 和 HTTP 503。进程能够接收请求的事实不同于必要存储功能正常的事实。这次为了读取错误响应的正文,刻意不加 curl 的 --fail。

不要移除所有安全限制,而是恢复错误指定的路径。这次仅删除失败示例文件并重启。

sudo rm -- /etc/systemd/system/lf-service20.service.d/90-wrong-path.conf
sudo systemctl daemon-reload
sudo systemctl restart lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health
systemctl show lf-service20.service -p ProtectSystem -p NoNewPrivileges

确认 required 写入成功并恢复 HTTP 200,同时检查 ProtectSystem=strict 和 NoNewPrivileges=yes 仍然保持。不要删除其他辅助文件。在诊断实际服务的访问失败时,还应考虑 UID 和 GID、一般文件权限、服务路径限制以及 AppArmor 日志,仅修改失败的条件。

验证状态持久性并清理实验室

StateDirectory 中的文件在服务停止时不会自动删除。在检查当前状态文件后,再次启动服务后,比较是否仍可写入。

sudo systemctl stop lf-service20.service
sudo cat /var/lib/lf-service20/required.txt
sudo systemctl start lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health

在此示例中,通过停止和启动确认了状态文件夹的持久性。服务的启动链接配置是独立的,因此本练习保持其在手动启动状态。删除操作数据时,重要的是要区分删除单元和删除数据是两个不同的操作。

完成练习后,先停止服务,只删除这些文件。下面的数据删除假定文本中提到的只有新创建的测试文件。

sudo systemctl disable --now lf-service20.service
sudo rm -- /etc/systemd/system/lf-service20.service.d/20-privileges.conf /etc/systemd/system/lf-service20.service.d/30-filesystem.conf
sudo rmdir -- /etc/systemd/system/lf-service20.service.d
sudo rm -- /etc/systemd/system/lf-service20.service /usr/local/libexec/lf-service20.py
sudo systemctl daemon-reload
sudo rm -- /var/lib/lf-service20/required.txt /opt/lf-service20-scratch/outside.txt
sudo rmdir -- /var/lib/lf-service20 /opt/lf-service20-scratch
sudo userdel lf-svc20
getent passwd lf-svc20
getent group lf-svc20
sudo ss -lntp 'sport = :8080'

确认账户已被移除,并且实验室端口上没有任何监听。如果仍然存在一个同名的专用组,并且没有被其他账户使用,只使用 sudo groupdel lf-svc20 移除该组。如果文件夹不为空,检查其他文件,不要使用递归删除方式处理。账户删除不包括查找并删除该 UID 所有数据的功能,因此请遵循先清理您创建的数据路径的顺序。