Debian 13 강좌 / 서비스 배포·데이터 손상 탐지·백업 복원 실습

Debian 서버 운영을 검증하려면 서비스가 실행되는지뿐 아니라 올바른 데이터를 읽고 쓰는지, 손상된 데이터를 백업에서 복원한 뒤에도 새 쓰기가 유지되는지 확인해야 합니다. 이 종합 실습에서는 전용 계정으로 카운터 서비스를 배포하고 정상 백업, 제한된 데이터 손상, HTTP 오류 탐지와 실제 복원을 차례로 수행합니다.

실습 환경과 성공 조건

Debian 13의 별도 VM과 Python 3.13, systemd 257을 사용합니다. Python 3·curl·tar가 없다면 sudo apt install python3 curl tar로 준비합니다. sudo 권한이 있는 관리 계정으로 실행하며, 같은 경로·계정·포트를 이미 사용하는 서버에는 적용하지 않습니다.

HTTP 서비스는 127.0.0.1:8086에서만 요청을 받습니다. GET /는 현재 값을 읽고, 본문이 없는 POST /increment는 값을 하나 증가시킵니다. 인증·외부 TLS·다중 프로세스 동시 쓰기를 구현한 운영 제품이 아니라 로컬 학습용입니다. Python HTTP 서버 문서의 적용 범위도 확인하세요.

단계 성공 조건
배포·쓰기 전용 계정으로 0 → 1 → 2, 서비스 재시작 후에도 2
정상 백업 정지 상태에서 아카이브·해시 생성, 별도 빈 디렉터리 복원·내용·권한 비교
손상 탐지 프로세스·포트는 유지되지만 GET·POST 모두 503, 손상 파일이 자동 초기화되지 않음
복원 후 운영 실제 백업에서 2 복원 → 새 쓰기 3 → 재시작 후 3 → 새 쓰기 4

아래 명령은 새 실습을 한 번 실행하는 순서입니다. 같은 백업을 덮어쓰지 않도록 검사하며, 중간에 실패하면 그 상태와 로그를 확인한 뒤 실패한 단계의 원인부터 해결합니다. 처음 블록을 다시 실행해 정상값을 강제로 초기화하지 마세요.

전용 계정과 전체 프로그램 배포

프로그램과 서비스 단위는 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

블록 끝까지 오류 없이 실행되면 0 → 1 → 2와 서비스 재시작 후 2 유지를 확인한 것입니다. 전용 계정은 코드 파일을 수정하거나 root 전용 백업 디렉터리를 읽을 수 없으며, 실행 제한 출력에는 ProtectSystem=strict, NoNewPrivileges=yes, 메모리 128 MiB와 작업 수 32가 나타납니다. 이 제한값은 작은 예제용이며 실제 서비스의 측정값에 맞게 정해야 합니다.

프로그램은 JSON 파서로 읽은 값의 구조·정수형·범위를 검사합니다. 잘못된 파일을 만나면 0으로 재설정하지 않고 503을 반환합니다. 0으로 자동 초기화하면 복구할 증거와 기존 값을 잃고 정상 응답으로 오류를 감출 수 있기 때문입니다.

저장할 때는 NamedTemporaryFile로 같은 데이터 디렉터리에 임시 파일을 만들고, flush·fsync 후 os.replace로 이름을 교체합니다. 디렉터리도 동기화하지만 이 실습은 정전이나 가상 디스크 캐시 손실을 시험하지 않았습니다. 원자적인 이름 교체와 모든 저장장치의 전원 장애 내구성을 같은 보장으로 취급하지 마세요.

이 HTTPServer는 요청을 한 프로세스에서 순서대로 처리합니다. 여러 프로세스가 같은 파일을 고치거나 외부 도구가 동시에 쓰는 경우의 동기화는 구현하지 않았습니다. 또한 증가 요청은 반복할 때마다 값이 변하므로 응답을 놓쳤다고 무조건 재전송하면 두 번 증가할 수 있습니다. 실제 업무에서는 트랜잭션·중복 요청 처리를 갖춘 저장 방식을 검토해야 합니다.

systemctl의 enabled 상태와 서비스 재시작은 직접 확인했습니다. 이번 종합 실습에서 VM 재부팅 후 자동 시작을 별도로 시험한 것은 아니므로, 실제 인계 전에는 콘솔과 복구 수단을 확보한 상태에서 부팅 시험도 추가하세요. 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는 아카이브 무결성 검사입니다. 이어 빈 restore-test에 추출한 프로그램·데이터의 바이트와 데이터 파일 UID·GID·권한까지 비교합니다. 이것은 백업 파일이 존재하는 것보다 강한 확인이지만 아직 실제 서비스 경로에서의 장애 복원은 아닙니다. 그 과정은 아래에서 따로 수행합니다.

아카이브에는 이 실습의 프로그램·데이터·단위만 포함합니다. /var/backups가 같은 디스크에 있으므로 디스크 전체 손실에 대비하는 독립 백업은 아닙니다. 실제 운영 데이터는 저장장치와 접근 권한을 분리한 보관 사본도 마련하고 정해진 복원 주기로 확인하세요. tar의 옵션은 GNU tar의 Debian 매뉴얼을 참고할 수 있습니다.

자신의 데이터만 손상시키고 HTTP 오류 탐지

다음 블록은 방금 만든 /var/lib/lf-capstone36/state.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

count가 문자열인 JSON을 넣었으므로 GET와 POST가 모두 503이어야 합니다. curl -f는 오류 응답에서 실패하므로 이 구역에서는 -f를 생략하고 본문·상태 코드를 별도로 저장합니다. 손상 후 SHA-256을 다시 비교해 실패한 쓰기 요청이 데이터를 초기화하지 않았는지도 확인합니다.

실제 검증에서 서비스는 active이고 포트도 LISTEN이었지만 요청은 503이었습니다. Restart=on-failure는 프로세스가 실패 종료했을 때의 정책이므로 살아 있는 프로세스의 잘못된 데이터까지 자동으로 고치지는 않습니다. 프로세스·소켓·HTTP 응답·데이터 의미를 각각 점검해야 하는 이유입니다.

백업에서 실제 데이터 복원 후 새 쓰기 확인

서비스를 멈춘 뒤 손상 파일을 증거로 보관하고, 검증한 아카이브에서 데이터 파일 하나만 원래 위치로 되돌립니다. 정상인 프로그램과 서비스 단위까지 무작정 덮어쓰지 않습니다. 여기서는 같은 VM에서 복원하므로 사전에 기록한 숫자 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

예상 결과는 아카이브·데이터 해시의 OK와 lf-capstone36:lf-capstone36:600입니다. 복원된 값 2를 읽은 뒤 POST로 3을 기록하고, 프로세스를 다시 시작한 뒤에도 3을 읽으며, 한 번 더 써서 4가 되는 것까지 검증합니다. 파일을 추출했다는 사실과 복원 후 읽기·쓰기 운영이 가능하다는 사실을 구분하세요.

실패한 검사를 해석하는 기준

증상 우선 확인할 내용
서비스 시작 실패 journalctl의 실행 파일·사용자·경로 오류와 systemd-analyze verify 결과를 확인합니다.
프로세스 active, 포트 없음 MainPID·실행 인수·바인드 주소·중복 포트와 시작 직후 로그를 확인합니다.
읽기 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