Debian 13 教程 / 部署持久化计数服务并演练故障诊断与备份恢复
要验证 Debian 服务器的运行情况,您需要检查的不仅是服务是否运行,还要检查它是否能正确读取和写入数据,以及在从备份恢复损坏数据后,新写入的数据是否依然保留。在这次综合实践中,您将使用专用账户部署计数器服务,并依次执行正常备份、有限数据损坏、HTTP 错误检测以及实际恢复。
定义实验环境和成功标准
使用一个独立的虚拟机(VM),配置 Debian 13、Python 3.13 和 systemd 257。如果 Python 3、curl 或 tar 不可用,请使用 sudo apt install python3 curl tar 进行准备。请使用具有 sudo 权限的管理员账户执行,并且不要在已经使用任何指定路径、该账户或端口8086的服务器上应用。
HTTP 服务仅接受在 127.0.0.1:8086 的请求。GET / 读取当前值,POST /increment(无请求体)将值增加一。此服务用于本地学习,而非实现身份验证、外部TLS(Transport Layer Security,传输层安全)或多进程并发写入的运营产品。同时请查阅 Python HTTP 服务器文档 的范围。
| 步骤 | 成功标准 |
|---|---|
| 部署和写入 | 使用专用账户:0 → 1 → 2,并在服务重启后仍为2 |
| 正常备份 | 在停止状态下生成归档和哈希,恢复到独立的空目录,比较内容和权限 |
| 损坏检测 | 进程和端口保持,但GET和POST都返回503,损坏的文件不会自动初始化 |
| 恢复后的操作 | 从实际备份恢复2 → 写入新的3 → 重启后为3 → 写入新的4 |
以下命令是执行一次新实践的顺序。检查以避免覆盖同一个备份,如果中途失败,请检查状态和日志,然后先解决失败步骤的原因。不要再次运行初始区块以强制初始化正常值。
在专用账户下部署完整程序
在设置之前,还要确认 getent group lf-capstone36 没有找到现有组。在任何前置条件或创建步骤失败时停止,而不是重复使用现有的账户、目录或服务。确保环回 curl 请求绕过任何配置的代理。
程序和服务单元归 root 所有,只有数据目录由专门账户管理。在单元的只读系统限制下,数据路径允许用于 ReadWritePaths。在创建临时文件并替换名称的存储方法中,不仅需要单个文件的写权限,还需要父目录的写入与执行(搜索)权限。
sudo bash <<'ROOT'
set -euo pipefail
for p in /opt/lf-capstone36 /var/lib/lf-capstone36 /var/backups/lf-capstone36 /etc/systemd/system/lf-capstone36.service; do test ! -e "$p"; done
if getent passwd lf-capstone36 >/dev/null; then exit 1; fi
test -z "$(ss -H -ltn 'sport = :8086')"
useradd --system --user-group --home-dir /var/lib/lf-capstone36 --no-create-home --shell /usr/sbin/nologin lf-capstone36
install -d -m 755 /opt/lf-capstone36
install -d -m 750 -o lf-capstone36 -g lf-capstone36 /var/lib/lf-capstone36
install -d -m 700 /var/backups/lf-capstone36
cat > /opt/lf-capstone36/app.py <<'PY'
from http.server import BaseHTTPRequestHandler, HTTPServer
from pathlib import Path
import json
import os
import tempfile
DATA = Path('/var/lib/lf-capstone36/state.json')
def load_count():
value = json.loads(DATA.read_text(encoding='utf-8'))
if (type(value) is not dict or set(value) != {'count'}
or type(value['count']) is not int or value['count'] < 0):
raise ValueError('invalid state')
return value['count']
def save_count(count):
temporary = None
try:
with tempfile.NamedTemporaryFile(
mode='w', encoding='utf-8', dir=DATA.parent,
prefix='state.', delete=False) as stream:
temporary = Path(stream.name)
json.dump({'count': count}, stream, separators=(',', ':'))
stream.write('\n')
stream.flush()
os.fsync(stream.fileno())
os.replace(temporary, DATA)
descriptor = os.open(DATA.parent, os.O_RDONLY | os.O_DIRECTORY)
try:
os.fsync(descriptor)
finally:
os.close(descriptor)
finally:
if temporary is not None:
temporary.unlink(missing_ok=True)
class Handler(BaseHTTPRequestHandler):
def reply(self, status, value):
body = (json.dumps(value, separators=(',', ':')) + '\n').encode()
self.send_response(status)
self.send_header('Content-Type', 'application/json; charset=utf-8')
self.send_header('Content-Length', str(len(body)))
self.end_headers()
self.wfile.write(body)
def do_GET(self):
if self.path != '/':
self.reply(404, {'error': 'not found'})
return
try:
count = load_count()
except (OSError, ValueError):
self.reply(503, {'error': 'state unavailable'})
return
self.reply(200, {'count': count})
def do_POST(self):
if self.path != '/increment':
self.reply(404, {'error': 'not found'})
return
if self.headers.get('Content-Length', '0') != '0':
self.reply(400, {'error': 'empty body required'})
return
try:
count = load_count() + 1
save_count(count)
except (OSError, ValueError):
self.reply(503, {'error': 'state unavailable'})
return
self.reply(200, {'count': count})
HTTPServer(('127.0.0.1', 8086), Handler).serve_forever()
PY
cat > /etc/systemd/system/lf-capstone36.service <<'UNIT'
[Unit]
Description=LF capstone counter 36
After=network.target
[Service]
Type=exec
User=lf-capstone36
Group=lf-capstone36
WorkingDirectory=/opt/lf-capstone36
ExecStart=/usr/bin/python3 -B /opt/lf-capstone36/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
ReadWritePaths=/var/lib/lf-capstone36
MemoryMax=128M
TasksMax=32
Restart=on-failure
RestartSec=2s
[Install]
WantedBy=multi-user.target
UNIT
chmod 644 /opt/lf-capstone36/app.py /etc/systemd/system/lf-capstone36.service
printf '{"count":0}\n' > /var/lib/lf-capstone36/state.json
chown lf-capstone36:lf-capstone36 /var/lib/lf-capstone36/state.json
chmod 600 /var/lib/lf-capstone36/state.json
systemd-analyze verify /etc/systemd/system/lf-capstone36.service
systemctl daemon-reload
systemctl enable --now lf-capstone36.service
sleep .4
test "$(curl -fsS http://127.0.0.1:8086/)" = '{"count":0}'
test "$(curl -fsS -X POST http://127.0.0.1:8086/increment)" = '{"count":1}'
test "$(curl -fsS -X POST http://127.0.0.1:8086/increment)" = '{"count":2}'
systemctl restart lf-capstone36.service
sleep .3
test "$(curl -fsS http://127.0.0.1:8086/)" = '{"count":2}'
systemctl is-enabled lf-capstone36.service
pid=$(systemctl show -p MainPID --value lf-capstone36.service)
ps -o user=,group=,args= -p "$pid"
if runuser -u lf-capstone36 -- test -w /opt/lf-capstone36/app.py; then echo CODE_WRITABLE >&2; exit 1; fi
if runuser -u lf-capstone36 -- test -r /var/backups/lf-capstone36; then echo BACKUP_READABLE >&2; exit 1; fi
systemctl show lf-capstone36.service -p NoNewPrivileges -p ProtectSystem -p ReadWritePaths -p MemoryMax -p TasksMax
echo COUNTER0_TO1_TO2_AND_RESTART_PERSISTENCE_LEAST_PRIVILEGE_PASSED
ROOT
短暂的启动等待只是延迟,而不是就绪保证。如果请求失败,请检查 sudo systemctl status lf-capstone36.service 和 sudo journalctl -u lf-capstone36.service -n 30,然后使用 GET 检查当前值。不要重复整个设置或盲目重试 POST:即使响应丢失,写入操作也可能已经提交。文件替换成功后,如果目录fsync失败,服务也可能在值已经改变的情况下返回503;请先用GET读取当前值,再决定如何处理。
如果它执行到区块末尾没有错误,则 0 → 1 → 2,并且重启服务后,确认保持 2。专用账户无法修改代码文件或读取仅限 root 的备份目录,执行限制输出显示 ProtectSystem=strict、NoNewPrivileges=yes、内存 128 MiB 和 32 个任务。这些限制适用于一个小示例,应根据实际服务的测量值进行调整。
该程序使用 JSON(JavaScript Object Notation,JavaScript对象表示法)解析器 检查读取值的结构、整数类型和范围。如果遇到无效文件,它会返回 503,而不是重置为 0。自动初始化为 0 可能会丢失用于恢复的证据和现有值,并将错误隐藏为正常响应。
在保存时,使用 NamedTemporaryFile 在同一数据目录中创建一个临时文件,并在 flush 和 fsync 后,用 os.replace 替换文件名。目录也会同步,但此练习没有测试断电或虚拟磁盘缓存丢失。不要将原子名称替换和对所有存储设备断电情况下的数据持久性视为提供相同的保证。
此 HTTP 服务器在一个服务器进程中顺序处理请求。对于多个进程修改同一文件或外部工具同时写入的情况,没有实现同步。此外,增量请求每次重复都会改变值,因此由于未收到响应而盲目重发可能会使其增加两次。在实际操作中,应考虑使用具有事务和重复请求处理功能的存储方式。
原始Debian虚拟机实训使用systemctl 验证了已启用状态和服务重启。由于在这次全面演练中未单独测试虚拟机重启后的自动启动,因此在实际移交前,还需在确保控制台和恢复手段的情况下进行启动测试。账户、路径和保护设置的含义可在 systemd 执行环境手册 中查阅。
备份已停止的服务并测试空目录恢复
停止服务,并在计数器值为 2 时备份该计数器。如果发送额外请求导致值变化,请检查原因并设置预期参考值。如果以下检查失败,不要用 2 覆盖数据。
sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/lf-capstone36
test ! -e "$dest/service.tar"
systemctl stop lf-capstone36.service
test "$(cat /var/lib/lf-capstone36/state.json)" = '{"count":2}'
sha256sum /var/lib/lf-capstone36/state.json > "$dest/state-before.sha256"
stat -c '%u:%g:%a' /var/lib/lf-capstone36/state.json > "$dest/state-mode.txt"
tar --acls --xattrs --numeric-owner -cpf "$dest/service.tar" -C / opt/lf-capstone36 var/lib/lf-capstone36 etc/systemd/system/lf-capstone36.service
cd "$dest"
sha256sum service.tar > service.sha256
sha256sum -c service.sha256
mkdir -m 700 restore-test
tar --acls --xattrs --numeric-owner --same-owner -xpf service.tar -C restore-test
cmp /opt/lf-capstone36/app.py restore-test/opt/lf-capstone36/app.py
cmp /var/lib/lf-capstone36/state.json restore-test/var/lib/lf-capstone36/state.json
test "$(stat -c '%u:%g:%a' restore-test/var/lib/lf-capstone36/state.json)" = "$(cat state-mode.txt)"
systemctl start lf-capstone36.service
sleep .3
test "$(curl -fsS http://127.0.0.1:8086/)" = '{"count":2}'
echo STOPPED_BACKUP_CHECKSUM_AND_EMPTY_DIRECTORY_RESTORE_PASSED
ROOT
service.tar: OK 是一个归档完整性检查。然后,比较在空恢复测试中提取的程序和数据的字节,以及数据文件的用户ID(UID,User ID)、组ID(GID,Group ID)及权限。这比仅检查备份文件的存在更强的验证,但还不是在实际服务路径中从故障恢复的操作。该过程在下文单独进行。
归档仅包括本练习的程序、数据和单元。由于 /var/backups 位于同一磁盘上,它并不是针对整个磁盘丢失的独立备份。对于实际业务数据,还应准备一份具有独立存储和访问权限的副本,并在指定的恢复间隔进行检查。您可以参考 GNU tar Debian 手册 中 tar 的选项。
只破坏实训数据并检测 HTTP 错误
以下代码块故意仅更改您刚创建的 /var/lib/lf-capstone36/state.json,使其处于语义无效状态:有效的 JSON,但在需要整数的地方使用了字符串。仅在通过正常备份检查后执行此操作,并且不要将路径替换为业务文件。不要尝试终止进程或填满磁盘。
sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/lf-capstone36
printf '{"count":"broken"}\n' > /var/lib/lf-capstone36/state.json
sha256sum /var/lib/lf-capstone36/state.json > "$dest/broken-state.sha256"
test "$(curl -sS -o "$dest/broken-get.txt" -w '%{http_code}' http://127.0.0.1:8086/)" = 503
test "$(curl -sS -X POST -o "$dest/broken-post.txt" -w '%{http_code}' http://127.0.0.1:8086/increment)" = 503
sha256sum -c "$dest/broken-state.sha256"
test "$(cat "$dest/broken-get.txt")" = '{"error":"state unavailable"}'
systemctl is-active lf-capstone36.service
ss -ltn 'sport = :8086'
journalctl -u lf-capstone36.service -n 8 --no-pager
echo ACTIVE_PROCESS_OPEN_PORT_BUT_GET_AND_POST_503_BROKEN_DATA_UNCHANGED
ROOT
由于 JSON 中的 count 是字符串,GET 和 POST 都应该返回 503。curl -f 在错误响应中失败,因此在本节中,我们省略 -f,并分别保存正文和状态码。破坏后,我们重新比较 SHA-256,以确保失败的写请求未初始化数据。
在实际验证中,服务是活动的,并且端口也处于监听状态,但请求返回了503。Restart=on-failure 是一种在进程失败退出时的策略,因此它不会自动修复运行中进程中的错误数据。这就是为什么我们需要单独检查进程、套接字、HTTP 响应和数据含义的原因。
恢复真实数据路径并验证新写入
在停止服务后,保留损坏的文件作为证据,并仅从已验证的归档中恢复一个数据文件到其原始位置。不要不加区分地覆盖正常程序和服务单元。由于恢复在此处的同一虚拟机上进行,我们可以直接比较先前记录的数字 UID 和 GID。如果迁移到不同的服务器,需要根据目标账户重置它们,如 服务迁移和所有权映射 所示。
sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/lf-capstone36
systemctl stop lf-capstone36.service
cp -a /var/lib/lf-capstone36/state.json "$dest/broken-state.json"
cd "$dest"
sha256sum -c service.sha256
tar --acls --xattrs --numeric-owner --same-owner -xpf service.tar -C / var/lib/lf-capstone36/state.json
sha256sum -c state-before.sha256
test "$(stat -c '%u:%g:%a' /var/lib/lf-capstone36/state.json)" = "$(cat state-mode.txt)"
systemctl start lf-capstone36.service
sleep .3
test "$(curl -fsS http://127.0.0.1:8086/)" = '{"count":2}'
test "$(curl -fsS -X POST http://127.0.0.1:8086/increment)" = '{"count":3}'
systemctl restart lf-capstone36.service
sleep .3
test "$(curl -fsS http://127.0.0.1:8086/)" = '{"count":3}'
test "$(curl -fsS -X POST http://127.0.0.1:8086/increment)" = '{"count":4}'
test "$(curl -fsS http://127.0.0.1:8086/)" = '{"count":4}'
stat -c '%U:%G:%a' /var/lib/lf-capstone36/state.json
echo ACTUAL_RESTORE_COUNT2_NEW_WRITE3_RESTART3_NEW_WRITE4_PASSED
ROOT
存储的状态哈希描述了备份值 2。请在恢复后、下一次 POST 之前立即进行比较。成功递增到 3 和 4 会故意更改文件及其哈希;请记录新的预期值,而不是将之后每个哈希差异都视为损坏。
预期结果是存档和数据哈希为OK,以及lf-capstone36:lf-capstone36:600。先通过GET读取恢复后的值2,再通过POST写入值3;重启进程后通过GET读取3,再次POST得到4。区分文件已被提取的事实与还原后是否可以进行读/写操作的事实。
在进行更改前解释失败检查
| 症状 | 首先检查的要点 |
|---|---|
| 服务启动失败 | 检查可执行文件、用户、在journalctl中的路径错误,以及systemd-analyze verify的结果。 |
| 进程活动,但无端口 | 检查主进程ID、执行参数、绑定地址、重复端口,以及启动后的日志。 |
| GET返回503 | 检查文件是否存在、读取权限、JSON 语法和整数类型,并先保存损坏的文件。 |
| 读取成功,写入 503 | 检查数据目录权限、ReadWritePaths、剩余空间、inode,以及文件替换条件。 |
| 重启后值发生变化 | 检查实际数据路径、挂载、是否保存成功,以及其他写入进程。 |
如果恢复完成,请在工作日志中记录服务状态、端口、响应、数据哈希以及恢复后变化的正常值。如果恢复点之后有正常交易或上传,使用旧备份覆盖当前数据可能会丢失这些较新更改,因此请先决定停止写入、单独保存和重新应用的方法。
清理实训服务并保留其备份
下面的区块仅清理本文中新创建的服务、代码、数据和帐户。在仅限root的目录中保留备份和损坏证据以便比较。删除保留期后的副本时,请选择确切的文件,不要同时删除其他服务的备份。
sudo bash <<'ROOT'
set -euo pipefail
systemctl disable --now lf-capstone36.service
rm -- /etc/systemd/system/lf-capstone36.service /opt/lf-capstone36/app.py /var/lib/lf-capstone36/state.json
rmdir /opt/lf-capstone36 /var/lib/lf-capstone36
systemctl daemon-reload
userdel lf-capstone36
test -z "$(ss -H -ltn 'sport = :8086')"
echo OWN_SAMPLE_REMOVED_VALID_BACKUP_AND_BROKEN_EVIDENCE_RETAINED
ROOT




